Module java.base
Package javax.net.ssl

Class HandshakeCompletedEvent

java.lang.Object
java.util.EventObject
javax.net.ssl.HandshakeCompletedEvent
所有已实现的接口:
Serializable
public class HandshakeCompletedEvent extends EventObject
此事件指示在给定的SSL连接上完成了SSL握手。关于该握手结果的所有核心信息都通过一个"SSLSession"对象捕获。作为便利，此事件类提供了对一些重要会话属性的直接访问。

此事件的来源是刚刚完成握手的SSLSocket。

自:
1.4
参见:

  • Constructor Details

    • HandshakeCompletedEvent

      public HandshakeCompletedEvent(SSLSocket sock, SSLSession s)
      构造一个新的HandshakeCompletedEvent。
      参数:
      sock - 充当事件来源的SSLSocket
      s - 与此事件关联的SSLSession

  • Method Details

    • 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
      Deprecated, for removal: This API element is subject to removal in a future version.
      The getPeerCertificates() method that returns an array of java.security.cert.Certificate should be used instead.
      返回作为定义会话的一部分建立的对等方的身份。注意: 仅在使用基于证书的密码套件时，才能使用此方法；在非基于证书的密码套件（如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()
      返回此事件的来源的套接字。(这是一个方便的函数，让应用程序编写代码时无需进行类型转换。)
      返回:
      进行连接的套接字。