org.apache.http.conn.scheme

Interface SocketFactory

All Known Subinterfaces:

LayeredSocketFactory

所有已知实现类：

MultihomePlainSocketFactory ， PlainSocketFactory ， SSLSocketFactory

已过时。

（4.1）使用SchemeSocketFactory

@Deprecated
public interface SocketFactory

用于创建，初始化和连接套接字的工厂。 工厂封装了用于建立套接字连接的逻辑。

从以下版本开始：

4

方法摘要

Methods

Modifier and Type	Method and Description
Socket	connectSocket(Socket sock, String host, int port, InetAddress localAddress, int localPort, HttpParams params) 已过时。 将套接字连接到给定的主机。
Socket	createSocket() 已过时。 创建一个新的，未连接的套接字。
boolean	isSecure(Socket sock) 已过时。 检查套接字是否提供安全连接。

方法详细信息

createSocket

Socket createSocket()
                    throws IOException

已过时。

创建一个新的，未连接的套接字。 插座应随后传递至connectSocket 。

结果

一个新插座

异常

IOException - 如果在创建套接字时发生I / O错误

connectSocket

Socket connectSocket(Socket sock,
                   String host,
                   int port,
                   InetAddress localAddress,
                   int localPort,
                   HttpParams params)
                     throws IOException,
                            UnknownHostException,
                            ConnectTimeoutException

已过时。

将套接字连接到给定的主机。

参数

sock - 要从createSocket获得的套接字 。 null表示应该创建并连接新的套接字。

host - 要连接的主机

port - 主机上要连接的端口

localAddress - 将套接字绑定到的本地地址，或任何 null

localPort - 本地机器上的端口，0或任何负数

params - 附加parameters用于连接

结果

连接的插座。 如果此工厂支持分层协议，则返回的对象可能与sock参数不同。

异常

IOException - 如果发生I / O错误

UnknownHostException - 如果目标主机的IP地址无法确定

ConnectTimeoutException - 如果在 params定义的时间限制内无法连接 params

isSecure

boolean isSecure(Socket sock)
                 throws IllegalArgumentException

已过时。

检查套接字是否提供安全连接。 该工厂的插座必须是connected 。 本方法不会执行I / O操作。

根据经验，普通套接字不安全，TLS / SSL套接字是安全的。 但是，可能存在应用程序特定的偏差。 例如，同一内部网（“受信任区域”）中的主机的普通套接字可能被认为是安全的。 另一方面，基于为连接选择的密码套件，TLS / SSL套接字可能被认为是不安全的。

参数

sock - 连接的套接字进行检查

结果

true如果套接字的连接应该被认为是安全的，或者 false如果不应该

异常

IllegalArgumentException - 如果参数无效，例如因为它不是连接的套接字，或者由不同的套接字工厂创建。 需要注意的是套接字工厂不需要检查这些条件，他们可能只是返回默认值时使用无效的插座参数调用。