クラスHandshakeCompletedEvent

java.lang.Object
java.util.EventObject
javax.net.ssl.HandshakeCompletedEvent
すべての実装されたインタフェース:
Serializable
public class HandshakeCompletedEvent extends EventObject
このイベントは、指定されたSSL接続でSSLのハンドシェークが完了したことを示します。 そのハンドシェイク結果に関するコア情報はすべて、"SSLSession"オブジェクトを介して取得されます。 一部の重要なセッション属性には、このイベント・クラスから直接アクセスできます。

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

導入されたバージョン:
1.4
関連項目:

  • フィールドのサマリー

    クラスで宣言されたフィールド EventObject

    source
    修飾子と型
    フィールド
    説明
    protected Object
    source
    Eventが最初に発生したオブジェクト。

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    String
    getCipherSuite()
    ハンドシェークによって生成されたセッションが使用している暗号化方式群を返します。
    Certificate[]
    getLocalCertificates()
    ハンドシェーク中にピアに送信された証明書を返します。
    Principal
    getLocalPrincipal()
    ハンドシェーク中にピアに送信された主体を返します。
    X509Certificate[]
    getPeerCertificateChain()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    java.security.cert.Certificateの配列を返すgetPeerCertificates()メソッドを代わりに使用する必要があります。
    Certificate[]
    getPeerCertificates()
    セッションを定義するときに設定された、ピアの識別情報を返します。
    Principal
    getPeerPrincipal()
    セッションを定義するときに設定された、ピアの識別情報を返します。
    SSLSession
    getSession()
    このイベントをトリガーしたセッションを返します。
    SSLSocket
    getSocket()
    このイベントのソースとして使用されたソケットを返します。

    クラスで宣言されたメソッド EventObject

    getSource, toString
    修飾子と型
    メソッド
    説明
    Object
    getSource()
    Eventが最初に発生したオブジェクト。
    String
    toString()
    このEventObjectのString表現を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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が返される。
      関連項目:

    • getPeerCertificates

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

      ノート: 戻り値は有効な証明書チェーンでない可能性があり、信頼のディシジョンに頼ってはいけません。

      戻り値:
      ピア証明書の配列。ピア自身の証明書、証明書発行局の順序に並んでいる。
      スロー:
      SSLPeerUnverifiedException - ピアが確認されていない場合。
      関連項目:

    • getPeerCertificateChain

      @Deprecated(since="9", forRemoval=true) public X509Certificate[] getPeerCertificateChain() throws SSLPeerUnverifiedException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      java.security.cert.Certificateの配列を返すgetPeerCertificates()メソッドを代わりに使用する必要があります。
      セッションを定義するときに識別された、ピアの識別情報を返します。 ノート: このメソッドを使用できるのは、証明書ベースの暗号化方式群を使用している場合だけです。Kerberosなどの証明書ベースでない暗号化方式群にこのメソッドを使用すると、SSLPeerUnverifiedExceptionがスローされます。

      ノート: 戻り値は有効な証明書チェーンでない可能性があり、信頼のディシジョンに頼ってはいけません。

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

      戻り値:
      ピアのX.509証明書の配列。ピア自身の証明書、証明書発行局の証明書の順序で並んでいる。 証明書の形式は、元のJSSE X509Certificate形式である。
      スロー:
      SSLPeerUnverifiedException - ピアが確認されていない場合。
      UnsupportedOperationException - 基礎となるプロバイダがSSLSession.getPeerCertificateChain()操作を実装していない場合。
      関連項目:

    • getPeerPrincipal

      public Principal getPeerPrincipal() throws SSLPeerUnverifiedException
      セッションを定義するときに設定された、ピアの識別情報を返します。
      戻り値:
      ピアの主体。 X509ベースの暗号化方式群の場合はエンド・エンティティ証明書のX500Principalを返し、Kerberos暗号化方式群の場合はKerberosPrincipalを返す。
      スロー:
      SSLPeerUnverifiedException - ピアの識別情報が確認されていない場合
      導入されたバージョン:
      1.5
      関連項目:

    • getLocalPrincipal

      public Principal getLocalPrincipal()
      ハンドシェーク中にピアに送信された主体を返します。
      戻り値:
      ピアに送信された主体。 X509ベースの暗号化方式群の場合はエンド・エンティティ証明書のX500Principalを返し、Kerberos暗号化方式群の場合はKerberosPrincipalを返す。 主体が送信されなかった場合はnullが返される。
      導入されたバージョン:
      1.5
      関連項目:

    • getSocket

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