hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rola...@apache.org
Subject svn commit: r503412 - in /jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http: ./ impl/ impl/io/ message/ params/ util/
Date Sun, 04 Feb 2007 14:14:43 GMT
Author: rolandw
Date: Sun Feb  4 06:14:42 2007
New Revision: 503412

URL: http://svn.apache.org/viewvc?view=rev&rev=503412
Log:
JavaDoc @since - nothing in the new packages is older than 4.0

Modified:
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HeaderElement.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpException.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpHost.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/ProtocolException.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/StatusLine.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/HeaderGroup.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedInputStream.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedOutputStream.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ContentLengthInputStream.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeader.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeaderElement.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicStatusLine.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpConnectionParams.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpParams.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/EncodingUtils.java
    jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/ExceptionUtils.java

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HeaderElement.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HeaderElement.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HeaderElement.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HeaderElement.java
Sun Feb  4 06:14:42 2007
@@ -40,7 +40,7 @@
  * <!-- empty lines above to avoid 'svn diff' context problems -->
  * @version $Revision$ $Date$
  * 
- * @since 1.0
+ * @since 4.0
  */
 public interface HeaderElement {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpException.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpException.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpException.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpException.java
Sun Feb  4 06:14:42 2007
@@ -66,8 +66,6 @@
      * @param message the exception detail message
      * @param cause the <tt>Throwable</tt> that caused this exception, or <tt>null</tt>
      * if the cause is unavailable, unknown, or not a <tt>Throwable</tt>
-     * 
-     * @since 3.0
      */
     public HttpException(final String message, final Throwable cause) {
         super(message);

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpHost.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpHost.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpHost.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/HttpHost.java
Sun Feb  4 06:14:42 2007
@@ -35,15 +35,15 @@
 import org.apache.http.util.LangUtils;
 
 /**
- * Holds all of the variables needed to describe an HTTP connection to a host. This includes

- * remote host, port and scheme.
+ * Holds all of the variables needed to describe an HTTP connection to a host.
+ * This includes remote host name, port and scheme.
  * 
  * @author <a href="mailto:becke@u.washington.edu">Michael Becke</a>
  * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * @author Laura Werner
  * 
- * @since 3.0 
+ * @since 4.0
  */
 public class HttpHost {
     /** The default scheme is "http". */

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/ProtocolException.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/ProtocolException.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/ProtocolException.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/ProtocolException.java
Sun Feb  4 06:14:42 2007
@@ -32,12 +32,12 @@
 package org.apache.http;
 
 /**
- * Signals that an HTTP protocol violation has occurred.  For example, HttpClient
- * detected a malformed status line or headers, a missing message body, etc.
+ * Signals that an HTTP protocol violation has occurred.
+ * For example a malformed status line or headers, a missing message body, etc.
  * 
  * @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
  * 
- * @since 3.0
+ * @since 4.0
  */
 public class ProtocolException extends HttpException {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/StatusLine.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/StatusLine.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/StatusLine.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/StatusLine.java
Sun Feb  4 06:14:42 2007
@@ -32,29 +32,17 @@
 package org.apache.http;
 
 /**
- * Represents a Status-Line as returned from a HTTP server.
- *
- * <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a> states
- * the following regarding the Status-Line:
- * <pre>
- * 6.1 Status-Line
- *
- *  The first line of a Response message is the Status-Line, consisting
- *  of the protocol version followed by a numeric status code and its
- *  associated textual phrase, with each element separated by SP
- *  characters. No CR or LF is allowed except in the final CRLF sequence.
- *
- *      Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF
- * </pre>
- * <p>
- * This class is immutable and is inherently thread safe.
+ * Represents a status line as returned from a HTTP server.
+ * See <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>,
+ * section 6.1.
+ * Implementations are expected to be thread safe.
  *
  * @see HttpStatus
  * @author <a href="mailto:jsdever@apache.org">Jeff Dever</a>
  * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
  * @version $Id$
  * 
- * @since 2.0
+ * @since 4.0
  */
 public interface StatusLine {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/HeaderGroup.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/HeaderGroup.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/HeaderGroup.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/HeaderGroup.java
Sun Feb  4 06:14:42 2007
@@ -40,13 +40,13 @@
 import org.apache.http.util.CharArrayBuffer;
 
 /**
- * A class for combining a set of headers.  This class allows for multiple
- * headers with the same name and keeps track of the order in which headers were
- * added.
+ * A class for combining a set of headers.
+ * This class allows for multiple headers with the same name and
+ * keeps track of the order in which headers were added.
  * 
  * @author Michael Becke
- * 
- * @since 2.0beta1
+ *
+ * @since 4.0
  */
 public class HeaderGroup {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedInputStream.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedInputStream.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedInputStream.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedInputStream.java
Sun Feb  4 06:14:42 2007
@@ -44,73 +44,18 @@
 import org.apache.http.util.HeaderUtils;
 
 /**
- * <p>This class implements chunked transfer coding as described in the 
- * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6">Section 3.6.1</a>

- * of <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616</a>.

- * It transparently coalesces chunks of a HTTP stream that uses chunked transfer coding.</p>
- * 
- * <h>3.6.1 Chunked Transfer Coding</h>
- * <p>
- * The chunked encoding modifies the body of a message in order to transfer it as a series

- * of chunks, each with its own size indicator, followed by an OPTIONAL trailer containing

- * entity-header fields. This allows dynamically produced content to be transferred along

- * with the information necessary for the recipient to verify that it has received the full

- * message.
- * </p>
- * <pre>
- *  Chunked-Body   = *chunk
- *                   last-chunk
- *                   trailer
- *                   CRLF
- *
- *  chunk          = chunk-size [ chunk-extension ] CRLF
- *                   chunk-data CRLF
- *  chunk-size     = 1*HEX
- *  last-chunk     = 1*("0") [ chunk-extension ] CRLF
- *
- *  chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] )
- *  chunk-ext-name = token
- *  chunk-ext-val  = token | quoted-string
- *  chunk-data     = chunk-size(OCTET)
- *  trailer        = *(entity-header CRLF)
- * </pre>
- * <p>
- * The chunk-size field is a string of hex digits indicating the size of the chunk. The 
- * chunked encoding is ended by any chunk whose size is zero, followed by the trailer, 
- * which is terminated by an empty line.
- * </p>
- * <p>
- * The trailer allows the sender to include additional HTTP header fields at the end 
- * of the message. The Trailer header field can be used to indicate which header fields 
- * are included in a trailer (see section 14.40).
- * </p>
- * <p>
- * A server using chunked transfer-coding in a response MUST NOT use the trailer for any

- * header fields unless at least one of the following is true:
- * </p>
- * <p>
- * a)the request included a TE header field that indicates "trailers" is acceptable in 
- * the transfer-coding of the response, as described in section 14.39; or,
- * </p>
- * <p>
- * b)the server is the origin server for the response, the trailer fields consist entirely

- * of optional metadata, and the recipient could use the message (in a manner acceptable

- * to the origin server) without receiving this metadata. In other words, the origin server

- * is willing to accept the possibility that the trailer fields might be silently discarded

- * along the path to the client.
- * </p>
- * <p>
- * This requirement prevents an interoperability failure when the message is being received

- * by an HTTP/1.1 (or later) proxy and forwarded to an HTTP/1.0 recipient. It avoids a 
- * situation where compliance with the protocol would have necessitated a possibly infinite

- * buffer on the proxy. 
- * </p>
+ * Implements chunked transfer coding.
+ * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616</a>,
+ * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6">section 3.6.1</a>.
+ * It transparently coalesces chunks of a HTTP stream that uses chunked
+ * transfer coding. After the stream is read to the end, it provides access
+ * to the trailers, if any.
  * <p>
  * Note that this class NEVER closes the underlying stream, even when close
- * gets called.  Instead, it will read until the "end" of its chunking on close,
- * which allows for the seamless invocation of subsequent HTTP 1.1 calls, while
- * not requiring the client to remember to read the entire contents of the
- * response.
+ * gets called.  Instead, it will read until the "end" of its chunking on
+ * close, which allows for the seamless execution of subsequent HTTP 1.1
+ * requests, while not requiring the client to remember to read the entire
+ * contents of the response.
  * </p>
  *
  * @author Ortwin Glueck
@@ -121,7 +66,7 @@
  * @author Michael Becke
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
- * @since 2.0
+ * @since 4.0
  *
  */
 public class ChunkedInputStream extends InputStream {

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedOutputStream.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedOutputStream.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedOutputStream.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ChunkedOutputStream.java
Sun Feb  4 06:14:42 2007
@@ -37,71 +37,17 @@
 import org.apache.http.io.HttpDataTransmitter;
 
 /**
- * <p>This class implements chunked transfer coding as described in the 
- * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6">Section 3.6.1</a>

- * of <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616</a>.

- * Writes are buffered to an internal buffer (2048 default size). Chunks are guaranteed 
- * to be at least as large as the buffer size (except for the last chunk).</p>
+ * Implements chunked transfer coding.
+ * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616</a>,
+ * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6">section 3.6.1</a>.
+ * Writes are buffered to an internal buffer (2048 default size).
+ * Chunks are guaranteed to be at least as large as the buffer size
+ * (except for the last chunk).
  * 
- * <h>3.6.1 Chunked Transfer Coding</h>
- * <p>
- * The chunked encoding modifies the body of a message in order to transfer it as a series

- * of chunks, each with its own size indicator, followed by an OPTIONAL trailer containing

- * entity-header fields. This allows dynamically produced content to be transferred along

- * with the information necessary for the recipient to verify that it has received the full

- * message.
- * </p>
- * <pre>
- *  Chunked-Body   = *chunk
- *                   last-chunk
- *                   trailer
- *                   CRLF
- *
- *  chunk          = chunk-size [ chunk-extension ] CRLF
- *                   chunk-data CRLF
- *  chunk-size     = 1*HEX
- *  last-chunk     = 1*("0") [ chunk-extension ] CRLF
- *
- *  chunk-extension= *( ";" chunk-ext-name [ "=" chunk-ext-val ] )
- *  chunk-ext-name = token
- *  chunk-ext-val  = token | quoted-string
- *  chunk-data     = chunk-size(OCTET)
- *  trailer        = *(entity-header CRLF)
- * </pre>
- * <p>
- * The chunk-size field is a string of hex digits indicating the size of the chunk. The 
- * chunked encoding is ended by any chunk whose size is zero, followed by the trailer, 
- * which is terminated by an empty line.
- * </p>
- * <p>
- * The trailer allows the sender to include additional HTTP header fields at the end 
- * of the message. The Trailer header field can be used to indicate which header fields 
- * are included in a trailer (see section 14.40).
- * </p>
- * <p>
- * A server using chunked transfer-coding in a response MUST NOT use the trailer for any

- * header fields unless at least one of the following is true:
- * </p>
- * <p>
- * a)the request included a TE header field that indicates "trailers" is acceptable in 
- * the transfer-coding of the response, as described in section 14.39; or,
- * </p>
- * <p>
- * b)the server is the origin server for the response, the trailer fields consist entirely

- * of optional metadata, and the recipient could use the message (in a manner acceptable

- * to the origin server) without receiving this metadata. In other words, the origin server

- * is willing to accept the possibility that the trailer fields might be silently discarded

- * along the path to the client.
- * </p>
- * <p>
- * This requirement prevents an interoperability failure when the message is being received

- * by an HTTP/1.1 (or later) proxy and forwarded to an HTTP/1.0 recipient. It avoids a 
- * situation where compliance with the protocol would have necessitated a possibly infinite

- * buffer on the proxy. 
- * </p>
- * 
- * @author Mohammad Rezaei, Goldman, Sachs & Co.
+ * @author Mohammad Rezaei (Goldman, Sachs &amp; Co.)
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
+ * 
+ * @since 4.0
  */
 public class ChunkedOutputStream extends OutputStream {
 
@@ -123,8 +69,6 @@
      * @param out the transmitter to wrap
      * @param bufferSize minimum chunk size (excluding last chunk)
      * @throws IOException
-     * 
-     * @since 3.0
      */
     public ChunkedOutputStream(final HttpDataTransmitter out, int bufferSize)
             throws IOException {
@@ -148,8 +92,6 @@
     /**
      * Writes the cache out onto the underlying stream
      * @throws IOException
-     * 
-     * @since 3.0
      */
     protected void flushCache() throws IOException {
         if (this.cachePosition > 0) {
@@ -167,8 +109,6 @@
      * @param off
      * @param len
      * @throws IOException
-     * 
-     * @since 3.0
      */
     protected void flushCacheWithAppend(byte bufferToAppend[], int off, int len) throws IOException
{
         this.out.writeLine(Integer.toHexString(this.cachePosition + len));
@@ -188,8 +128,6 @@
     /**
      * Must be called to ensure the internal cache is flushed and the closing chunk is written.
      * @throws IOException
-     * 
-     * @since 3.0
      */
     public void finish() throws IOException {
         if (!this.wroteLastChunk) {
@@ -214,8 +152,6 @@
      * not split, but rather written out as one large chunk.
      * @param b
      * @throws IOException
-     * 
-     * @since 3.0
      */
     public void write(byte b[]) throws IOException {
         write(b, 0, b.length);

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ContentLengthInputStream.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ContentLengthInputStream.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ContentLengthInputStream.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/impl/io/ContentLengthInputStream.java
Sun Feb  4 06:14:42 2007
@@ -37,16 +37,13 @@
 import org.apache.http.io.HttpDataReceiver;
 
 /**
- * <p>
- * This class cuts the wrapped InputStream off after a specified number of bytes.
- * </p>
- * <p>
+ * Stream that cuts off after a specified number of bytes.
  * Note that this class NEVER closes the underlying stream, even when close
- * gets called.  Instead, it will read until the "end" of its chunking on close,
- * which allows for the seamless invocation of subsequent HTTP 1.1 calls, while
- * not requiring the client to remember to read the entire contents of the
- * response.
- * </p>
+ * gets called.  Instead, it will read until the "end" of its chunking on
+ * close, which allows for the seamless execution of subsequent HTTP 1.1
+ * requests, while not requiring the client to remember to read the entire
+ * contents of the response.
+ *
  * <p>Implementation note: Choices abound. One approach would pass
  * through the {@link InputStream#mark} and {@link InputStream#reset} calls to
  * the underlying stream.  That's tricky, though, because you then have to
@@ -55,7 +52,8 @@
  * for the readLimit leave room for differing implementations, you might get
  * into a lot of trouble.</p>
  *
- * <p>Alternatively, you could make this class extend {@link java.io.BufferedInputStream}
+ * <p>Alternatively, you could make this class extend
+ * {@link java.io.BufferedInputStream}
  * and then use the protected members of that class to avoid duplicated effort.
  * That solution has the side effect of adding yet another possible layer of
  * buffering.</p>
@@ -67,7 +65,8 @@
  * @author Ortwin Glueck
  * @author Eric Johnson
  * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
- * @since 2.0
+ *
+ * @since 4.0
  */
 public class ContentLengthInputStream extends InputStream {
     
@@ -95,8 +94,6 @@
      * @param in The stream to wrap
      * @param contentLength The maximum number of bytes that can be read from
      * the stream. Subsequent read operations will return -1.
-     * 
-     * @since 3.0
      */
     public ContentLengthInputStream(final HttpDataReceiver in, long contentLength) {
         super();

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeader.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeader.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeader.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeader.java
Sun Feb  4 06:14:42 2007
@@ -60,6 +60,8 @@
  *
  * <!-- empty lines above to avoid 'svn diff' context problems -->
  * @version $Revision$ $Date$
+ * 
+ * @since 4.0
  */
 public class BasicHeader implements Header {
 
@@ -127,8 +129,6 @@
      * @see BasicHeaderElement#parseAll
      * 
      * @return an array of header elements
-     * 
-     * @since 3.0
      */
     public HeaderElement[] getElements() {
         if (this.value != null) {

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeaderElement.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeaderElement.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeaderElement.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicHeaderElement.java
Sun Feb  4 06:14:42 2007
@@ -85,7 +85,7 @@
  * <!-- empty lines above to avoid 'svn diff' context problems -->
  * @version $Revision$ $Date$
  * 
- * @since 1.0
+ * @since 4.0
  */
 public class BasicHeaderElement implements HeaderElement {
 
@@ -168,7 +168,6 @@
     /**
      * Get parameters, if any.
      *
-     * @since 2.0
      * @return parameters as an array of {@link NameValuePair}s
      */
     public NameValuePair[] getParameters() {
@@ -186,8 +185,6 @@
      * @param indexTo   where to stop parsing in the buffer
      *
      * @return array of {@link HeaderElement}s.
-     * 
-     * @since 3.0
      */
     public static final HeaderElement[] parseAll(
             final CharArrayBuffer buffer, final int indexFrom, final int indexTo) {
@@ -241,8 +238,6 @@
      * @param s  the string representation of the header value
      *                     (as received from the web server).
      * @return array of {@link HeaderElement}s.
-     * 
-     * @since 3.0
      */
     public static final HeaderElement[] parseAll(final String s) {
         if (s == null) {

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicStatusLine.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicStatusLine.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicStatusLine.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicStatusLine.java
Sun Feb  4 06:14:42 2007
@@ -41,29 +41,17 @@
 
 
 /**
- * Represents a Status-Line as returned from a HTTP server.
- *
- * <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a> states
- * the following regarding the Status-Line:
- * <pre>
- * 6.1 Status-Line
- *
- *  The first line of a Response message is the Status-Line, consisting
- *  of the protocol version followed by a numeric status code and its
- *  associated textual phrase, with each element separated by SP
- *  characters. No CR or LF is allowed except in the final CRLF sequence.
- *
- *      Status-Line = HTTP-Version SP Status-Code SP Reason-Phrase CRLF
- * </pre>
- * <p>
- * This class is immutable and is inherently thread safe.
+ * Represents a status line as returned from a HTTP server.
+ * See <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a> section 6.1.
+ * This class is immutable and therefore inherently thread safe.
  *
  * @see HttpStatus
  * @author <a href="mailto:jsdever@apache.org">Jeff Dever</a>
  * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
+ *
  * @version $Id$
  * 
- * @since 2.0
+ * @since 4.0
  */
 public class BasicStatusLine implements StatusLine {
 
@@ -112,8 +100,6 @@
      * @param indexTo   where to stop parsing in the buffer
      * 
      * @throws HttpException if the status line is invalid
-     * 
-     * @since 4.0 
      */
     public static StatusLine parse(
             final CharArrayBuffer buffer, final int indexFrom, final int indexTo) 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpConnectionParams.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpConnectionParams.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpConnectionParams.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpConnectionParams.java
Sun Feb  4 06:14:42 2007
@@ -32,14 +32,13 @@
 package org.apache.http.params;
 
 /**
- * This class implements an adaptor around the {@link HttpParams} interface
- * to simplify manipulation of the HTTP connection specific parameters.
+ * An adaptor for accessing connection parameters in {@link HttpParams}.
  * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
  * @version $Revision$
  * 
- * @since 3.0
+ * @since 4.0
  */
 public final class HttpConnectionParams {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpParams.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpParams.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpParams.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/params/HttpParams.java
Sun Feb  4 06:14:42 2007
@@ -32,16 +32,17 @@
 package org.apache.http.params;
 
 /**
- * This interface represents a collection of HTTP protocol parameters. Protocol parameters
- * may be linked together to form a hierarchy. If a particular parameter value has not been
- * explicitly defined in the collection itself, its value will be drawn from the parent 
+ * Represents a collection of HTTP protocol and framework parameters.
+ * Parameters may be linked together to form a hierarchy.
+ * If a particular parameter value has not been explicitly defined
+ * in the collection itself, its value will be drawn from the parent 
  * collection of parameters.
  *   
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
  * @version $Revision$
  *
- * @since 3.0
+ * @since 4.0
  */
 public interface HttpParams {
 

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/EncodingUtils.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/EncodingUtils.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/EncodingUtils.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/EncodingUtils.java
Sun Feb  4 06:14:42 2007
@@ -40,7 +40,7 @@
  * @author Michael Becke
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
- * @since 2.0 final
+ * @since 4.0
  */
 public class EncodingUtils {
 
@@ -54,8 +54,6 @@
      * @param length the number of bytes to encode 
      * @param charset the desired character encoding
      * @return The result of the conversion.
-     * 
-     * @since 3.0
      */
     public static String getString(
         final byte[] data, 
@@ -88,8 +86,6 @@
      * @param data the byte array to be encoded
      * @param charset the desired character encoding
      * @return The result of the conversion.
-     * 
-     * @since 3.0
      */
     public static String getString(final byte[] data, final String charset) {
         if (data == null) {
@@ -105,8 +101,6 @@
      * @param data the string to be encoded
      * @param charset the desired character encoding
      * @return The resulting byte array.
-     * 
-     * @since 3.0
      */
     public static byte[] getBytes(final String data, final String charset) {
 
@@ -130,8 +124,6 @@
      *
      * @param data the string to be encoded
      * @return The string as a byte array.
-     * 
-     * @since 3.0
      */
     public static byte[] getAsciiBytes(final String data) {
 
@@ -155,8 +147,6 @@
      * @param offset the index of the first byte to encode
      * @param length the number of bytes to encode 
      * @return The string representation of the byte array
-     * 
-     * @since 3.0
      */
     public static String getAsciiString(final byte[] data, int offset, int length) {
 
@@ -178,8 +168,6 @@
      *
      * @param data the byte array to be encoded
      * @return The string representation of the byte array
-     * 
-     * @since 3.0
      */
     public static String getAsciiString(final byte[] data) {
         if (data == null) {

Modified: jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/ExceptionUtils.java
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/ExceptionUtils.java?view=diff&rev=503412&r1=503411&r2=503412
==============================================================================
--- jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/ExceptionUtils.java
(original)
+++ jakarta/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/util/ExceptionUtils.java
Sun Feb  4 06:14:42 2007
@@ -38,7 +38,7 @@
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
  * 
- * @since 3.0
+ * @since 4.0
  */
 public class ExceptionUtils {
 



Mime
View raw message