org.apache.http.conn.scheme.SchemeSocketFactory |
Known Indirect Subclasses
|
Class Overview
A factory for creating, initializing and connecting sockets. The factory encapsulates the logic
for establishing a socket connection.
Public Methods
Connects a socket to the target host with the given remote address.
Parameters
sock
| the socket to connect, as obtained from
createSocket .
null indicates that a new socket
should be created and connected. |
remoteAddress
| the remote address to connect to |
localAddress
| the local address to bind the socket to, or
null for any |
params
| additional parameters for connecting |
Returns
- the connected socket. The returned object may be different
from the
sock
argument if this factory supports
a layered protocol.
public
abstract
boolean
isSecure
(Socket sock)
Checks whether a socket provides a secure connection. The socket must be
connected
by this factory. The factory will not perform I/O operations in this method.
As a rule of thumb, plain sockets are not secure and TLS/SSL sockets are secure. However,
there may be application specific deviations. For example, a plain socket to a host in the
same intranet ("trusted zone") could be considered secure. On the other hand, a TLS/SSL
socket could be considered insecure based on the cipher suite chosen for the connection.
Parameters
sock
| the connected socket to check |
Returns
true
if the connection of the socket
should be considered secure, or
false
if it should not
Throws
IllegalArgumentException
| if the argument is invalid, for example because it is
not a connected socket or was created by a different
socket factory.
Note that socket factories are not required to
check these conditions, they may simply return a default
value when called with an invalid socket argument.
|