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()
          このコンテキストの 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。