hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1043510 - /httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java
Date Wed, 08 Dec 2010 16:43:29 GMT
Author: sebb
Date: Wed Dec  8 16:43:29 2010
New Revision: 1043510

URL: http://svn.apache.org/viewvc?rev=1043510&view=rev
Log:
Clarify that getURI() may return a relative URI

Modified:
    httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java

Modified: httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java
URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java?rev=1043510&r1=1043509&r2=1043510&view=diff
==============================================================================
--- httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java
(original)
+++ httpcomponents/httpclient/trunk/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java
Wed Dec  8 16:43:29 2010
@@ -51,15 +51,24 @@ public interface HttpUriRequest extends 
     /**
      * Returns the URI this request uses, such as
      * <code>http://example.org/path/to/file</code>.
-     *
+     * <br/>
+     * Note that the URI may be absolute URI (as above) or may be a relative URI.
+     * <p>
      * Implementations are encouraged to return
      * the URI that was initially requested.
-     *
+     * </p>
+     * <p>
      * To find the final URI after any redirects have been processed,
      * please see the section entitled
      * <a href="http://hc.apache.org/httpcomponents-client-ga/tutorial/html/fundamentals.html#d4e205">HTTP
execution context</a>
      * in the
      * <a href="http://hc.apache.org/httpcomponents-client-ga/tutorial/html">HttpClient
Tutorial</a>
+     * </p>
+     * <p>
+     * The final HttpRequest object in the execution context always represents
+     * the state of the message _exactly_ as it was sent to the target server.
+     * Per default HTTP/1.0 and HTTP/1.1 use relative request URIs.
+     * </p>
      */
     URI getURI();
 



Mime
View raw message