org.apache.http.client.methods

Class HttpRequestWrapper

java.lang.Object

org.apache.http.message.AbstractHttpMessage

org.apache.http.client.methods.HttpRequestWrapper

All Implemented Interfaces:

HttpUriRequest, org.apache.http.HttpMessage, org.apache.http.HttpRequest

Direct Known Subclasses:

HttpRequestWrapper.HttpEntityEnclosingRequestWrapper

public class HttpRequestWrapper
extends org.apache.http.message.AbstractHttpMessage
implements HttpUriRequest

A wrapper class for HttpRequest that can be used to change properties of the current request without modifying the original object.

Since:

4.3

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	HttpRequestWrapper.HttpEntityEnclosingRequestWrapper

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	method
private org.apache.http.HttpRequest	original
private org.apache.http.RequestLine	requestLine
private org.apache.http.HttpHost	target
private java.net.URI	uri
private org.apache.http.ProtocolVersion	version

Fields inherited from class org.apache.http.message.AbstractHttpMessage

headergroup, params

Constructor Summary

Constructors

Modifier	Constructor and Description
private	HttpRequestWrapper(org.apache.http.HttpRequest request, org.apache.http.HttpHost target)

Method Summary

Modifier and Type	Method and Description
void	abort() Aborts execution of the request.
java.lang.String	getMethod() Returns the HTTP method this request uses, such as GET, PUT, POST, or other.
org.apache.http.HttpRequest	getOriginal()
org.apache.http.params.HttpParams	getParams() Deprecated. (4.3) use RequestConfig.
org.apache.http.ProtocolVersion	getProtocolVersion()
org.apache.http.RequestLine	getRequestLine()
org.apache.http.HttpHost	getTarget()
java.net.URI	getURI() Returns the URI this request uses, such as http://example.org/path/to/file.
boolean	isAborted() Tests if the request execution has been aborted.
void	setProtocolVersion(org.apache.http.ProtocolVersion version)
void	setURI(java.net.URI uri)
java.lang.String	toString()
static HttpRequestWrapper	wrap(org.apache.http.HttpRequest request) Creates a mutable wrapper of the original request.
static HttpRequestWrapper	wrap(org.apache.http.HttpRequest request, org.apache.http.HttpHost target) Creates a mutable wrapper of the original request.

Methods inherited from class org.apache.http.message.AbstractHttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.http.HttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Field Detail

original

private final org.apache.http.HttpRequest original

target

private final org.apache.http.HttpHost target

method

private final java.lang.String method

requestLine

private org.apache.http.RequestLine requestLine

version

private org.apache.http.ProtocolVersion version

uri

private java.net.URI uri

Constructor Detail

HttpRequestWrapper

private HttpRequestWrapper(org.apache.http.HttpRequest request,
                           org.apache.http.HttpHost target)

Method Detail

getProtocolVersion

public org.apache.http.ProtocolVersion getProtocolVersion()

Specified by:

getProtocolVersion in interface org.apache.http.HttpMessage

setProtocolVersion

public void setProtocolVersion(org.apache.http.ProtocolVersion version)

getURI

public java.net.URI getURI()

Description copied from interface: HttpUriRequest

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

Specified by:

getURI in interface HttpUriRequest

setURI

public void setURI(java.net.URI uri)

getMethod

public java.lang.String getMethod()

Description copied from interface: HttpUriRequest

Returns the HTTP method this request uses, such as GET, PUT, POST, or other.

Specified by:

getMethod in interface HttpUriRequest

abort

public void abort()
           throws java.lang.UnsupportedOperationException

Description copied from interface: HttpUriRequest

Aborts execution of the request.

Specified by:

abort in interface HttpUriRequest

Throws:

java.lang.UnsupportedOperationException - if the abort operation is not supported / cannot be implemented.

isAborted

public boolean isAborted()

Description copied from interface: HttpUriRequest

Tests if the request execution has been aborted.

Specified by:

isAborted in interface HttpUriRequest

Returns:

true if the request execution has been aborted, false otherwise.

getRequestLine

public org.apache.http.RequestLine getRequestLine()

Specified by:

getRequestLine in interface org.apache.http.HttpRequest

getOriginal

public org.apache.http.HttpRequest getOriginal()

getTarget

public org.apache.http.HttpHost getTarget()

Since:

4.4

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

wrap

public static HttpRequestWrapper wrap(org.apache.http.HttpRequest request)

Creates a mutable wrapper of the original request.

Parameters:

request - original request

Returns:

mutable request wrappering the original one

wrap

public static HttpRequestWrapper wrap(org.apache.http.HttpRequest request,
                                      org.apache.http.HttpHost target)

Creates a mutable wrapper of the original request.

Parameters:

request - original request

target - original target, if explicitly specified

Returns:

mutable request wrappering the original one

Since:

4.4

getParams

@Deprecated
public org.apache.http.params.HttpParams getParams()

Deprecated. (4.3) use RequestConfig.

Specified by:

getParams in interface org.apache.http.HttpMessage

Overrides:

getParams in class org.apache.http.message.AbstractHttpMessage