compact1, compact2, compact3

javax.net.ssl

クラスHandshakeCompletedEvent

java.lang.Object

java.util.EventObject

javax.net.ssl.HandshakeCompletedEvent

すべての実装されたインタフェース:

Serializable

public class HandshakeCompletedEvent
extends EventObject

このイベントは、指定されたSSL接続でSSLのハンドシェークが完了したことを示します。ハンドシェークの結果に関する主要な情報は、すべてSSLSessionオブジェクトを介して取り込まれます。一部の重要なセッション属性には、このイベント・クラスから直接アクセスできます。

このイベントのソースは、ハンドシェークが完了した最新のSSLSocketです。

導入されたバージョン:

1.4

関連項目:

SSLSocket, HandshakeCompletedListener, SSLSession, 直列化された形式

フィールドのサマリー

クラス java.util.EventObjectから継承されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
HandshakeCompletedEvent(SSLSocket sock, SSLSession s) 新しいHandshakeCompletedEventを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
String	getCipherSuite() ハンドシェークによって生成されたセッションが使用している暗号化方式群を返します。
Certificate[]	getLocalCertificates() ハンドシェーク中にピアに送信された証明書を返します。
Principal	getLocalPrincipal() ハンドシェーク中にピアに送信された主体を返します。
X509Certificate[]	getPeerCertificateChain() セッションを定義するときに識別された、ピアの識別情報を返します。
Certificate[]	getPeerCertificates() セッションを定義するときに設定された、ピアの識別情報を返します。
Principal	getPeerPrincipal() セッションを定義するときに設定された、ピアの識別情報を返します。
SSLSession	getSession() このイベントをトリガーしたセッションを返します。
SSLSocket	getSocket() このイベントのソースとして使用されたソケットを返します。

クラス java.util.EventObjectから継承されたメソッド

getSource, toString

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

HandshakeCompletedEvent

public HandshakeCompletedEvent(SSLSocket sock,
                               SSLSession s)

新しいHandshakeCompletedEventを構築します。

パラメータ:

sock - イベントのソースとして使用されるSSLSocket

s - このイベントが関連付けられるSSLSession

メソッドの詳細

getSession

public SSLSession getSession()

このイベントをトリガーしたセッションを返します。

戻り値:

このハンドシェークのSSLSession

getCipherSuite

public String getCipherSuite()

ハンドシェークによって生成されたセッションが使用している暗号化方式群を返します。このメソッドは、SSLSessionから暗号化方式群を取得するときに使用します。

戻り値:

このセッション中にネゴシエーションが行われた暗号化方式群の名前。

getLocalCertificates

public Certificate[] getLocalCertificates()

ハンドシェーク中にピアに送信された証明書を返します。注: このメソッドが役立つのは、証明書ベースの暗号化方式群を使用している場合だけです。ハンドシェークを行うときに複数の証明書を使用できる場合は、最適な証明書チェーンが選択され、ピアに送信されます。呼出し側は、このメソッドを使用して、実際に使用された証明書チェーンを把握することができます。

戻り値:

証明書の配列。ローカル証明書、証明書発行局の証明書の順序に並んでいる。証明書が送信されなかった場合は、nullが返される。

関連項目:

getLocalPrincipal()

getPeerCertificates

public Certificate[] getPeerCertificates()
                                  throws SSLPeerUnverifiedException

セッションを定義するときに設定された、ピアの識別情報を返します。注: このメソッドを使用できるのは、証明書ベースの暗号化方式群を使用している場合だけです。Kerberosなどの証明書ベースでない暗号化方式群にこのメソッドを使用すると、SSLPeerUnverifiedExceptionがスローされます。

戻り値:

ピア証明書の配列。ピア自身の証明書、証明書発行局の順序に並んでいる。

例外:

SSLPeerUnverifiedException - ピアが確認されていない場合。

関連項目:

getPeerPrincipal()

getPeerCertificateChain

public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

セッションを定義するときに識別された、ピアの識別情報を返します。注: このメソッドを使用できるのは、証明書ベースの暗号化方式群を使用している場合だけです。Kerberosなどの証明書ベースでない暗号化方式群にこのメソッドを使用すると、SSLPeerUnverifiedExceptionがスローされます。

注: このメソッドは、以前のリリースとの互換性を確保するために組み込まれています。新しいアプリケーションでは、代わりにgetPeerCertificates()を使用するようにしてください。

戻り値:

ピアのX.509証明書の配列。ピア自身の証明書、証明書発行局の証明書の順序で並んでいる。証明書の形式は、元のJSSE X509Certificate形式である。

例外:

SSLPeerUnverifiedException - ピアが確認されていない場合。

関連項目:

getPeerPrincipal()

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

セッションを定義するときに設定された、ピアの識別情報を返します。

戻り値:

ピアの主体。X509ベースの暗号化方式群の場合はエンド・エンティティ証明書のX500Principalを返し、Kerberos暗号化方式群の場合はKerberosPrincipalを返す。

例外:

SSLPeerUnverifiedException - ピアの識別情報が確認されていない場合

導入されたバージョン:

1.5

関連項目:

getPeerCertificates(), getLocalPrincipal()

getLocalPrincipal

public Principal getLocalPrincipal()

ハンドシェーク中にピアに送信された主体を返します。

戻り値:

ピアに送信された主体。X509ベースの暗号化方式群の場合はエンド・エンティティ証明書のX500Principalを返し、Kerberos暗号化方式群の場合はKerberosPrincipalを返す。主体が送信されなかった場合はnullが返される。

導入されたバージョン:

1.5

関連項目:

getLocalCertificates(), getPeerPrincipal()

getSocket

public SSLSocket getSocket()

このイベントのソースとして使用されたソケットを返します。このメソッドを使用すれば、コードを作成するときにアプリケーションから型キャストする必要がありません。

戻り値:

接続が作成されたソケット。