Класс 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, 2023, 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/21/docs/api/java.base/javax/net/ssl/HandshakeCompletedEvent.html