|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.http.impl.conn.AbstractClientConnAdapter
public abstract class AbstractClientConnAdapter
Abstract adapter from 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.
| Constructor Summary | |
|---|---|
protected |
AbstractClientConnAdapter(ClientConnectionManager mgr,
OperatedClientConnection conn)
Creates a new connection adapter. |
| Method Summary | |
|---|---|
void |
abortConnection()
Releases the connection without the option of keep-alive. |
protected void |
assertNotAborted()
Asserts that the connection has not been aborted. |
protected void |
assertValid(OperatedClientConnection wrappedConn)
Asserts that there is a wrapped connection to delegate to. |
protected void |
detach()
Detaches this adapter from the wrapped connection. |
void |
flush()
|
java.net.InetAddress |
getLocalAddress()
|
int |
getLocalPort()
|
protected ClientConnectionManager |
getManager()
|
org.apache.http.HttpConnectionMetrics |
getMetrics()
|
java.net.InetAddress |
getRemoteAddress()
|
int |
getRemotePort()
|
int |
getSocketTimeout()
|
javax.net.ssl.SSLSession |
getSSLSession()
Obtains the SSL session of the underlying connection, if any. |
protected OperatedClientConnection |
getWrappedConnection()
|
boolean |
isMarkedReusable()
Indicates whether this connection is in a reusable communication state. |
boolean |
isOpen()
|
boolean |
isResponseAvailable(int timeout)
|
boolean |
isSecure()
Indicates whether this connection is secure. |
boolean |
isStale()
|
void |
markReusable()
Marks this connection as being in a reusable communication state. |
void |
receiveResponseEntity(org.apache.http.HttpResponse response)
|
org.apache.http.HttpResponse |
receiveResponseHeader()
|
void |
releaseConnection()
Releases the connection with the option of keep-alive. |
void |
sendRequestEntity(org.apache.http.HttpEntityEnclosingRequest request)
|
void |
sendRequestHeader(org.apache.http.HttpRequest request)
|
void |
setIdleDuration(long duration,
java.util.concurrent.TimeUnit unit)
Sets the duration that this connection can remain idle before it is reused. |
void |
setSocketTimeout(int timeout)
|
void |
unmarkReusable()
Marks this connection as not being in a reusable state. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface org.apache.http.conn.ManagedClientConnection |
|---|
getRoute, getState, layerProtocol, open, setState, tunnelProxy, tunnelTarget |
| Methods inherited from interface org.apache.http.HttpConnection |
|---|
close, shutdown |
| Constructor Detail |
|---|
protected AbstractClientConnAdapter(ClientConnectionManager mgr,
OperatedClientConnection conn)
marked as reusable.
mgr - the connection manager, or nullconn - the connection to wrap, or null| Method Detail |
|---|
protected void detach()
protected OperatedClientConnection getWrappedConnection()
protected ClientConnectionManager getManager()
protected final void assertNotAborted()
throws java.io.InterruptedIOException
java.io.InterruptedIOException - if the connection has been abortedprotected final void assertValid(OperatedClientConnection wrappedConn)
java.lang.IllegalStateException - 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.HttpConnection
public void flush()
throws java.io.IOException
flush in interface org.apache.http.HttpClientConnectionjava.io.IOException
public boolean isResponseAvailable(int timeout)
throws java.io.IOException
isResponseAvailable in interface org.apache.http.HttpClientConnectionjava.io.IOException
public void receiveResponseEntity(org.apache.http.HttpResponse response)
throws org.apache.http.HttpException,
java.io.IOException
receiveResponseEntity in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpException
java.io.IOException
public org.apache.http.HttpResponse receiveResponseHeader()
throws org.apache.http.HttpException,
java.io.IOException
receiveResponseHeader in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpException
java.io.IOException
public void sendRequestEntity(org.apache.http.HttpEntityEnclosingRequest request)
throws org.apache.http.HttpException,
java.io.IOException
sendRequestEntity in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpException
java.io.IOException
public void sendRequestHeader(org.apache.http.HttpRequest request)
throws org.apache.http.HttpException,
java.io.IOException
sendRequestHeader in interface org.apache.http.HttpClientConnectionorg.apache.http.HttpException
java.io.IOExceptionpublic java.net.InetAddress getLocalAddress()
getLocalAddress in interface org.apache.http.HttpInetConnectionpublic int getLocalPort()
getLocalPort in interface org.apache.http.HttpInetConnectionpublic java.net.InetAddress getRemoteAddress()
getRemoteAddress in interface org.apache.http.HttpInetConnectionpublic int getRemotePort()
getRemotePort in interface org.apache.http.HttpInetConnectionpublic boolean isSecure()
ManagedClientConnection
isSecure in interface ManagedClientConnectiontrue if this connection is secure,
false otherwisepublic javax.net.ssl.SSLSession getSSLSession()
ManagedClientConnectionSSLSocket, the SSL session of
that socket is obtained. This is a potentially blocking operation.
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 ManagedClientConnectionnull otherwisepublic void markReusable()
ManagedClientConnectionroute mismatch, the connection being closed,
or other circumstances might prevent reuse.
markReusable in interface ManagedClientConnectionpublic void unmarkReusable()
ManagedClientConnectionreuse strategy.
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 otherwise
public void setIdleDuration(long duration,
java.util.concurrent.TimeUnit unit)
ManagedClientConnection
setIdleDuration 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()
ConnectionReleaseTriggerreleaseConnection for a graceful release.
abortConnection in interface ConnectionReleaseTrigger
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||