compact2, compact3

javax.rmi.ssl

Class SslRMIServerSocketFactory

java.lang.Object

javax.rmi.ssl.SslRMIServerSocketFactory

All Implemented Interfaces:

RMIServerSocketFactory

public class SslRMIServerSocketFactory
extends Object
implements RMIServerSocketFactory

一个SslRMIServerSocketFactory实例通过RMI运行时用来获得RMI服务器通过SSL套接字调用。

这个类实现了RMIServerSocketFactory通过安全套接字层（SSL）和传输层安全（TLS）协议。

这类创建SSL套接字使用默认的SSLSocketFactory（见SSLSocketFactory.getDefault()）或默认SSLServerSocketFactory（见SSLServerSocketFactory.getDefault()）除非构造函数以SSLContext是用在这种情况下，SSL套接字使用SSLSocketFactory创建返回SSLContext.getSocketFactory()或SSLServerSocketFactory返回SSLContext.getServerSocketFactory()。当一个SSLContext不提供该类的所有实例共享相同的密钥库，和相同的信任库（当客户端身份验证服务器要求的）。这种行为可以通过提供一个已初始化的SSLContext实例修改。

从以下版本开始：

一点五

另请参见：

SSLSocketFactory， SSLServerSocketFactory， SslRMIClientSocketFactory

构造方法摘要

构造方法

Constructor and Description
SslRMIServerSocketFactory() 创建具有默认SSL Socket配置一个新的 SslRMIServerSocketFactory。
SslRMIServerSocketFactory(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) 创建具有指定 SSLContext和SSL Socket配置一个新的 SslRMIServerSocketFactory。
SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) 创建具有指定SSL Socket配置一个新的 SslRMIServerSocketFactory。

方法摘要

Modifier and Type	Method and Description
ServerSocket	createServerSocket(int port) 创建服务器套接字接受SSL连接配置，根据该厂的SSL套接字配置参数。
boolean	equals(Object obj) 指示是否有其他对象“等于”这一个。
String[]	getEnabledCipherSuites() 返回对SSL连接的服务器套接字创建启用本厂接受的密码套件的名称，或 null如果本厂使用的是默认启用的密码套件。
String[]	getEnabledProtocols() 返回的名称的协议版本的SSL连接的服务器套接字创建启用本厂接受，或 null如果本厂使用的是默认启用的协议版本。
boolean	getNeedClientAuth() 返回 true如果是SSL连接的服务器套接字由本厂创建接受要求客户端身份验证。
int	hashCode() 返回此 SslRMIServerSocketFactory哈希代码值。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SslRMIServerSocketFactory

public SslRMIServerSocketFactory()

创建具有默认SSL Socket配置一个新的SslRMIServerSocketFactory。

SSL连接的服务器套接字接受本厂创建有默认的密码套件和协议版本启用不需要客户端身份验证。

SslRMIServerSocketFactory

public SslRMIServerSocketFactory(String[] enabledCipherSuites,
                                 String[] enabledProtocols,
                                 boolean needClientAuth)
                          throws IllegalArgumentException

创建具有指定SSL Socket配置一个新的SslRMIServerSocketFactory。

参数

enabledCipherSuites名称的所有密码套件对SSL连接的服务器套接字由本厂创建接受使，或 null使用的是默认启用的密码套件

enabledProtocols名称的所有协议版本的SSL连接上的服务器套接字由本厂创建接受使，或 null使用的是默认启用的协议版本

needClientAuth - true要求SSL连接的服务器套接字由本厂创建接受客户端认证； false不要求客户端身份验证

异常

IllegalArgumentException -当一个或更多的密码套件的 enabledCipherSuites参数命名是不支持的，当一个或更多的协议由 enabledProtocols参数命名不支持或当问题而试图检查提供的密码套件和协议能够支持遇到。

另请参见：

SSLSocket.setEnabledCipherSuites(java.lang.String[])， SSLSocket.setEnabledProtocols(java.lang.String[])， SSLSocket.setNeedClientAuth(boolean)

SslRMIServerSocketFactory

public SslRMIServerSocketFactory(SSLContext context,
                                 String[] enabledCipherSuites,
                                 String[] enabledProtocols,
                                 boolean needClientAuth)
                          throws IllegalArgumentException

创建具有指定SSLContext和SSL Socket配置一个新的SslRMIServerSocketFactory。

参数

context - SSL上下文用来创建SSL套接字。如果 context是无效的默认 SSLSocketFactory或默认 SSLServerSocketFactory将用于创建SSL套接字。否则，返回的套接字工厂 SSLContext.getSocketFactory()或 SSLContext.getServerSocketFactory()将代替。

enabledCipherSuites名称的所有密码套件对SSL连接的服务器套接字由本厂创建接受使，或 null使用的是默认启用的密码套件

enabledProtocols名称的所有协议版本的SSL连接上的服务器套接字由本厂创建接受使，或 null使用的是默认启用的协议版本

needClientAuth - true要求SSL连接的服务器套接字由本厂创建接受客户端认证； false不要求客户端身份验证

异常

IllegalArgumentException -当一个或更多的密码套件的 enabledCipherSuites参数命名是不支持的，当一个或更多的协议由 enabledProtocols参数命名不支持或当问题而试图检查提供的密码套件和协议能够支持遇到。

从以下版本开始：

一点七

另请参见：

SSLSocket.setEnabledCipherSuites(java.lang.String[])， SSLSocket.setEnabledProtocols(java.lang.String[])， SSLSocket.setNeedClientAuth(boolean)

方法详细信息

getEnabledCipherSuites

public final String[] getEnabledCipherSuites()

返回对SSL连接的服务器套接字创建启用本厂接受的密码套件的名称，或null如果本厂使用的是默认启用的密码套件。

结果

密码套件阵列启用，或 null

另请参见：

SSLSocket.setEnabledCipherSuites(java.lang.String[])

getEnabledProtocols

public final String[] getEnabledProtocols()

返回的名称的协议版本的SSL连接的服务器套接字创建启用本厂接受，或null如果本厂使用的是默认启用的协议版本。

结果

协议版本的数组功能，或 null

另请参见：

SSLSocket.setEnabledProtocols(java.lang.String[])

getNeedClientAuth

public final boolean getNeedClientAuth()

返回true如果是SSL连接的服务器套接字由本厂创建接受要求客户端身份验证。

结果

true如果客户需要认证

另请参见：

SSLSocket.setNeedClientAuth(boolean)

createServerSocket

public ServerSocket createServerSocket(int port)
                                throws IOException

创建服务器套接字接受SSL连接配置，根据该厂的SSL套接字配置参数。

Specified by:

createServerSocket 接口 RMIServerSocketFactory

参数

port -端口号

结果

指定端口上的服务器套接字

异常

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

equals

public boolean equals(Object obj)

指示是否有其他对象“等于”这一个。

如果他们有相同的SSL上下文和SSL套接字配置参数，构建了两SslRMIServerSocketFactory对象是相等的。

子类必须重写此方法（以及hashCode()）如果它增加了实例状态影响平等。

重写：

equals 方法重写，继承类 Object

参数

obj -参考对象的比较。

结果

如果这个对象是 true obj参数相同； false否则。

另请参见：

Object.hashCode()， HashMap

hashCode

public int hashCode()

返回此SslRMIServerSocketFactory哈希代码值。

重写：

hashCode 方法重写，继承类 Object

结果

这 SslRMIServerSocketFactory哈希代码值。

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)