Класс HandshakeCompletedEvent

java.lang.Object

java.util.EventObject

javax.net.ssl.HandshakeCompletedEvent

Все реализованные интерфейсы:: Serializable

public class HandshakeCompletedEvent extends EventObject

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

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

С тех пор:

1.4

См. также:

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

Поля, объявленные в классе java.util.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()`	Возвращает сокет, являющийся источником этого события.

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

См. также:

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.

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

Примечание: этот метод существует для совместимости с предыдущими выпусками. Новые приложения должны использовать 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://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/net/ssl/HandshakeCompletedEvent.html