svn commit: r1365924 - /httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java

[ol...@apache.org]

Author: olegk
Date: Thu Jul 26 09:31:11 2012
New Revision: 1365924

URL: http://svn.apache.org/viewvc?rev=1365924&view=rev
Log:
HTTPCORE-302: Added EntityUtils#updateEntity method
Contributed by William R. Speirs <bill.speirs at gmail.com>

Modified:
    httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java

Modified: httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java?rev=1365924&r1=1365923&r2=1365924&view=diff
==============================================================================
--- httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java (original)
+++ httpcomponents/httpcore/branches/4.2.x/httpcore/src/main/java/org/apache/http/HttpResponse.java Thu Jul 26 09:31:11 2012
@@ -130,9 +130,15 @@ public interface HttpResponse extends Ht
 
     /**
      * Associates a response entity with this response.
+     * <p/>
+     * Please note that if an entity has already been set for this response and it depends on 
+     * an input stream ({@link HttpEntity#isStreaming()} returns <code>true</code>), 
+     * it must be fully consumed in order to ensure release of resources.
      *
      * @param entity    the entity to associate with this response, or
      *                  <code>null</code> to unset
+     *                  
+     * @see HttpEntity#isStreaming()
      */
     void setEntity(HttpEntity entity);