compact1, compact2, compact3

javax.net.ssl

Class HandshakeCompletedEvent

java.lang.Object

java.util.EventObject

javax.net.ssl.HandshakeCompletedEvent

All Implemented Interfaces:

Serializable

public class HandshakeCompletedEvent
extends EventObject

此事件表明，SSL握手在一个给定的SSL连接完成。所有的核心信息，握手的结果是由“sslsession”对象。作为一个方便，这个事件类提供了直接访问一些重要的会话属性。

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

从以下版本开始：

一点四

另请参见：

SSLSocket， HandshakeCompletedListener， SSLSession， Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
HandshakeCompletedEvent(SSLSocket sock, SSLSession s) 构建了一种新的handshakecompletedevent。

方法摘要

Modifier and Type	Method and Description
String	getCipherSuite() 返回由握手产生的会话使用的密码套件。
Certificate[]	getLocalCertificates() 返回证书（S）在发送给同伴握手。
Principal	getLocalPrincipal() 返回主是在给同伴握手。
X509Certificate[]	getPeerCertificateChain() 返回被确定为定义会话的一部分的对等体的身份。
Certificate[]	getPeerCertificates() 返回作为定义会话定义会话的一部分而建立的对等体的身份。
Principal	getPeerPrincipal() 返回作为定义会话定义会话的一部分而建立的对等体的身份。
SSLSession	getSession() 返回触发此事件的会话。
SSLSocket	getSocket() 返回此事件的源的套接字。

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

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

返回证书（S）在发送给同伴握手。注：此方法仅在使用基于证书的密码套件时是有用的。当多个证书可用于握手时，实现选择它认为“最好的”证书链可用，并将其发送到另一方。此方法允许调用方知道实际使用了哪些证书链。

结果

一个有序数组的证书，与本地证书首先遵循任何证书颁发机构。如果没有发送证书，则返回空值。

另请参见：

getLocalPrincipal()

getPeerCertificates

public Certificate[] getPeerCertificates()
                                  throws SSLPeerUnverifiedException

返回作为定义会话定义会话的一部分而建立的对等体的身份。注：此方法可用于只有当使用基于证书的密码套件；使用基于无证书密码套件，如Kerberos，将抛出一个sslpeerunverifiedexception。

结果

一个有序数组的对等证书，与同行的自己的证书首先遵循任何证书颁发机构。

异常

SSLPeerUnverifiedException如果同伴未验证。

另请参见：

getPeerPrincipal()

getPeerCertificateChain

public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

返回被确定为定义会话的一部分的对等体的身份。注：此方法可用于只有当使用基于证书的密码套件；使用基于无证书密码套件，如Kerberos，将抛出一个sslpeerunverifiedexception。

注：此方法存在于与以前版本的兼容性。新的应用程序应使用getpeercertificates()相反。

结果

同行的X.509证书的有序排列，与同伴的证书首先由任何证书颁发机构。（证书在原JSSE X509Certificate格式）。

异常

SSLPeerUnverifiedException如果同伴未验证。

另请参见：

getPeerPrincipal()

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

返回作为定义会话定义会话的一部分而建立的对等体的身份。

结果

同伴主体。返回最后一个x500principal x509证书的实体基础密码套件，和kerberosprincipal Kerberos密码套件。

异常

SSLPeerUnverifiedException如果同伴的身份尚未证实

从以下版本开始：

一点五

另请参见：

getPeerCertificates()， getLocalPrincipal()

getLocalPrincipal

public Principal getLocalPrincipal()

返回主是在给同伴握手。

结果

校长派到同行。返回一个x500principal为X509端实体的基于证书的密码套件，和kerberosprincipal Kerberos密码套件。如果没有发送主体，则返回空值。

从以下版本开始：

一点五

另请参见：

getLocalCertificates()， getPeerPrincipal()

getSocket

public SSLSocket getSocket()

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

结果

连接上的插座。