Package org.apache.http.conn
Interface ConnectionRequest
- All Superinterfaces:
org.apache.http.concurrent.Cancellable
public interface ConnectionRequest
extends org.apache.http.concurrent.Cancellable
Represents a request for a
HttpClientConnection
whose life cycle
is managed by a connection manager.- Since:
- 4.3
-
Method Summary
Methods inherited from interface org.apache.http.concurrent.Cancellable
cancel
-
Method Details
-
get
org.apache.http.HttpClientConnection get(long timeout, TimeUnit timeUnit) throws InterruptedException, ExecutionException, ConnectionPoolTimeoutException Obtains a connection within a given time. This method will block until a connection becomes available, the timeout expires, or the connection manager is shut down. Timeouts are handled with millisecond precision. IfCancellable.cancel()
is called while this is blocking or before this began, anInterruptedException
will be thrown.- Parameters:
timeout
- the timeout, 0 or negative for no timeouttimeUnit
- the unit for thetimeout
, may benull
only if there is no timeout- Returns:
- a connection that can be used to communicate along the given route
- Throws:
ConnectionPoolTimeoutException
- in case of a timeoutInterruptedException
- if the calling thread is interrupted while waitingExecutionException
-