org.apache.http.client
Interface RequestDirector
- All Known Implementing Classes:
- DefaultRequestDirector
public interface RequestDirector
A client-side request director.
The director decides which steps are necessary to execute a request.
It establishes connections and optionally processes redirects and
authentication challenges. The director may therefore generate and
send a sequence of requests in order to execute one initial request.
Note:
It is most likely that implementations of this interface will
allocate connections, and return responses that depend on those
connections for reading the response entity. Such connections
MUST be released, but that is out of the scope of a request director.
- Since:
- 4.0
- Version:
- $Revision: 676020 $
- Author:
- Roland Weber
Method Summary |
org.apache.http.HttpResponse |
execute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context)
Executes a request. |
execute
org.apache.http.HttpResponse execute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
java.io.IOException
- Executes a request.
Note:
For the time being, a new director is instantiated for each request.
This is the same behavior as for HttpMethodDirector
in HttpClient 3.
- Parameters:
target
- the target host for the request.
Implementations may accept null
if they can still determine a route, for example
to a default target or by inspecting the request.request
- the request to executecontext
- the context for executing the request
- Returns:
- the final response to the request.
This is never an intermediate response with status code 1xx.
- Throws:
org.apache.http.HttpException
- in case of a problem
java.io.IOException
- in case of an IO problem
or if the connection was aborted
Copyright © 1999-2008 Apache Software Foundation. All Rights Reserved.