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

См. также:

getLocalPrincipal()

getPeerCertificates

public Certificate[] getPeerCertificates() throws SSLPeerUnverifiedException

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

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

Возвращает:

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

Исключения:

SSLPeerUnverifiedException - если партнёр не проверен.

См. также:

getPeerPrincipal()

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

getPeerPrincipal

public Principal getPeerPrincipal() throws SSLPeerUnverifiedException

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

Возвращает:

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

Исключения:

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

С:

1.5

См. также:

getPeerCertificates()
getLocalPrincipal()

getLocalPrincipal

public Principal getLocalPrincipal()

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

Возвращает:

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

С:

1.5

См. также:

getLocalCertificates()
getPeerPrincipal()

getSocket

public SSLSocket getSocket()

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

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

© 1993, 2021, 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/17/docs/api/java.base/javax/net/ssl/HandshakeCompletedEvent.html