getTargetHost

Obtains the target host for this connection.
If the connection is to a proxy but not tunnelled, this is
the proxy. If the connection is tunnelled through a proxy,
this is the target of the tunnel.
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.

getSSLSession

Obtains the SSL session of the underlying connection, if any.
If this connection is open, and the underlying socket is an
SSLSocket, the SSL session of
that socket is obtained. This is a potentially blocking operation.

opening

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.

shutdown

Force-closes this connection.
If the connection is still in the process of being open (the method
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.

update

Updates this connection.
A connection can be updated only while it is open.
Updates are used for example when a tunnel has been established,
or when a TLS/SSL connection has been layered on top of a plain
socket connection.
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.

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 connection

secure - true if this connection is now secure,
false if it is not secure