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