Class Overview
Sends HTTP requests and receives the responses.
Takes care of request preprocessing and response postprocessing
by the respective interceptors.
Summary
[Expand]
Inherited Methods |
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this Object .
|
boolean
|
equals(Object o)
Compares this instance with the specified object and indicates if they
are equal.
|
void
|
finalize()
Invoked when the garbage collector has detected that this instance is no longer reachable.
|
final
Class<?>
|
getClass()
Returns the unique instance of Class that represents this
object's class.
|
int
|
hashCode()
Returns an integer hash code for this object.
|
final
void
|
notify()
Causes a thread which is waiting on this object's monitor (by means of
calling one of the wait() methods) to be woken up.
|
final
void
|
notifyAll()
Causes all threads which are waiting on this object's monitor (by means
of calling one of the wait() methods) to be woken up.
|
String
|
toString()
Returns a string containing a concise, human-readable description of this
object.
|
final
void
|
wait()
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.
|
final
void
|
wait(long millis, int nanos)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
final
void
|
wait(long millis)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
|
Public Constructors
public
HttpRequestExecutor
()
Create a new request executor.
Public Methods
Synchronously send a request and obtain the response.
Parameters
request
| the request to send. It will be preprocessed. |
conn
| the open connection over which to send |
Returns
- the response to the request, postprocessed
Finish a response.
This includes post-processing of the response object.
It does not read the response entity, if any.
It does not allow for immediate re-use of the
connection over which the response is coming in.
Parameters
response
| the response object to finish |
processor
| the processor to use |
context
| the context for post-processing the response |
Prepare a request for sending.
Parameters
request
| the request to prepare |
processor
| the processor to use |
context
| the context for sending the request |
Protected Methods
protected
boolean
canResponseHaveBody
(HttpRequest request, HttpResponse response)
Decide whether a response comes with an entity.
The implementation in this class is based on RFC 2616.
Unknown methods and response codes are supposed to
indicate responses with an entity.
Derived executors can override this method to handle
methods and response codes not specified in RFC 2616.
Parameters
request
| the request, to obtain the executed method |
response
| the response, to obtain the status code
|
Wait for and receive a response.
This method will automatically ignore intermediate responses
with status code 1xx.
Parameters
request
| the request for which to obtain the response |
conn
| the connection over which the request was sent |
context
| the context for receiving the response |
Returns
- the final response, not yet post-processed
Send a request over a connection.
This method also handles the expect-continue handshake if necessary.
If it does not have to handle an expect-continue handshake, it will
not use the connection for reading or anything else that depends on
data coming in over the connection.
Parameters
request
| the request to send, already
preprocessed |
conn
| the connection over which to send the request,
already established |
context
| the context for sending the request |
Returns
- a terminal response received as part of an expect-continue
handshake, or
null
if the expect-continue handshake is not used