Index: C:/Documents and Settings/Ortwin/My Documents/code/HttpClient-3.1/src/java/org/apache/commons/httpclient/HttpMethodBase.java =================================================================== --- C:/Documents and Settings/Ortwin/My Documents/code/HttpClient-3.1/src/java/org/apache/commons/httpclient/HttpMethodBase.java (revision 539419) +++ C:/Documents and Settings/Ortwin/My Documents/code/HttpClient-3.1/src/java/org/apache/commons/httpclient/HttpMethodBase.java (working copy) @@ -655,7 +655,9 @@ /** * Returns the response body of the HTTP method, if any, as an array of bytes. - * If response body is not available or cannot be read, returns null + * If response body is not available or cannot be read, returns null. + * Buffers the response and this method can be called several times yielding + * the same result each time. * * Note: This will cause the entire response body to be buffered in memory. A * malicious server may easily exhaust all the VM memory. It is strongly @@ -698,7 +700,9 @@ /** * Returns the response body of the HTTP method, if any, as an array of bytes. - * If response body is not available or cannot be read, returns null + * If response body is not available or cannot be read, returns null. + * Buffers the response and this method can be called several times yielding + * the same result each time. * * Note: This will cause the entire response body to be buffered in memory. This method is * safe if the content length of the response is unknown, because the amount of memory used @@ -755,7 +759,9 @@ /** * Returns the response body of the HTTP method, if any, as an {@link InputStream}. - * If response body is not available, returns null + * If response body is not available, returns null. If the response has been + * buffered this method returns a new stream object on every call. If the response + * has not been buffered the returned stream can only be read once. * * @return The response body or null. * @@ -778,7 +784,8 @@ * Returns the response body of the HTTP method, if any, as a {@link String}. * If response body is not available or cannot be read, returns null * The string conversion on the data is done using the character encoding specified - * in Content-Type header. + * in Content-Type header. Buffers the response and this method can be + * called several times yielding the same result each time. * * Note: This will cause the entire response body to be buffered in memory. A * malicious server may easily exhaust all the VM memory. It is strongly @@ -806,7 +813,8 @@ * Returns the response body of the HTTP method, if any, as a {@link String}. * If response body is not available or cannot be read, returns null * The string conversion on the data is done using the character encoding specified - * in Content-Type header.

+ * in Content-Type header. Buffers the response and this method can be + * called several times yielding the same result each time.

* * Note: This will cause the entire response body to be buffered in memory. This method is * safe if the content length of the response is unknown, because the amount of memory used