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

Class HandshakeCompletedEvent

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

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

    从以下版本开始：
    1.4
    另请参见：
    SSLSocket ， HandshakeCompletedListener ， SSLSession ， Serialized 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()
        返回作为此事件源的套接字。 （这是一个便利功能，让应用程序编写没有类型转换的代码。）
        结果
        连接的套接字。