| org.apache.http.conn.scheme.SocketFactory |
Known Indirect Subclasses
|
This interface is deprecated.
Please use openConnection() instead.
Please visit this webpage
for further details.
A factory for creating and connecting sockets.
The factory encapsulates the logic for establishing a socket connection.
Both Object.equals()
and Object.hashCode()
must be overridden for the correct operation of some connection managers.
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Connects a socket to the given host.
| |||||||||||
Creates a new, unconnected socket.
| |||||||||||
Checks whether a socket provides a secure connection.
| |||||||||||
Connects a socket to the given host.
| sock | the socket to connect, as obtained from
createSocket.
null indicates that a new socket
should be created and connected. |
|---|---|
| host | the host to connect to |
| port | the port to connect to on the host |
| localAddress | the local address to bind the socket to, or
null for any |
| localPort | the port on the local machine, 0 or a negative number for any |
| params | additional parameters for connecting |
sock argument if this factory supports
a layered protocol.| IOException | if an I/O error occurs |
|---|---|
| UnknownHostException | if the IP address of the target host can not be determined |
| ConnectTimeoutException | if the socket cannot be connected
within the time limit defined in the params
|
Creates a new, unconnected socket.
The socket should subsequently be passed to
connectSocket.
| IOException | if an I/O error occurs while creating the socket |
|---|
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 cypher suite chosen for the connection.
| sock | the connected socket to check |
|---|
true if the connection of the socket
should be considered secure, or
false if it should not| 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. |
|---|