javax.net.ssl
類別 HandshakeCompletedEvent

java.lang.Object
  java.util.EventObject
      javax.net.ssl.HandshakeCompletedEvent

所有已實作的介面：

Serializable

public class HandshakeCompletedEvent
extends EventObject

此事件指示在給定的 SSL 連接上 SSL 連繫交換結束。所有關於該連繫交換結果的核心資訊都通過 "SSLSession" 物件捕獲。出於方便的考慮，此事件類別提供對一些重要Session屬性的直接存取。

此事件的源是在其上剛剛結束連繫交換的 SSLSocket。

從以下版本開始：

1.4

另請參見：

SSLSocket, HandshakeCompletedListener, SSLSession, 序列化表格

欄位摘要

從類別 java.util.EventObject 繼承的欄位

source

建構子摘要

HandshakeCompletedEvent(SSLSocket sock, SSLSession s)
建構一個新的 HandshakeCompletedEvent。

方法摘要

String	getCipherSuite() 返回由連繫交換產生的Session所使用的密碼套件。
Certificate[]	getLocalCertificates() 返回連繫交換期間發送到同位體的證書。
Principal	getLocalPrincipal() 返回連繫交換期間發送到同位體的主體。
X509Certificate[]	getPeerCertificateChain() 返回同位體的標識，同位體是作為定義Session的一部分而標識的。
Certificate[]	getPeerCertificates() 返回同位體的標識，同位體是作為定義Session的一部分而建立的。
Principal	getPeerPrincipal() 返回同位體的標識，同位體是作為定義Session的一部分而建立的。
SSLSession	getSession() 返回觸發此事件的Session。
SSLSocket	getSocket() 返回作為此事件源的Socket。

從類別 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()

返回觸發此事件的Session。

返回：

此連繫交換的 SSLSession

getCipherSuite

public String getCipherSuite()

返回由連繫交換產生的Session所使用的密碼套件。（這是從 SSLsession 獲取密碼套件的便捷方法。）

返回：

在此Session期間協商的密碼套件名稱。

getLocalCertificates

public Certificate[] getLocalCertificates()

返回連繫交換期間發送到同位體的證書。註：僅當使用基於證書的密碼套件時此方法才有用。 當在一次連繫交換中有多個證書可供使用時，實作選擇它認為是“最好的”可用證書鏈，並把它傳輸到另一方。此方法允許調用者知道實際所使用的證書鏈。

返回：

證書的有序陣列，本地證書在前，後跟所有證書頒發機構。如果沒有發送任何證書，則返回 null。

另請參見：

getLocalPrincipal()

getPeerCertificates

public Certificate[] getPeerCertificates()
                                  throws SSLPeerUnverifiedException

返回同位體的標識，同位體是作為定義Session的一部分而建立的。註：僅當使用基於證書的密碼套件時才可以使用此方法；將它與非基於證書的密碼套件（如 Kerberos）一起使用將拋出 SSLPeerUnverifiedException。

返回：

同位體證書的有序陣列，同位體自己的證書在前，後跟所有證書頒發機構。

拋出：

SSLPeerUnverifiedException - 如果沒有驗證同位體。

另請參見：

getPeerPrincipal()

getPeerCertificateChain

public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

返回同位體的標識，同位體是作為定義Session的一部分而標識的。註：僅當使用基於證書的密碼套件時才可以使用此方法；將它與非基於證書的密碼套件（如 Kerberos）一起使用將拋出 SSLPeerUnverifiedException。

註：此方法存在是為了和以前的版本相容。新的應用程序應該使用 getPeerCertificates()。

返回：

同位體 X.509 證書的有序陣列，同位體自己的證書在前，後跟所有證書頒發機構。（證書的格式是初始的 JSSE X509Certificate 格式。）

拋出：

SSLPeerUnverifiedException - 如果同位體未經驗證。

另請參見：

getPeerPrincipal()

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

返回同位體的標識，同位體是作為定義Session的一部分而建立的。

返回：

同位體的主體。返回基於 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()

返回作為此事件源的Socket。（這是一個方便的功能，使應用程序無需進行強制型別轉換即可寫入程式碼。）

返回：

返回在其上進行連接的Socket。