HandshakeCompletedEvent

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.net.ssl
类 HandshakeCompletedEvent

java.lang.Object
  java.util.EventObject
      javax.net.ssl.HandshakeCompletedEvent

所有已实现的接口：: Serializable

public class HandshakeCompletedEvent
extends EventObject
extends EventObject

此事件指示在给定的 SSL 连接上 SSL 握手结束。所有关于该握手结果的核心信息都通过 "SSLSession" 对象捕获。出于方便的考虑，此事件类提供对一些重要会话属性的直接访问。

此事件的源是在其上刚刚结束握手的 SSLSocket。

从以下版本开始：: 1.4
另请参见：: SSLSocket, HandshakeCompletedListener, SSLSession, 序列化表格

字段摘要

从类 java.util.EventObject 继承的字段
`source`

构造方法摘要
`HandshakeCompletedEvent(SSLSocket sock, SSLSession s)` 构造一个新的 HandshakeCompletedEvent。

方法摘要
`String`	`getCipherSuite()` 返回由握手产生的会话所使用的密码套件。
`Certificate[]`	`getLocalCertificates()` 返回握手期间发送到同位体的证书。
`Principal`	`getLocalPrincipal()` 返回握手期间发送到同位体的主体。
`X509Certificate[]`	`getPeerCertificateChain()` 返回同位体的标识，同位体是作为定义会话的一部分而标识的。
`Certificate[]`	`getPeerCertificates()` 返回同位体的标识，同位体是作为定义会话的一部分而建立的。
`Principal`	`getPeerPrincipal()` 返回同位体的标识，同位体是作为定义会话的一部分而建立的。
`SSLSession`	`getSession()` 返回触发此事件的会话。
`SSLSocket`	`getSocket()` 返回作为此事件源的套接字。

从类 java.util.EventObject 继承的方法
`getSource, toString`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

构造方法详细信息

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

public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

返回同位体的标识，同位体是作为定义会话的一部分而标识的。注：仅当使用基于证书的密码套件时才可以使用此方法；将它与非基于证书的密码套件（如 Kerberos）一起使用将抛出 SSLPeerUnverifiedException。

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

返回：: 同位体 X.509 证书的有序数组，同位体自己的证书在前，后跟所有证书颁发机构。（证书的格式是初始的 JSSE X509Certificate 格式。）
抛出：: SSLPeerUnverifiedException - 如果同位体未经验证。
另请参见：: getPeerPrincipal()

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

返回同位体的标识，同位体是作为定义会话的一部分而建立的。

返回：: 同位体的主体。返回基于 X509 的密码套件的最终实体证书的 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()

返回作为此事件源的套接字。（这是一个方便的功能，使应用程序无需进行强制类型转换即可写入代码。）

返回：: 返回在其上进行连接的套接字。

概述