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() このコンテキストの ServerSocketFactory クライアントオブジェクトを返します。
protected SSLParameters	engineGetDefaultSSLParameters() この SSL コンテキストのデフォルト設定を示す SSLParameters のコピーを返します。
protected abstract SSLSessionContext	engineGetServerSessionContext() このコンテキストの ServerSocketFactory サーバーオブジェクトを返します。
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()

このコンテキストの ServerSocketFactory サーバーオブジェクトを返します。

戻り値:

SSLSessionContext オブジェクト

関連項目:

SSLContext.getServerSessionContext()

engineGetClientSessionContext

protected abstract SSLSessionContext engineGetClientSessionContext()

このコンテキストの ServerSocketFactory クライアントオブジェクトを返します。

戻り値:

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