Класс HandshakeCompletedEvent

java.lang.Object

java.util.EventObject

javax.net.ssl.HandshakeCompletedEvent

Все реализуемые интерфейсы:: Serializable

public class HandshakeCompletedEvent extends EventObject

Это событие указывает, что рукопожатие SSL завершилось для данного SSL-соединения. Вся основная информация о результате этого рукопожатия содержится в объекте «SSLSession». Для удобства этот класс события предоставляет прямой доступ к некоторым важным атрибутам сеанса.

Источником этого события является SSLSocket, на котором только что завершилось рукопожатие.

С версии:

1.4

См. также:

Краткое описание полей

Поля, объявленные в классе EventObject

source

Краткое описание конструкторов

Конструктор	Описание
`HandshakeCompletedEvent(SSLSocket sock, SSLSession s)`	Создает новый HandshakeCompletedEvent.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getCipherSuite()`	Возвращает набор шифров, используемый сеансом, созданным в результате рукопожатия.
`Certificate[]`	`getLocalCertificates()`	Возвращает сертификат или сертификаты, отправленные узлу во время рукопожатия.
`Principal`	`getLocalPrincipal()`	Возвращает принципал, отправленный узлу во время рукопожатия.
`X509Certificate[]`	`getPeerCertificateChain()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Вместо него следует использовать метод `getPeerCertificates()`, возвращающий массив `java.security.cert.Certificate`.
`Certificate[]`	`getPeerCertificates()`	Возвращает идентификатор узла, установленный при создании сеанса.
`Principal`	`getPeerPrincipal()`	Возвращает идентификатор узла, установленный при создании сеанса.
`SSLSession`	`getSession()`	Возвращает сеанс, вызвавший это событие.
`SSLSocket`	`getSocket()`	Возвращает сокет, являющийся источником этого события.

Методы, объявленные в классе EventObject

getSource, toString

Методы, объявленные в классе 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.

См. также:

getPeerCertificates

public Certificate[] getPeerCertificates() throws SSLPeerUnverifiedException

Возвращает идентификатор узла, установленный при создании сеанса. Примечание: этот метод можно использовать только с наборами шифров на основе сертификатов; его использование с наборами шифров, не основанными на сертификатах, например Kerberos, приведет к выбросу SSLPeerUnverifiedException.

Примечание: возвращаемое значение может не быть допустимой цепочкой сертификатов, поэтому на него не следует полагаться при принятии решений о доверии.

Возвращает:

упорядоченный массив сертификатов узла: сначала собственный сертификат узла, затем все центры сертификации.

Выбрасывает:

SSLPeerUnverifiedException — если узел не проверен.

См. также:

getPeerCertificateChain

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

Устарело, будет удалено: этот элемент API может быть удален в будущей версии.

Вместо него следует использовать метод getPeerCertificates(), возвращающий массив java.security.cert.Certificate.

Примечание: этот метод существует для обеспечения совместимости с предыдущими выпусками. В новых приложениях следует использовать вместо него getPeerCertificates().

Возвращает:

упорядоченный массив сертификатов узла X.509: сначала собственный сертификат узла, затем все центры сертификации. (Сертификаты представлены в исходном формате JSSE X509Certificate).

Выбрасывает:

SSLPeerUnverifiedException — если узел не проверен.

UnsupportedOperationException — если базовый поставщик не реализует операцию SSLSession.getPeerCertificateChain().

См. также:

getPeerPrincipal

public Principal getPeerPrincipal() throws SSLPeerUnverifiedException

Возвращает идентификатор узла, установленный при создании сеанса.

Возвращает:

принципал узла. Возвращает X500Principal сертификата конечного субъекта для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos.

Выбрасывает:

SSLPeerUnverifiedException — если идентификатор узла не был проверен

С версии:

1.5

См. также:

getLocalPrincipal

public Principal getLocalPrincipal()

Возвращает принципал, отправленный узлу во время рукопожатия.

Возвращает:

принципал, отправленный узлу. Возвращает X500Principal сертификата конечного субъекта для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos. Если принципал не отправлялся, возвращается null.

С версии:

1.5

См. также:

getSocket

public SSLSocket getSocket()

Возвращает сокет, являющийся источником этого события. (Это вспомогательная функция, позволяющая приложениям писать код без приведения типов.)

Возвращает:: сокет, через который было установлено соединение.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/net/ssl/HandshakeCompletedEvent.html