モジュール java.base
パッケージ 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
関連項目:
  • コンストラクタの詳細

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