ManagedHttpClientConnectionFactory
.@Deprecated public class DefaultClientConnection extends SocketHttpClientConnection implements OperatedClientConnection, ManagedHttpClientConnection, HttpContext
RESERVED_PREFIX
Constructor and Description |
---|
DefaultClientConnection()
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
void |
bind(Socket socket)
Deprecated.
Binds this connection to the given socket.
|
void |
close()
Deprecated.
Closes this connection gracefully.
|
Object |
getAttribute(String id)
Deprecated.
Obtains attribute with the given name.
|
String |
getId()
Deprecated.
Returns connection ID which is expected to be unique
for the life span of the connection manager.
|
Socket |
getSocket()
Deprecated.
Obtains the socket for this connection.
|
SSLSession |
getSSLSession()
Deprecated.
Obtains the SSL session of the underlying connection, if any.
|
HttpHost |
getTargetHost()
Deprecated.
Obtains the target host for this connection.
|
boolean |
isSecure()
Deprecated.
Indicates whether this connection is secure.
|
void |
openCompleted(boolean secure,
HttpParams params)
Deprecated.
Signals that the connection has been successfully open.
|
void |
opening(Socket sock,
HttpHost target)
Deprecated.
Signals that this connection is in the process of being open.
|
HttpResponse |
receiveResponseHeader()
Deprecated.
Receives the request line and headers of the next response available from
this connection.
|
Object |
removeAttribute(String id)
Deprecated.
Removes attribute with the given name from the context.
|
void |
sendRequestHeader(HttpRequest request)
Deprecated.
Sends the request line and all headers over the connection.
|
void |
setAttribute(String id,
Object obj)
Deprecated.
Sets value of the attribute with the given name.
|
void |
shutdown()
Deprecated.
Force-closes this connection.
|
void |
update(Socket sock,
HttpHost target,
boolean secure,
HttpParams params)
Deprecated.
Updates this connection.
|
getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort, getSocketTimeout, isOpen, setSocketTimeout, toString
flush, getMetrics, isResponseAvailable, isStale, receiveResponseEntity, sendRequestEntity
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
flush, isResponseAvailable, receiveResponseEntity, sendRequestEntity
getLocalAddress, getLocalPort, getRemoteAddress, getRemotePort
getMetrics, getSocketTimeout, isOpen, isStale, setSocketTimeout
public String getId()
ManagedHttpClientConnection
getId
in interface ManagedHttpClientConnection
public final HttpHost getTargetHost()
OperatedClientConnection
The return value is well-defined only while the connection is open.
It may change even while the connection is open,
because of an update
.
getTargetHost
in interface OperatedClientConnection
public final boolean isSecure()
OperatedClientConnection
update
.isSecure
in interface OperatedClientConnection
true
if this connection is secure,
false
otherwisepublic final Socket getSocket()
OperatedClientConnection
update
.getSocket
in interface ManagedHttpClientConnection
getSocket
in interface OperatedClientConnection
target host
public SSLSession getSSLSession()
ManagedHttpClientConnection
SSLSocket
, the SSL session of
that socket is obtained. This is a potentially blocking operation.getSSLSession
in interface ManagedHttpClientConnection
null
otherwisepublic void opening(Socket sock, HttpHost target) throws IOException
OperatedClientConnection
By calling this method, the connection can be re-initialized
with a new Socket instance before OperatedClientConnection.openCompleted(boolean, org.apache.http.params.HttpParams)
is called.
This enabled the connection to close that socket if
shutdown
is called before it is fully open. Closing an unconnected socket
will interrupt a thread that is blocked on the connect.
Otherwise, that thread will either time out on the connect,
or it returns successfully and then opens this connection
which was just shut down.
This method can be called multiple times if the connection is layered over another protocol. Note: This method will not close the previously used socket. It is the caller's responsibility to close that socket if it is no longer required.
The caller must invoke OperatedClientConnection.openCompleted(boolean, org.apache.http.params.HttpParams)
in order to complete
the process.
opening
in interface OperatedClientConnection
sock
- the unconnected socket which is about to
be connected.target
- the target host of this connectionIOException
public void openCompleted(boolean secure, HttpParams params) throws IOException
OperatedClientConnection
openCompleted
in interface OperatedClientConnection
secure
- true
if this connection is secure, for
example if an SSLSocket
is used, or
false
if it is not secureparams
- parameters for this connection. The parameters will
be used when creating dependent objects, for example
to determine buffer sizes.IOException
public void shutdown() throws IOException
opening
was already called but
openCompleted
was not), the associated
socket that is being connected to a remote address will be closed.
That will interrupt a thread that is blocked on connecting
the socket.
If the connection is not yet open, this will prevent the connection
from being opened.shutdown
in interface HttpConnection
shutdown
in class SocketHttpClientConnection
IOException
- in case of a problempublic void close() throws IOException
HttpConnection
shutdown
instead.close
in interface Closeable
close
in interface AutoCloseable
close
in interface HttpConnection
close
in class SocketHttpClientConnection
IOException
public void bind(Socket socket) throws IOException
ManagedHttpClientConnection
bind
in interface ManagedHttpClientConnection
socket
- the socket to bind the connection to.IOException
public void update(Socket sock, HttpHost target, boolean secure, HttpParams params) throws IOException
OperatedClientConnection
Note: Updating the connection will not close the previously used socket. It is the caller's responsibility to close that socket if it is no longer required.
update
in interface OperatedClientConnection
sock
- the new socket for communicating with the target host,
or null
to continue using the old socket.
If null
is passed, helper objects that
depend on the socket should be re-used. In that case,
some changes in the parameters will not take effect.target
- the new target host of this connectionsecure
- true
if this connection is now secure,
false
if it is not secureparams
- new parameters for this connectionIOException
public HttpResponse receiveResponseHeader() throws HttpException, IOException
HttpClientConnection
receiveResponseHeader
in interface HttpClientConnection
receiveResponseHeader
in class AbstractHttpClientConnection
HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorpublic void sendRequestHeader(HttpRequest request) throws HttpException, IOException
HttpClientConnection
sendRequestHeader
in interface HttpClientConnection
sendRequestHeader
in class AbstractHttpClientConnection
request
- the request whose headers to send.HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorpublic Object getAttribute(String id)
HttpContext
getAttribute
in interface HttpContext
id
- the attribute name.null
if not set.public Object removeAttribute(String id)
HttpContext
removeAttribute
in interface HttpContext
id
- the attribute name.null
if not set.public void setAttribute(String id, Object obj)
HttpContext
setAttribute
in interface HttpContext
id
- the attribute name.obj
- the attribute value.Copyright © 2010 - 2020 Adobe. All Rights Reserved