diff --git a/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java b/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java index a0e846d76..f2a8bedc0 100644 --- a/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java +++ b/httpclient/src/main/java/org/apache/http/client/methods/HttpUriRequest.java @@ -51,15 +51,24 @@ public interface HttpUriRequest extends HttpRequest { /** * Returns the URI this request uses, such as * http://example.org/path/to/file. - * + *
+ * Note that the URI may be absolute URI (as above) or may be a relative URI. + *

* Implementations are encouraged to return * the URI that was initially requested. - * + *

+ *

* To find the final URI after any redirects have been processed, * please see the section entitled * HTTP execution context * in the * HttpClient Tutorial + *

+ *

+ * 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. + *

*/ URI getURI();