Класс HandshakeCompletedEvent

public class HandshakeCompletedEvent
extends EventObject

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

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

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

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

public X509Certificate[] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException

Возвращает:

упорядоченный массив сертификатов партнёра 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()

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

Возвращает:

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