javax.net.ssl
클래스 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 () 핸드 쉐이크에 의해 생성된 세션이 사용하고 있는 encode 방식을 리턴합니다.
Certificate []	getLocalCertificates () 핸드 쉐이크중에 피어에 송신된 인증서를 리턴합니다.
Principal	getLocalPrincipal () 핸드 쉐이크중에 피어에 송신된 주체를 리턴합니다.
X509Certificate []	getPeerCertificateChain () 세션을 정의할 경우에 식별된, 피어의 식별 정보를 리턴합니다.
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()

핸드 쉐이크에 의해 생성된 세션이 사용하고 있는 encode 방식을 리턴합니다. 이 메서드는 SSLSession 로부터 encode 방식을 취득할 경우에 사용합니다.

반환값:

이 세션중에 네고시에이션을 한 encode 방식의 이름

getLocalCertificates

public Certificate [] getLocalCertificates()

핸드 쉐이크중에 피어에 송신된 인증서를 리턴합니다. 주: 이 메서드가 도움이 되는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. 핸드 쉐이크를 실시할 때 복수의 인증서를 사용할 수 있는 경우는 최적인 인증서 체인이 선택되어 피어에 송신됩니다. 호출측은 이 메서드를 사용해, 실제로 사용된 인증서 체인을 파악할 수 있습니다 .

반환값:

인증서 의 배열. 로컬 인증서, 인증서 발행국의 순서에 줄지어 있다. 인증서가 송신되지 않았던 경우는 null이 리턴된

관련 항목:

getLocalPrincipal()

getPeerCertificates

public Certificate [] getPeerCertificates()
                                  throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다. 주: 이 메서드를 사용할 수 있는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. Kerberos 등의 인증서 베이스가 아닌 encode 방식으로 이 메서드를 사용하면, SSLPeerUnverifiedException가 발생 됩니다.

반환값:

피어 인증서 의 배열. 피어 자신의 인증서, 인증서 발행국의 순서에 줄지어 있다

예외:

SSLPeerUnverifiedException - 피어가 확인되지 않았던 경우

관련 항목:

getPeerPrincipal()

getPeerCertificateChain

public X509Certificate [] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException 

세션을 정의할 경우에 식별된, 피어의 식별 정보를 리턴합니다. 주: 이 메서드를 사용할 수 있는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. Kerberos 등의 인증서 베이스가 아닌 encode 방식으로 이 메서드를 사용하면, SSLPeerUnverifiedException가 발생 됩니다.

주: 이 메서드는 이전의 릴리즈와 의 호환성을 확보하기 위해서 삽입되어 있습니다. 새로운 어플리케이션에서는 getPeerCertificates()를 사용해 주세요.

반환값:

피어의 X. 509 인증서 의 배열. 피어 자신의 인증서, 인증서 발행국의 순서로 나란해지고 있다. 인증서 의 형식은 원의 JSSE X509Certificate 형식이다

예외:

SSLPeerUnverifiedException - 피어가 확인되지 않았던 경우

관련 항목:

getPeerPrincipal()

getPeerPrincipal

public Principal  getPeerPrincipal()
                           throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 리턴합니다.

반환값:

피어의 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다

예외:

SSLPeerUnverifiedException - 피어의 식별 정보를 확인할 수 없었던 경우

도입된 버전 :

1.5

관련 항목:

getPeerCertificates(), getLocalPrincipal()

getLocalPrincipal

public Principal  getLocalPrincipal()

핸드 쉐이크중에 피어에 송신된 주체를 리턴합니다.

반환값:

피어에 송신된 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다. 주체가 송신되지 않았던 경우는 null을 돌려주는

도입된 버전 :

1.5

관련 항목:

getLocalCertificates(), getPeerPrincipal()

getSocket

public SSLSocket  getSocket()

이 이벤트의 소스로서 사용된 소켓을 리턴합니다. 이 메서드를 사용하면, 코드를 작성할 경우에 어플리케이션으로부터 형태 캐스트 할 필요가 없습니다.

반환값:

접속이 작성된 소켓