@Deprecated public abstract class AbstractClientConnAdapter extends Object implements ManagedClientConnection, org.apache.http.protocol.HttpContext
operated to
managed client connections.
Read and write methods are delegated to the wrapped connection.
Operations affecting the connection state have to be implemented
by derived classes. Operations for querying the connection state
are delegated to the wrapped connection if there is one, or
return a default value if there is none.
This adapter tracks the checkpoints for reusable communication states,
as indicated by markReusable and queried by
isMarkedReusable.
All send and receive operations will automatically clear the mark.
Connection release calls are delegated to the connection manager,
if there is one. abortConnection will
clear the reusability mark first. The connection manager is
expected to tolerate multiple calls to the release method.
| Modifier | Constructor and Description |
|---|---|
protected |
AbstractClientConnAdapter(ClientConnectionManager mgr,
OperatedClientConnection conn)
Deprecated.
Creates a new connection adapter.
|
| Modifier and Type | Method and Description |
|---|---|
void |
abortConnection()
Deprecated.
Releases the connection without the option of keep-alive.
|
protected void |
assertNotAborted()
Deprecated.
(4.1) use
assertValid(OperatedClientConnection) |
protected void |
assertValid(OperatedClientConnection wrappedConn)
Deprecated.
Asserts that there is a valid wrapped connection to delegate to.
|
void |
bind(Socket socket)
Deprecated.
Binds this connection to the given socket.
|
protected void |
detach()
Deprecated.
Detaches this adapter from the wrapped connection.
|
void |
flush()
Deprecated.
|
Object |
getAttribute(String id)
Deprecated.
|
InetAddress |
getLocalAddress()
Deprecated.
|
int |
getLocalPort()
Deprecated.
|
protected ClientConnectionManager |
getManager()
Deprecated.
|
org.apache.http.HttpConnectionMetrics |
getMetrics()
Deprecated.
|
InetAddress |
getRemoteAddress()
Deprecated.
|
int |
getRemotePort()
Deprecated.
|
Socket |
getSocket()
Deprecated.
Returns the underlying socket.
|
int |
getSocketTimeout()
Deprecated.
|
SSLSession |
getSSLSession()
Deprecated.
Obtains the SSL session of the underlying connection, if any.
|
protected OperatedClientConnection |
getWrappedConnection()
Deprecated.
|
boolean |
isMarkedReusable()
Deprecated.
Indicates whether this connection is in a reusable communication state.
|
boolean |
isOpen()
Deprecated.
|
protected boolean |
isReleased()
Deprecated.
|
boolean |
isResponseAvailable(int timeout)
Deprecated.
|
boolean |
isSecure()
Deprecated.
Indicates whether this connection is secure.
|
boolean |
isStale()
Deprecated.
|
void |
markReusable()
Deprecated.
Marks this connection as being in a reusable communication state.
|
void |
receiveResponseEntity(org.apache.http.HttpResponse response)
Deprecated.
|
org.apache.http.HttpResponse |
receiveResponseHeader()
Deprecated.
|
void |
releaseConnection()
Deprecated.
Releases the connection with the option of keep-alive.
|
Object |
removeAttribute(String id)
Deprecated.
|
void |
sendRequestEntity(org.apache.http.HttpEntityEnclosingRequest request)
Deprecated.
|
void |
sendRequestHeader(org.apache.http.HttpRequest request)
Deprecated.
|
void |
setAttribute(String id,
Object obj)
Deprecated.
|
void |
setIdleDuration(long duration,
TimeUnit unit)
Deprecated.
Sets the duration that this connection can remain idle before it is
reused.
|
void |
setSocketTimeout(int timeout)
Deprecated.
|
void |
unmarkReusable()
Deprecated.
Marks this connection as not being in a reusable state.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitgetRoute, getState, layerProtocol, open, setState, tunnelProxy, tunnelTargetgetIdprotected AbstractClientConnAdapter(ClientConnectionManager mgr, OperatedClientConnection conn)
marked as reusable.mgr - the connection manager, or nullconn - the connection to wrap, or nullprotected void detach()
protected OperatedClientConnection getWrappedConnection()
protected ClientConnectionManager getManager()
@Deprecated protected final void assertNotAborted() throws InterruptedIOException
assertValid(OperatedClientConnection)InterruptedIOExceptionprotected boolean isReleased()
protected final void assertValid(OperatedClientConnection wrappedConn) throws ConnectionShutdownException
ConnectionShutdownException - if there is no wrapped connection
or connection has been abortedpublic boolean isOpen()
isOpen in interface org.apache.http.HttpConnectionpublic boolean isStale()
isStale in interface org.apache.http.HttpConnectionpublic void setSocketTimeout(int timeout)
setSocketTimeout in interface org.apache.http.HttpConnectionpublic int getSocketTimeout()
getSocketTimeout in interface org.apache.http.HttpConnectionpublic org.apache.http.HttpConnectionMetrics getMetrics()
getMetrics in interface org.apache.http.HttpConnectionpublic void flush()
throws IOException
flush in interface org.apache.http.HttpClientConnectionIOExceptionpublic boolean isResponseAvailable(int timeout)
throws IOException
isResponseAvailable in interface org.apache.http.HttpClientConnectionIOExceptionpublic void receiveResponseEntity(org.apache.http.HttpResponse response)
throws org.apache.http.HttpException,
IOException
receiveResponseEntity in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpExceptionIOExceptionpublic org.apache.http.HttpResponse receiveResponseHeader()
throws org.apache.http.HttpException,
IOException
receiveResponseHeader in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpExceptionIOExceptionpublic void sendRequestEntity(org.apache.http.HttpEntityEnclosingRequest request)
throws org.apache.http.HttpException,
IOException
sendRequestEntity in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpExceptionIOExceptionpublic void sendRequestHeader(org.apache.http.HttpRequest request)
throws org.apache.http.HttpException,
IOException
sendRequestHeader in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpExceptionIOExceptionpublic InetAddress getLocalAddress()
getLocalAddress in interface org.apache.http.HttpInetConnectionpublic int getLocalPort()
getLocalPort in interface org.apache.http.HttpInetConnectionpublic InetAddress getRemoteAddress()
getRemoteAddress in interface org.apache.http.HttpInetConnectionpublic int getRemotePort()
getRemotePort in interface org.apache.http.HttpInetConnectionpublic boolean isSecure()
ManagedClientConnectionisSecure in interface HttpRoutedConnectionisSecure in interface ManagedClientConnectiontrue if this connection is secure,
false otherwisepublic void bind(Socket socket) throws IOException
ManagedHttpClientConnectionbind in interface ManagedHttpClientConnectionsocket - the socket to bind the connection to.IOExceptionpublic Socket getSocket()
ManagedHttpClientConnectiongetSocket in interface ManagedHttpClientConnectionpublic SSLSession getSSLSession()
ManagedClientConnectionSSLSocket, the SSL session of
that socket is obtained. This is a potentially blocking operation.
Note: Whether the underlying socket is an SSL socket
can not necessarily be determined via ManagedClientConnection.isSecure().
Plain sockets may be considered secure, for example if they are
connected to a known host in the same network segment.
On the other hand, SSL sockets may be considered insecure,
for example depending on the chosen cipher suite.
getSSLSession in interface HttpRoutedConnectiongetSSLSession in interface ManagedClientConnectiongetSSLSession in interface ManagedHttpClientConnectionnull otherwisepublic void markReusable()
ManagedClientConnection
A reusable communication state is necessary but not sufficient
for the connection to be reused.
A route mismatch, the connection being closed,
or other circumstances might prevent reuse.
markReusable in interface ManagedClientConnectionpublic void unmarkReusable()
ManagedClientConnectionreuse strategy.
Note:
It is not necessary to call here before writing to
or reading from this connection. Communication attempts will
automatically unmark the state as non-reusable. It can then
be switched back using markReusable.
unmarkReusable in interface ManagedClientConnectionpublic boolean isMarkedReusable()
ManagedClientConnectionmarkReusable and
unmarkReusable for details.isMarkedReusable in interface ManagedClientConnectiontrue if this connection is marked as being in
a reusable communication state,
false otherwisepublic void setIdleDuration(long duration,
TimeUnit unit)
ManagedClientConnectionsetIdleDuration in interface ManagedClientConnectionpublic void releaseConnection()
ConnectionReleaseTriggerabortConnection for a hard release. The
connection may be reused as specified by the duration.releaseConnection in interface ConnectionReleaseTriggerpublic void abortConnection()
ConnectionReleaseTriggerConnectionReleaseTrigger.releaseConnection() for a graceful release.abortConnection in interface ConnectionReleaseTriggerpublic Object getAttribute(String id)
getAttribute in interface org.apache.http.protocol.HttpContextpublic Object removeAttribute(String id)
removeAttribute in interface org.apache.http.protocol.HttpContextCopyright © 1999–2022 The Apache Software Foundation. All rights reserved.