构造方法详细信息

• 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。

  另请参见：

  getLocalPrincipal()

• getPeerCertificates

  public Certificate[] getPeerCertificates()
                                    throws SSLPeerUnverifiedException

  返回作为定义会话的一部分而建立的对等方的标识。 注意：此方法仅在使用基于证书的密码套件时使用; 将它与非基于证书的密码套件（如Kerberos）一起使用会抛出SSLPeerUnverifiedException。

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

  结果

  对等证书的有序数组，首先是对等方自己的证书，然后是任何证书颁发机构。

  异常

  SSLPeerUnverifiedException - 如果未验证对等方。

  另请参见：

  getPeerPrincipal()

• getPeerCertificateChain

  @Deprecated(since="9")
  public X509Certificate[] getPeerCertificateChain()
                                            throws SSLPeerUnverifiedException

  Deprecated.

  The getPeerCertificates() method that returns an array of java.security.cert.Certificate should be used instead.
  返回标识为定义会话一部分的对等方的标识。 注意：此方法仅在使用基于证书的密码套件时使用; 将它与非基于证书的密码套件（如Kerberos）一起使用会抛出SSLPeerUnverifiedException。

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

  注意：此方法的存在是为了与先前版本兼容。 新应用程序应使用getPeerCertificates() 。

  结果

  一个有序的对等X.509证书数组，首先是对等方自己的证书，然后是任何证书颁发机构。 （证书采用原始JSSE X509Certificate格式）。

  异常

  SSLPeerUnverifiedException - 如果未验证对等方。

  另请参见：

  getPeerPrincipal()

• getPeerPrincipal

  public Principal getPeerPrincipal()
                             throws SSLPeerUnverifiedException

  返回作为定义会话的一部分而建立的对等方的标识。

  结果

  同行的校长。 返回基于X509的密码套件的终端实体certiticate的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()

  返回作为此事件源的套接字。 （这是一个便利功能，让应用程序编写没有类型转换的代码。）

  结果

  连接的套接字。