Класс 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

Модификатор и тип	Поле	Описание
`protected Object`	`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`	`getSource()`	Объект, на котором первоначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

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

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

Возвращает:

субъект узла-собеседника. Для наборов шифров на основе X509 возвращается X500Principal сертификата конечного субъекта, а для наборов шифров Kerberos — KerberosPrincipal.

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

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

Начиная с:

1.5

См. также:

getLocalPrincipal

public Principal getLocalPrincipal()

Возвращает субъект, отправленный узлу-собеседнику во время рукопожатия.

Возвращает:

субъект, отправленный узлу-собеседнику. Для наборов шифров на основе X509 возвращается X500Principal сертификата конечного субъекта, а для наборов шифров Kerberos — KerberosPrincipal. Если субъект не отправлялся, возвращается 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.