You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by mb...@apache.org on 2004/05/13 06:03:26 UTC
cvs commit: jakarta-commons/httpclient/src/java/org/apache/commons/httpclient HttpException.java HttpConnectionManager.java HttpMethodBase.java HttpClientError.java HttpMethodDirector.java Header.java ConnectMethod.java HttpMethod.java SimpleHttpConnectionManager.java HttpParser.java ChunkedOutputStream.java HttpRecoverableException.java MultiThreadedHttpConnectionManager.java HeaderGroup.java ProtocolException.java HostConfiguration.java HttpClient.java HttpTimeoutException.java HttpVersion.java HttpState.java HttpConnection.java ConnectTimeoutException.java ContentLengthInputStream.java URI.java IOTimeoutException.java HeaderElement.java
mbecke 2004/05/12 21:03:26
Modified: httpclient/src/java/org/apache/commons/httpclient
HttpException.java HttpConnectionManager.java
HttpMethodBase.java HttpClientError.java
HttpMethodDirector.java Header.java
ConnectMethod.java HttpMethod.java
SimpleHttpConnectionManager.java HttpParser.java
ChunkedOutputStream.java
HttpRecoverableException.java
MultiThreadedHttpConnectionManager.java
HeaderGroup.java ProtocolException.java
HostConfiguration.java HttpClient.java
HttpTimeoutException.java HttpVersion.java
HttpState.java HttpConnection.java
ConnectTimeoutException.java
ContentLengthInputStream.java URI.java
IOTimeoutException.java HeaderElement.java
Log:
Added @since 3.0 tags.
Revision Changes Path
1.18 +14 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpException.java
Index: HttpException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpException.java,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- HttpException.java 18 Apr 2004 23:51:35 -0000 1.17
+++ HttpException.java 13 May 2004 04:03:24 -0000 1.18
@@ -67,6 +67,8 @@
* @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(String message, Throwable cause) {
super(message);
@@ -88,6 +90,8 @@
*
* @return 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 Throwable getCause() {
return cause;
@@ -95,6 +99,8 @@
/**
* Print this HttpException and its stack trace to the standard error stream.
+ *
+ * @since 3.0
*/
public void printStackTrace() {
printStackTrace(System.err);
@@ -105,6 +111,8 @@
*
* @param s the <tt>PrintStream</tt> to which the exception and its stack trace
* should be written
+ *
+ * @since 3.0
*/
public void printStackTrace(PrintStream s) {
try {
@@ -132,6 +140,8 @@
*
* @param s the <tt>PrintWriter</tt> to which the exception and its stack trace
* should be written
+ *
+ * @since 3.0
*/
public void printStackTrace(PrintWriter s) {
try {
1.22 +5 -3 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpConnectionManager.java
Index: HttpConnectionManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpConnectionManager.java,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- HttpConnectionManager.java 13 May 2004 02:40:36 -0000 1.21
+++ HttpConnectionManager.java 13 May 2004 04:03:24 -0000 1.22
@@ -105,6 +105,8 @@
* timeout expires
*
* @see HttpConnection#setHttpConnectionManager(HttpConnectionManager)
+ *
+ * @since 3.0
*/
HttpConnection getConnectionWithTimeout(HostConfiguration hostConfiguration, long timeout)
throws ConnectTimeoutException;
1.207 +14 -7 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodBase.java
Index: HttpMethodBase.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodBase.java,v
retrieving revision 1.206
retrieving revision 1.207
diff -u -r1.206 -r1.207
--- HttpMethodBase.java 11 May 2004 20:43:54 -0000 1.206
+++ HttpMethodBase.java 13 May 2004 04:03:24 -0000 1.207
@@ -262,6 +262,8 @@
* @param uri URI to be set
*
* @throws URIException if a URI cannot be set
+ *
+ * @since 3.0
*/
public void setURI(URI uri) throws URIException {
// only set the host if specified by the URI
@@ -488,6 +490,8 @@
* @param headerName The name of the header to be returned.
*
* @return The specified request header.
+ *
+ * @since 3.0
*/
public Header getRequestHeader(String headerName) {
if (headerName == null) {
@@ -549,6 +553,8 @@
/**
* @see org.apache.commons.httpclient.HttpMethod#getResponseHeaders(java.lang.String)
+ *
+ * @since 3.0
*/
public Header[] getResponseHeaders(String headerName) {
return getResponseHeaderGroup().getHeaders(headerName);
@@ -977,8 +983,9 @@
/**
* Aborts the execution of this method.
+ *
+ * @since 3.0
*/
-
public void abort() {
if (this.aborted) {
return;
@@ -2029,7 +2036,7 @@
*
* @return HTTP parameters.
*
- * @since 2.1
+ * @since 3.0
*/
public HttpMethodParams getParams() {
return this.params;
@@ -2038,7 +2045,7 @@
/**
* Assigns {@link HttpMethodParams HTTP protocol parameters} for this method.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpMethodParams
*/
1.4 +6 -6 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpClientError.java
Index: HttpClientError.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpClientError.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- HttpClientError.java 18 Apr 2004 23:51:34 -0000 1.3
+++ HttpClientError.java 13 May 2004 04:03:25 -0000 1.4
@@ -32,9 +32,9 @@
/**
* Signals that an error has occurred.
*
- * @author Ortwin Gl�ck
+ * @author Ortwin Gl?ck
* @version $Revision$ $Date$
- * @since 2.1
+ * @since 3.0
*/
public class HttpClientError extends Error {
1.25 +5 -3 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodDirector.java
Index: HttpMethodDirector.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethodDirector.java,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- HttpMethodDirector.java 8 May 2004 10:26:44 -0000 1.24
+++ HttpMethodDirector.java 13 May 2004 04:03:25 -0000 1.25
@@ -53,6 +53,8 @@
/**
* Handles the process of executing a method including authentication, redirection and retries.
+ *
+ * @since 3.0
*/
class HttpMethodDirector {
1.16 +12 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/Header.java
Index: Header.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/Header.java,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- Header.java 18 Apr 2004 23:51:34 -0000 1.15
+++ Header.java 13 May 2004 04:03:25 -0000 1.16
@@ -70,6 +70,8 @@
* @param value the header value
* @param isAutogenerated <tt>true</tt> if the header is autogenerated,
* <tt>false</tt> otherwise.
+ *
+ * @since 3.0
*/
public Header(String name, String value, boolean isAutogenerated) {
super(name, value);
@@ -120,6 +122,8 @@
* @see HeaderElement#parseElements(String)
*
* @return an array of header elements
+ *
+ * @since 3.0
*/
public HeaderElement[] getElements() {
return HeaderElement.parseElements(getValue());
@@ -130,6 +134,8 @@
*
* @return <tt>true</tt> if the header is autogenerated,
* <tt>false</tt> otherwise.
+ *
+ * @since 3.0
*/
public boolean isAutogenerated()
{
@@ -141,6 +147,8 @@
*
* @return b <tt>true</tt> if the header is autogenerated,
* <tt>false</tt> otherwise.
+ *
+ * @since 3.0
*/
public void setAutogenerated(boolean b)
{
1.28 +7 -5 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ConnectMethod.java
Index: ConnectMethod.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ConnectMethod.java,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- ConnectMethod.java 18 Apr 2004 23:51:34 -0000 1.27
+++ ConnectMethod.java 13 May 2004 04:03:25 -0000 1.28
@@ -37,7 +37,7 @@
/**
* Establishes a tunneled HTTP connection via the CONNECT method.
*
- * @author Ortwin Gl�ck
+ * @author Ortwin Gl???ck
* @author dIon Gillard
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
* @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a>
@@ -51,6 +51,8 @@
/**
* Create a connect method.
+ *
+ * @since 3.0
*/
public ConnectMethod() {
LOG.trace("enter ConnectMethod()");
1.38 +20 -6 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethod.java
Index: HttpMethod.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpMethod.java,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- HttpMethod.java 11 May 2004 20:43:54 -0000 1.37
+++ HttpMethod.java 13 May 2004 04:03:25 -0000 1.38
@@ -108,6 +108,8 @@
* @param uri URI to be set
*
* @throws URIException if a URI cannot be set
+ *
+ * @since 3.0
*/
void setURI(URI uri) throws URIException;
@@ -212,6 +214,8 @@
* Removes the given request header.
*
* @param header the header
+ *
+ * @since 3.0
*/
void removeRequestHeader(Header header);
@@ -288,6 +292,8 @@
* case insensitive.
* @param headerName the name of the headers to be returned.
* @return an array of zero or more headers
+ *
+ * @since 3.0
*/
Header[] getRequestHeaders(String headerName);
@@ -342,6 +348,8 @@
* case insensitive.
* @param headerName the name of the headers to be returned.
* @return an array of zero or more headers
+ *
+ * @since 3.0
*/
Header[] getResponseHeaders(String headerName);
@@ -438,6 +446,8 @@
* Aborts the execution of the HTTP method.
*
* @see #execute(HttpState, HttpConnection)
+ *
+ * @since 3.0
*/
void abort();
@@ -515,7 +525,7 @@
/**
* Returns {@link HttpMethodParams HTTP protocol parameters} associated with this method.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpMethodParams
*/
@@ -524,7 +534,7 @@
/**
* Assigns {@link HttpMethodParams HTTP protocol parameters} for this method.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpMethodParams
*/
@@ -534,6 +544,8 @@
* Returns the {@link MethodRetryHandler retry handler} for this HTTP method
*
* @return the methodRetryHandler
+ *
+ * @since 3.0
*/
public MethodRetryHandler getMethodRetryHandler();
@@ -541,6 +553,8 @@
* Sets the {@link MethodRetryHandler retry handler} for this HTTP method
*
* @param handler the methodRetryHandler to use when this method executed
+ *
+ * @since 3.0
*/
public void setMethodRetryHandler(MethodRetryHandler handler);
1.21 +5 -3 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/SimpleHttpConnectionManager.java
Index: SimpleHttpConnectionManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/SimpleHttpConnectionManager.java,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- SimpleHttpConnectionManager.java 13 May 2004 02:40:36 -0000 1.20
+++ SimpleHttpConnectionManager.java 13 May 2004 04:03:25 -0000 1.21
@@ -122,6 +122,8 @@
/**
* @see HttpConnectionManager#getConnectionWithTimeout(HostConfiguration, long)
+ *
+ * @since 3.0
*/
public HttpConnection getConnectionWithTimeout(
HostConfiguration hostConfiguration, long timeout) {
1.12 +7 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpParser.java
Index: HttpParser.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpParser.java,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- HttpParser.java 18 Apr 2004 23:51:35 -0000 1.11
+++ HttpParser.java 13 May 2004 04:03:25 -0000 1.12
@@ -96,8 +96,9 @@
*
* @throws IOException if an I/O problem occurs
* @return a line from the stream
+ *
+ * @since 3.0
*/
-
public static String readLine(InputStream inputStream, String charset) throws IOException {
LOG.trace("enter HttpParser.readLine(InputStream, String)");
byte[] rawdata = readRawLine(inputStream);
@@ -149,6 +150,8 @@
*
* @throws IOException if an IO error occurs while reading from the stream
* @throws HttpException if there is an error parsing a header value
+ *
+ * @since 3.0
*/
public static Header[] parseHeaders(InputStream is, String charset) throws IOException, HttpException {
LOG.trace("enter HeaderParser.parseHeaders(InputStream, String)");
1.16 +13 -3 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ChunkedOutputStream.java
Index: ChunkedOutputStream.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ChunkedOutputStream.java,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- ChunkedOutputStream.java 18 Apr 2004 23:51:34 -0000 1.15
+++ ChunkedOutputStream.java 13 May 2004 04:03:25 -0000 1.16
@@ -66,6 +66,8 @@
* @param stream to wrap
* @param bufferSize minimum chunk size (excluding last chunk)
* @throws IOException
+ *
+ * @since 3.0
*/
public ChunkedOutputStream(OutputStream stream, int bufferSize) throws IOException {
this.cache = new byte[bufferSize];
@@ -86,6 +88,8 @@
/**
* Writes the cache out onto the underlying stream
* @throws IOException
+ *
+ * @since 3.0
*/
protected void flushCache() throws IOException {
if (cachePosition > 0) {
@@ -105,6 +109,8 @@
* @param off
* @param len
* @throws IOException
+ *
+ * @since 3.0
*/
protected void flushCacheWithAppend(byte bufferToAppend[], int off, int len) throws IOException {
byte chunkHeader[] = EncodingUtil.getAsciiBytes(
@@ -128,6 +134,8 @@
/**
* 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 (!wroteLastChunk) {
@@ -149,6 +157,8 @@
* not split, but rather written out as one large chunk.
* @param b
* @throws IOException
+ *
+ * @since 3.0
*/
public void write(byte b[]) throws IOException {
this.write(b, 0, b.length);
1.14 +6 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpRecoverableException.java
Index: HttpRecoverableException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpRecoverableException.java,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- HttpRecoverableException.java 18 Apr 2004 23:51:35 -0000 1.13
+++ HttpRecoverableException.java 13 May 2004 04:03:25 -0000 1.14
@@ -67,6 +67,8 @@
* @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 HttpRecoverableException(String message, Throwable cause) {
super(message);
1.39 +7 -5 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/MultiThreadedHttpConnectionManager.java
Index: MultiThreadedHttpConnectionManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/MultiThreadedHttpConnectionManager.java,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- MultiThreadedHttpConnectionManager.java 13 May 2004 02:40:36 -0000 1.38
+++ MultiThreadedHttpConnectionManager.java 13 May 2004 04:03:25 -0000 1.39
@@ -370,6 +370,8 @@
/**
* @see HttpConnectionManager#getConnectionWithTimeout(HostConfiguration, long)
+ *
+ * @since 3.0
*/
public HttpConnection getConnectionWithTimeout(HostConfiguration hostConfiguration,
long timeout) throws ConnectTimeoutException {
@@ -608,7 +610,7 @@
* Returns {@link HttpConnectionManagerParams parameters} associated
* with this connection manager.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpConnectionManagerParams
*/
@@ -620,7 +622,7 @@
* Assigns {@link HttpConnectionManagerParams parameters} for this
* connection manager.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpConnectionManagerParams
*/
1.8 +5 -3 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HeaderGroup.java
Index: HeaderGroup.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HeaderGroup.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- HeaderGroup.java 18 Apr 2004 23:51:34 -0000 1.7
+++ HeaderGroup.java 13 May 2004 04:03:25 -0000 1.8
@@ -220,6 +220,8 @@
* Returns an iterator over this group of headers.
*
* @return iterator over this group of headers.
+ *
+ * @since 3.0
*/
public Iterator getIterator() {
return this.headers.iterator();
1.4 +4 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ProtocolException.java
Index: ProtocolException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ProtocolException.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ProtocolException.java 18 Apr 2004 23:51:35 -0000 1.3
+++ ProtocolException.java 13 May 2004 04:03:25 -0000 1.4
@@ -35,7 +35,7 @@
*
* @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
*
- * @since 2.1
+ * @since 3.0
*/
public class ProtocolException extends HttpException {
1.17 +5 -5 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HostConfiguration.java
Index: HostConfiguration.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HostConfiguration.java,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- HostConfiguration.java 8 May 2004 10:12:07 -0000 1.16
+++ HostConfiguration.java 13 May 2004 04:03:25 -0000 1.17
@@ -464,7 +464,7 @@
*
* @return HTTP parameters.
*
- * @since 2.1
+ * @since 3.0
*/
public HostParams getParams() {
return this.params;
@@ -473,7 +473,7 @@
/**
* Assigns {@link HostParams HTTP protocol parameters} specific to this host.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpMethodParams
*/
1.95 +9 -9 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpClient.java
Index: HttpClient.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpClient.java,v
retrieving revision 1.94
retrieving revision 1.95
diff -u -r1.94 -r1.95
--- HttpClient.java 18 Apr 2004 23:51:34 -0000 1.94
+++ HttpClient.java 13 May 2004 04:03:25 -0000 1.95
@@ -47,7 +47,7 @@
* @author <a href="mailto:rwaldhoff@apache.org">Rodney Waldhoff</a>
* @author Sean C. Sullivan
* @author <a href="mailto:dion@apache.org">dIon Gillard</a>
- * @author Ortwin Gl�ck
+ * @author Ortwin Gl?ck
* @author <a href="mailto:becke@u.washington.edu">Michael Becke</a>
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
* @author Sam Maloney
@@ -104,7 +104,7 @@
*
* @see HttpClientParams
*
- * @since 2.1
+ * @since 3.0
*/
public HttpClient(HttpClientParams params) {
super();
@@ -140,7 +140,7 @@
* @param httpConnectionManager The {@link HttpConnectionManager connection manager}
* to use.
*
- * @since 2.1
+ * @since 3.0
*/
public HttpClient(HttpClientParams params, HttpConnectionManager httpConnectionManager) {
super();
@@ -517,7 +517,7 @@
/**
* Returns {@link HttpClientParams HTTP protocol parameters} associated with this HttpClient.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpClientParams
*/
@@ -528,7 +528,7 @@
/**
* Assigns {@link HttpClientParams HTTP protocol parameters} for this HttpClient.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpClientParams
*/
1.5 +4 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpTimeoutException.java
Index: HttpTimeoutException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpTimeoutException.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- HttpTimeoutException.java 18 Apr 2004 23:51:35 -0000 1.4
+++ HttpTimeoutException.java 13 May 2004 04:03:25 -0000 1.5
@@ -36,7 +36,7 @@
*
* @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
*
- * @since 2.1
+ * @since 3.0
*/
public class HttpTimeoutException extends HttpRecoverableException {
1.5 +6 -5 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpVersion.java
Index: HttpVersion.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpVersion.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- HttpVersion.java 8 May 2004 10:12:07 -0000 1.4
+++ HttpVersion.java 13 May 2004 04:03:25 -0000 1.5
@@ -64,7 +64,8 @@
* @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a>
*
* @version $Revision$ $Date$
-*
+ *
+ * @since 3.0
*/
public class HttpVersion implements Comparable {
1.33 +12 -5 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpState.java
Index: HttpState.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpState.java,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- HttpState.java 18 Apr 2004 23:51:35 -0000 1.32
+++ HttpState.java 13 May 2004 04:03:25 -0000 1.33
@@ -339,6 +339,8 @@
*
* @see #getCredentials(HttpAuthRealm)
* @see #setProxyCredentials(HttpAuthRealm, Credentials)
+ *
+ * @since 3.0
*/
public synchronized void setCredentials(final HttpAuthRealm realm, Credentials credentials) {
if (realm == null) {
@@ -409,8 +411,9 @@
* @return the credentials
*
* @see #setCredentials(HttpAuthRealm, Credentials)
+ *
+ * @since 3.0
*/
-
public synchronized Credentials getCredentials(HttpAuthRealm realm) {
if (realm == null) {
throw new IllegalArgumentException("Authentication realm token may not be null");
@@ -456,6 +459,8 @@
*
* @see #getProxyCredentials(HttpAuthRealm)
* @see #setCredentials(HttpAuthRealm, Credentials)
+ *
+ * @since 3.0
*/
public synchronized void setProxyCredentials(final HttpAuthRealm realm,
Credentials credentials)
@@ -496,6 +501,8 @@
* @return the credentials
*
* @see #setProxyCredentials(HttpAuthRealm, Credentials)
+ *
+ * @since 3.0
*/
public synchronized Credentials getProxyCredentials(HttpAuthRealm realm) {
if (realm == null) {
1.91 +20 -6 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpConnection.java
Index: HttpConnection.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HttpConnection.java,v
retrieving revision 1.90
retrieving revision 1.91
diff -u -r1.90 -r1.91
--- HttpConnection.java 11 May 2004 20:43:54 -0000 1.90
+++ HttpConnection.java 13 May 2004 04:03:25 -0000 1.91
@@ -201,6 +201,8 @@
* Returns the connection socket.
*
* @return the socket.
+ *
+ * @since 3.0
*/
protected Socket getSocket() {
return this.socket;
@@ -534,7 +536,7 @@
*
* @return HTTP parameters.
*
- * @since 2.1
+ * @since 3.0
*/
public HttpConnectionParams getParams() {
return this.params;
@@ -543,7 +545,7 @@
/**
* Assigns {@link HttpConnectionParams HTTP protocol parameters} for this method.
*
- * @since 2.1
+ * @since 3.0
*
* @see HttpConnectionParams
*/
@@ -585,6 +587,8 @@
* @throws SocketException - if there is an error in the underlying
* protocol, such as a TCP error.
* @throws IllegalStateException if not connected
+ *
+ * @since 3.0
*/
public void setSocketTimeout(int timeout)
throws SocketException, IllegalStateException {
@@ -946,6 +950,8 @@
* @param charset the charset to use for writing the data
* @throws IllegalStateException if the connection is not open
* @throws IOException if an I/O problem occurs
+ *
+ * @since 3.0
*/
public void print(String data, String charset)
throws IOException, IllegalStateException {
@@ -977,6 +983,8 @@
* @param charset the charset to use for writing the data
* @throws IllegalStateException if the connection is not open
* @throws IOException if an I/O problem occurs
+ *
+ * @since 3.0
*/
public void printLine(String data, String charset)
throws IOException, IllegalStateException {
@@ -1024,6 +1032,8 @@
* @throws IllegalStateException if the connection is not open
* @throws IOException if an I/O problem occurs
* @return a line from the response
+ *
+ * @since 3.0
*/
public String readLine(final String charset) throws IOException, IllegalStateException {
LOG.trace("enter HttpConnection.readLine()");
@@ -1098,6 +1108,8 @@
/**
* @return
+ *
+ * @since 3.0
*/
boolean isLocked() {
return locked;
@@ -1105,6 +1117,8 @@
/**
* @param locked
+ *
+ * @since 3.0
*/
void setLocked(boolean locked) {
this.locked = locked;
1.4 +4 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ConnectTimeoutException.java
Index: ConnectTimeoutException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ConnectTimeoutException.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ConnectTimeoutException.java 18 Apr 2004 23:51:34 -0000 1.3
+++ ConnectTimeoutException.java 13 May 2004 04:03:25 -0000 1.4
@@ -35,7 +35,7 @@
*
* @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
*
- * @since 2.1
+ * @since 3.0
*/
public class ConnectTimeoutException extends HttpTimeoutException {
1.10 +6 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ContentLengthInputStream.java
Index: ContentLengthInputStream.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/ContentLengthInputStream.java,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- ContentLengthInputStream.java 18 Apr 2004 23:51:34 -0000 1.9
+++ ContentLengthInputStream.java 13 May 2004 04:03:25 -0000 1.10
@@ -36,7 +36,7 @@
/**
* Cuts the wrapped InputStream off after a specified number of bytes.
*
- * @author Ortwin Gl�ck
+ * @author Ortwin Gl???ck
* @author Eric Johnson
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
* @since 2.0
@@ -75,6 +75,8 @@
* @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(InputStream in, long contentLength) {
super(in);
1.47 +12 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/URI.java
Index: URI.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/URI.java,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- URI.java 18 Apr 2004 23:51:35 -0000 1.46
+++ URI.java 13 May 2004 04:03:25 -0000 1.47
@@ -136,6 +136,8 @@
* @throws NullPointerException if input string is <code>null</code>
*
* @see #getProtocolCharset
+ *
+ * @since 3.0
*/
public URI(String s, boolean escaped, String charset)
throws URIException, NullPointerException {
@@ -155,6 +157,8 @@
* @throws NullPointerException if input string is <code>null</code>
*
* @see #getProtocolCharset
+ *
+ * @since 3.0
*/
public URI(String s, boolean escaped)
throws URIException, NullPointerException {
@@ -443,6 +447,8 @@
* <tt>false</tt> otherwise.
*
* @throws URIException If the new URI cannot be created.
+ *
+ * @since 3.0
*/
public URI(URI base, String relative, boolean escaped) throws URIException {
this(base, new URI(relative, escaped));
@@ -1747,6 +1753,8 @@
* @return original character sequence
* @throws URIException incomplete trailing escape pattern or unsupported
* character encoding
+ *
+ * @since 3.0
*/
protected static String decode(String component, String charset)
throws URIException {
1.4 +4 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/IOTimeoutException.java
Index: IOTimeoutException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/IOTimeoutException.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- IOTimeoutException.java 18 Apr 2004 23:51:35 -0000 1.3
+++ IOTimeoutException.java 13 May 2004 04:03:25 -0000 1.4
@@ -34,7 +34,7 @@
*
* @author <a href="mailto:laura@lwerner.org">Laura Werner</a>
*
- * @since 2.1
+ * @since 3.0
*/
public class IOTimeoutException extends HttpTimeoutException {
1.23 +12 -4 jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HeaderElement.java
Index: HeaderElement.java
===================================================================
RCS file: /home/cvs/jakarta-commons/httpclient/src/java/org/apache/commons/httpclient/HeaderElement.java,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- HeaderElement.java 18 Apr 2004 23:51:34 -0000 1.22
+++ HeaderElement.java 13 May 2004 04:03:25 -0000 1.23
@@ -122,6 +122,8 @@
* @param chars the array of characters
* @param offset - the initial offset.
* @param length - the length.
+ *
+ * @since 3.0
*/
public HeaderElement(char[] chars, int offset, int length) {
this();
@@ -145,6 +147,8 @@
* Constructor with array of characters.
*
* @param chars the array of characters
+ *
+ * @since 3.0
*/
public HeaderElement(char[] chars) {
this(chars, 0, chars.length);
@@ -181,6 +185,8 @@
* @param headerValue the array of char representation of the header value
* (as received from the web server).
* @return array of {@link HeaderElement}s.
+ *
+ * @since 3.0
*/
public static final HeaderElement[] parseElements(char[] headerValue) {
@@ -223,6 +229,8 @@
* @param headerValue 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[] parseElements(String headerValue) {
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org