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