JavaTM Platform
Standard Ed. 6

javax.net.ssl
类 SSLContextSpi

java.lang.Object
  继承者 javax.net.ssl.SSLContextSpi

public abstract class SSLContextSpi
extends Object

此类为 SSLContext 类定义了服务提供者接口 (SPI)。

此类中的所有抽象方法都必须由每个想要提供实现特定 SSL 上下文的加密服务提供者实现。

从以下版本开始:
1.4
另请参见:
SSLContext

构造方法摘要
SSLContextSpi()
           
 
方法摘要
protected abstract  SSLEngine engineCreateSSLEngine()
          使用此上下文创建新的 SSLEngine
protected abstract  SSLEngine engineCreateSSLEngine(String host, int port)
          使用此上下文创建 SSLEngine
protected abstract  SSLSessionContext engineGetClientSessionContext()
          返回此上下文的客户端 SSLSessionContext 对象。
protected  SSLParameters engineGetDefaultSSLParameters()
          返回表示此 SSL 上下文默认设置的 SSLParameters 的副本。
protected abstract  SSLSessionContext engineGetServerSessionContext()
          返回此上下文的服务器 SSLSessionContext 对象。
protected abstract  SSLServerSocketFactory engineGetServerSocketFactory()
          返回此上下文的 ServerSocketFactory 对象。
protected abstract  SSLSocketFactory engineGetSocketFactory()
          返回此上下文的 SocketFactory 对象。
protected  SSLParameters engineGetSupportedSSLParameters()
          返回表示此 SSL 上下文最大受支持设置的 SSLParameters 的副本。
protected abstract  void engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr)
          初始化此上下文。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

SSLContextSpi

public SSLContextSpi()
方法详细信息

engineInit

protected abstract void engineInit(KeyManager[] km,
                                   TrustManager[] tm,
                                   SecureRandom sr)
                            throws KeyManagementException
初始化此上下文。

参数:
km - 验证密钥源
tm - 同位体验证信任决策源或
sr - 随机源
抛出:
KeyManagementException - 如果此操作失败
另请参见:
SSLContext.init(KeyManager [], TrustManager [], SecureRandom)

engineGetSocketFactory

protected abstract SSLSocketFactory engineGetSocketFactory()
返回此上下文的 SocketFactory 对象。

返回:
SocketFactory 对象
抛出:
IllegalStateException - 如果 SSLContextImpl 需要初始化并且尚未调用 engineInit()
另请参见:
SSLContext.getSocketFactory()

engineGetServerSocketFactory

protected abstract SSLServerSocketFactory engineGetServerSocketFactory()
返回此上下文的 ServerSocketFactory 对象。

返回:
ServerSocketFactory 对象
抛出:
IllegalStateException - 如果 SSLContextImpl 需要初始化并且尚未调用 engineInit()
另请参见:
SSLContext.getServerSocketFactory()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine()
使用此上下文创建新的 SSLEngine

使用此工厂方法的应用程序不为内部会话重用策略提供提示。如果需要提示,则应该使用 engineCreateSSLEngine(String, int)

某些密码套件(例如 Kerberos)需要远程主机名信息,在这种情况下不应该使用此工厂方法。

返回:
SSLEngine 对象
抛出:
IllegalStateException - 如果 SSLContextImpl 需要初始化并且尚未调用 engineInit()
从以下版本开始:
1.5
另请参见:
SSLContext.createSSLEngine()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine(String host,
                                                   int port)
使用此上下文创建 SSLEngine

使用此工厂方法的应用程序为内部会话重用策略提供提示。

某些密码套件(例如 Kerberos)需要远程主机名信息,在这种情况下需要指定 peerHost。

参数:
host - 主机的非授权名
port - 非授权端口号
返回:
SSLEngine 对象
抛出:
IllegalStateException - 如果 SSLContextImpl 需要初始化并且尚未调用 engineInit()
从以下版本开始:
1.5
另请参见:
SSLContext.createSSLEngine(String, int)

engineGetServerSessionContext

protected abstract SSLSessionContext engineGetServerSessionContext()
返回此上下文的服务器 SSLSessionContext 对象。

返回:
SSLSessionContext 对象
另请参见:
SSLContext.getServerSessionContext()

engineGetClientSessionContext

protected abstract SSLSessionContext engineGetClientSessionContext()
返回此上下文的客户端 SSLSessionContext 对象。

返回:
SSLSessionContext 对象
另请参见:
SSLContext.getClientSessionContext()

engineGetDefaultSSLParameters

protected SSLParameters engineGetDefaultSSLParameters()
返回表示此 SSL 上下文默认设置的 SSLParameters 的副本。

该参数将始终具有密码套件和设置为非 null 值的协议数组。

默认实现从通过调用此上下文 SocketFactory 的 SocketFactory.createSocket() 方法所创建的 SSLSocket 获得该参数。

返回:
具有默认设置的 SSLParameters 对象的副本
抛出:
UnsupportedOperationException - 如果不能获得默认的 SSL 参数。
从以下版本开始:
1.6

engineGetSupportedSSLParameters

protected SSLParameters engineGetSupportedSSLParameters()
返回表示此 SSL 上下文最大受支持设置的 SSLParameters 的副本。

该参数将始终具有密码套件和设置为非 null 值的协议数组。

默认实现从通过调用此上下文 SocketFactory 的 SocketFactory.createSocket() 方法所创建的 SSLSocket 获得该参数。

返回:
具有最大受支持设置的 SSLParameters 对象的副本
抛出:
UnsupportedOperationException - 如果不能获得受支持的 SSL 参数。
从以下版本开始:
1.6

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策