SchemeSocketFactory@Deprecated public interface SocketFactory
| Modifier and Type | Method and Description |
|---|---|
Socket |
connectSocket(Socket sock,
String host,
int port,
InetAddress localAddress,
int localPort,
org.apache.http.params.HttpParams params)
Deprecated.
Connects a socket to the given host.
|
Socket |
createSocket()
Deprecated.
Creates a new, unconnected socket.
|
boolean |
isSecure(Socket sock)
Deprecated.
Checks whether a socket provides a secure connection.
|
Socket createSocket() throws IOException
connectSocket.IOException - if an I/O error occurs while creating the socketSocket connectSocket(Socket sock, String host, int port, InetAddress localAddress, int localPort, org.apache.http.params.HttpParams params) throws IOException, UnknownHostException, ConnectTimeoutException
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 toport - the port to connect to on the hostlocalAddress - the local address to bind the socket to, or
null for anylocalPort - the port on the local machine,
0 or a negative number for anyparams - additional parameters for connectingsock argument if this factory supports
a layered protocol.IOException - if an I/O error occursUnknownHostException - if the IP address of the target host
can not be determinedConnectTimeoutException - if the socket cannot be connected
within the time limit defined in the paramsboolean isSecure(Socket sock) throws IllegalArgumentException
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.
sock - the connected socket to checktrue if the connection of the socket
should be considered secure, or
false if it should notIllegalArgumentException - 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.Copyright © 1999–2022 The Apache Software Foundation. All rights reserved.