模块 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。

      注意：返回的值可能不是有效的证书链，不应依赖于信任决策。

      Note: this method exists for compatibility with previous releases. New applications should use getPeerCertificates() instead.

      返回：
      对等 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()
      返回作为此事件源的套接字。 （这是一个方便的功能，让应用程序无需类型转换即可编写代码。）
      返回：
      建立连接的套接字。