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
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明ハンドシェークによって生成されたセッションが使用している暗号化方式群を返します。ハンドシェーク中にピアに送信された証明書を返します。ハンドシェーク中にピアに送信された主体を返します。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。セッションを定義するときに設定された、ピアの識別情報を返します。セッションを定義するときに設定された、ピアの識別情報を返します。このイベントをトリガーしたセッションを返します。このイベントのソースとして使用されたソケットを返します。クラス java.util.EventObjectで宣言されたメソッド
getSource, toString
-
コンストラクタの詳細
-
HandshakeCompletedEvent
public HandshakeCompletedEvent(SSLSocket sock, SSLSession s)新しいHandshakeCompletedEventを構築します。- パラメータ:
sock
- イベントのソースとして使用されるSSLSockets
- このイベントが関連付けられる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", 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()
-
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()このイベントのソースとして使用されたソケットを返します。 このメソッドを使用すれば、コードを作成するときにアプリケーションから型キャストする必要がありません。- 戻り値:
- 接続が作成されたソケット。
-
java.security.cert.Certificate
の配列を返すgetPeerCertificates()
メソッドを代わりに使用する必要があります。