モジュール java.base
パッケージ javax.net.ssl

クラスHandshakeCompletedEvent

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

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

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

    導入されたバージョン:
    1.4
    関連項目:
    SSLSocket, HandshakeCompletedListener, SSLSession, 直列化された形式

    • コンストラクタの詳細

      • 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

        @Deprecated(since="9")
public X509Certificate[] getPeerCertificateChain​()
                                          throws SSLPeerUnverifiedException
        非推奨。 代わりに、java.security.cert.Certificateの配列を返すgetPeerCertificates()メソッドを使用する必要があります。
        セッションを定義するときに識別された、ピアの識別情報を返します。 注: このメソッドを使用できるのは、証明書ベースの暗号化方式群を使用している場合だけです。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​()
        このイベントのソースとして使用されたソケットを返します。 このメソッドを使用すれば、コードを作成するときにアプリケーションから型キャストする必要がありません。
        戻り値:
        接続が作成されたソケット。