模块  java.base
软件包  javax.net.ssl

Class HandshakeCompletedEvent

  • 实现的所有接口
    Serializable

    public class HandshakeCompletedEventextends EventObject
    此事件表示在给定的SSL连接上完成了SSL握手。 有关该握手结果的所有核心信息都是通过“SSLSession”对象捕获的。 为方便起见,此事件类提供对某些重要会话属性的直接访问。

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

    从以下版本开始:
    1.4
    另请参见:
    SSLSocketHandshakeCompletedListenerSSLSessionSerialized Form
    • 构造方法详细信息

      • 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()
      • getLocalPrincipal

        public Principal getLocalPrincipal()
        返回握手期间发送给对等方的主体。
        结果
        校长寄给同伴。 返回基于X509的密码套件的终端实体证书的X500Principal,以及Kerberos密码套件的KerberosPrincipal。 如果没有发送主体,则返回null。
        从以下版本开始:
        1.5
        另请参见:
        getLocalCertificates()getPeerPrincipal()
      • getSocket

        public SSLSocket getSocket()
        返回作为此事件源的套接字。 (这是一个便利功能,让应用程序编写没有类型转换的代码。)
        结果
        连接的套接字。