- All Known Subinterfaces:
@Deprecated public interface SocketFactoryDeprecated.(4.1) use
SchemeSocketFactoryA factory for creating, initializing and connecting sockets. The factory encapsulates the logic for establishing a socket connection.
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description
connectSocket(Socket sock, String host, int port, InetAddress localAddress, int localPort, HttpParams params)Deprecated.Connects a socket to the given host.
createSocket()Deprecated.Creates a new, unconnected socket.
isSecure(Socket sock)Deprecated.Checks whether a socket provides a secure connection.
Socket createSocket() throws IOExceptionDeprecated.Creates a new, unconnected socket. The socket should subsequently be passed to
- a new socket
IOException- if an I/O error occurs while creating the socket
Socket connectSocket(Socket sock, String host, int port, InetAddress localAddress, int localPort, HttpParams params) throws IOException, UnknownHostException, ConnectTimeoutExceptionDeprecated.Connects a socket to the given host.
sock- the socket to connect, as obtained from
nullindicates 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
localPort- the port on the local machine, 0 or a negative number for any
- the connected socket. The returned object may be different
sockargument 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
boolean isSecure(Socket sock) throws IllegalArgumentExceptionDeprecated.Checks whether a socket provides a secure connection. The socket must be
connectedby 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.
sock- the connected socket to check
trueif the connection of the socket should be considered secure, or
falseif 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.