java.lang.Object
javax.net.ssl.SSLContextSpi
public abstract class SSLContextSpi extends Object
このクラスは、
SSLContext
クラスのサービス・プロバイダ・インタフェース (SPI)を定義します。
特定のSSLコンテキストの実装を提供する各暗号サービス・プロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明protected abstract SSLEngine
このコンテキストを使用して、新しいSSLEngine
を作成します。protected abstract SSLEngine
engineCreateSSLEngine
(String host, int port) このコンテキストを使用するSSLEngine
を作成します。protected abstract SSLSessionContext
このコンテキストのSSLSessionContext
クライアント・オブジェクトを返します。protected SSLParameters
このSSLコンテキストのデフォルト設定を示すSSLParametersのコピーを返します。protected abstract SSLSessionContext
このコンテキストのSSLSessionContext
サーバー・オブジェクトを返します。protected abstract SSLServerSocketFactory
このコンテキストのServerSocketFactory
オブジェクトを返します。protected abstract SSLSocketFactory
このコンテキストのSocketFactory
オブジェクトを返します。protected SSLParameters
このSSLコンテキストでサポートされる最大の設定を示すSSLParametersのコピーを返します。protected abstract void
engineInit
(KeyManager[] km, TrustManager[] tm, SecureRandom sr) このコンテキストを初期化します。
-
コンストラクタの詳細
-
SSLContextSpi
public SSLContextSpi()サブクラスが呼び出すためのコンストラクタ。
-
-
メソッドの詳細
-
engineInit
protected abstract void engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr) throws KeyManagementException このコンテキストを初期化します。- パラメータ:
km
- 認証キーのソースtm
- ピア認証の信頼を判断するソースsr
- 乱数発生の元- 例外:
KeyManagementException
- この操作が失敗した場合- 関連項目:
-
engineGetSocketFactory
protected abstract SSLSocketFactory engineGetSocketFactory()このコンテキストのSocketFactory
オブジェクトを返します。- 戻り値:
SocketFactory
オブジェクト- 例外:
UnsupportedOperationException
- ベースとなるプロバイダがこの操作を実装していない場合。IllegalStateException
- SSLContextImplに初期化が必要であり、engineInit()
が呼び出されていない場合- 関連項目:
-
engineGetServerSocketFactory
protected abstract SSLServerSocketFactory engineGetServerSocketFactory()このコンテキストのServerSocketFactory
オブジェクトを返します。- 戻り値:
ServerSocketFactory
オブジェクト- 例外:
UnsupportedOperationException
- ベースとなるプロバイダがこの操作を実装していない場合。IllegalStateException
- SSLContextImplに初期化が必要であり、engineInit()
が呼び出されていない場合- 関連項目:
-
engineCreateSSLEngine
protected abstract SSLEngine engineCreateSSLEngine()このコンテキストを使用して、新しいSSLEngine
を作成します。このファクトリ・メソッドを使用しているアプリケーションは、内部セッションの再利用に関するヒントを提供しません。 ヒントが必要な場合は、代わりに
engineCreateSSLEngine(String, int)
を使用するようにしてください。Kerberosなど、リモート・ホスト名の情報を必要とする暗号化方式群もあります。この場合は、このファクトリ・メソッドを使用しないでください。
- 実装上のノート:
- 返されるSSLEngineが(D)TLS接続にデフォルトでクライアントまたはサーバー・モードを使用する場合、プロバイダ固有です。 JDK SunJSSEプロバイダの実装では、デフォルトでサーバー・モードが使用されます。 ただし、SSLEngineの他のメソッドを呼び出す前に、
SSLEngine.setUseClientMode()
をコールして、常に目的のモードを明示的に設定することをお薦めします。 - 戻り値:
SSLEngine
オブジェクト- 例外:
IllegalStateException
- SSLContextImplに初期化が必要であり、engineInit()
が呼び出されていない場合- 導入されたバージョン:
- 1.5
- 関連項目:
-
engineCreateSSLEngine
このコンテキストを使用するSSLEngine
を作成します。このファクトリ・メソッドを使用しているアプリケーションは、内部セッションの再利用に関するヒントを提供します。
Kerberosなど、リモート・ホスト名の情報を必要とする暗号化方式群もあります。この場合は、peerHostを指定する必要があります。
- 実装上のノート:
- 返されるSSLEngineが(D)TLS接続にデフォルトでクライアントまたはサーバー・モードを使用する場合、プロバイダ固有です。 JDK SunJSSEプロバイダの実装では、デフォルトでサーバー・モードが使用されます。 ただし、SSLEngineの他のメソッドを呼び出す前に、
SSLEngine.setUseClientMode()
をコールして、常に目的のモードを明示的に設定することをお薦めします。 - パラメータ:
host
- ホストの権限のない名前port
- 権限のないポート- 戻り値:
SSLEngine
オブジェクト- 例外:
IllegalStateException
- SSLContextImplに初期化が必要であり、engineInit()
が呼び出されていない場合- 導入されたバージョン:
- 1.5
- 関連項目:
-
engineGetServerSessionContext
protected abstract SSLSessionContext engineGetServerSessionContext()このコンテキストのSSLSessionContext
サーバー・オブジェクトを返します。- 戻り値:
SSLSessionContext
オブジェクト- 関連項目:
-
engineGetClientSessionContext
protected abstract SSLSessionContext engineGetClientSessionContext()このコンテキストのSSLSessionContext
クライアント・オブジェクトを返します。- 戻り値:
SSLSessionContext
オブジェクト- 関連項目:
-
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
-