Класс HandshakeCompletedEvent

java.lang.Object
- java.util.EventObject
- - javax.net.ssl.HandshakeCompletedEvent

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

public class HandshakeCompletedEvent
extends EventObject

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

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

С:: 1.4
См. также:: SSLSocket, HandshakeCompletedListener, SSLSession, Сериализованная форма

Поля

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

source

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

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

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

Модификатор и тип	Метод	Описание
`String`	`getCipherSuite()`	Возвращает набор шифров, используемый сессией, созданной в результате рукопожатия.
`Certificate[]`	`getLocalCertificates()`	Возвращает сертификат(ы), отправленные партнеру во время рукопожатия.
`Principal`	`getLocalPrincipal()`	Возвращает субъекта, отправленного партнеру во время рукопожатия.
`X509Certificate[]`	`getPeerCertificateChain()`	Устарело. Вместо этого следует использовать метод `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()

Возвращает сессию, которая спровоцировала это событие.

Возвращает:: сессию для данного рукопожатия

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")
public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

Устарело.

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

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

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

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

Возвращает:: упорядоченный массив X.509-сертификатов партнера, где сначала сертификат партнера, а затем все сертификаты центров сертификации. (Сертификаты в формате JSSE X509Certificate).
Исключения:: SSLPeerUnverifiedException - если партнер не верифицирован.
См. также:: 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()

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

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