org.apache.http.conn.scheme

Interface SchemeSocketFactory

All Known Subinterfaces:

LayeredSchemeSocketFactory ， SchemeLayeredSocketFactory

所有已知实现类：

PlainSocketFactory ， SSLSocketFactory

已过时。

（4.3）使用ConnectionSocketFactory

@Deprecated
public interface SchemeSocketFactory

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

从以下版本开始：

4.1

方法摘要

Methods

Modifier and Type	Method and Description
Socket	connectSocket(Socket sock, InetSocketAddress remoteAddress, InetSocketAddress localAddress, HttpParams params) 已过时。 使用给定的远程地址将套接字连接到目标主机。
Socket	createSocket(HttpParams params) 已过时。 创建一个新的，未连接的套接字。
boolean	isSecure(Socket sock) 已过时。 检查套接字是否提供安全连接。

方法详细信息

createSocket

Socket createSocket(HttpParams params)
                    throws IOException

已过时。

创建一个新的，未连接的套接字。 该插座应随后传递至connectSocket(Socket, InetSocketAddress, InetSocketAddress, HttpParams) 。

参数

params - 可选parameters 。 在大多数情况下，这些参数将不会被要求，并且不起作用，因为通常在connectSocket(Socket, InetSocketAddress, InetSocketAddress, HttpParams)方法中应该进行套接字初始化。 但是，在极少数情况下，可能需要将其他参数传递给此方法，以便创建自定义的Socket实例，例如绑定到SOCKS代理服务器。

结果

一个新插座

异常

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

connectSocket

Socket connectSocket(Socket sock,
                   InetSocketAddress remoteAddress,
                   InetSocketAddress localAddress,
                   HttpParams params)
                     throws IOException,
                            UnknownHostException,
                            ConnectTimeoutException

已过时。

使用给定的远程地址将套接字连接到目标主机。

请注意， HttpInetSocketAddress类应该用于传递目标远程地址以及用于解析地址的原始HttpHost值。 如果目标远程地址被指定为IP地址，则HttpInetSocketAddress的使用也可以确保不执行反向DNS查找。

参数

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

remoteAddress - 要连接的远程地址。

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

params - 附加parameters进行连接

结果

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

异常

IOException - 如果发生I / O错误

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

ConnectTimeoutException - 如果套接字在 params定义的 params内无法连接

另请参见：

HttpInetSocketAddress

isSecure

boolean isSecure(Socket sock)
                 throws IllegalArgumentException

已过时。

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

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

参数

sock - 连接的套接字检查

结果

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

异常

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