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 () 핸드 쉐이크에 의해 생성된 세션이 사용하고 있는 암호화 방식군을 돌려줍니다.
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()

핸드 쉐이크에 의해 생성된 세션이 사용하고 있는 암호화 방식군을 돌려줍니다. 이 메소드는, SSLSession 로부터 암호화 방식군을 취득할 경우에 사용합니다.

반환값:

이 세션중에 협상을 한 암호화 방식군의 이름

getLocalCertificates

public Certificate [] getLocalCertificates()

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

반환값:

증명서의 배열. 로컬 증명서, 증명서 발행국의 순서에 줄지어 있다. 증명서가 송신되지 않았던 경우는, null 가 반환되는

관련 항목:

getLocalPrincipal()

getPeerCertificates

public Certificate [] getPeerCertificates()
                                  throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 돌려줍니다. 주:이 메소드를 사용할 수 있는 것은, 증명서 베이스의 암호화 방식군을 사용하고 있는 경우만입니다. Kerberos 등의 증명서 베이스가 아닌 암호화 방식군에게 이 메소드를 사용하면(자), SSLPeerUnverifiedException 가 throw 됩니다.

반환값:

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

예외:

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

관련 항목:

getPeerPrincipal()

getPeerCertificateChain

public X509Certificate [] getPeerCertificateChain()
                                          throws SSLPeerUnverifiedException 

세션을 정의할 경우에 식별된, 피어의 식별 정보를 돌려줍니다. 주:이 메소드를 사용할 수 있는 것은, 증명서 베이스의 암호화 방식군을 사용하고 있는 경우만입니다. Kerberos 등의 증명서 베이스가 아닌 암호화 방식군에게 이 메소드를 사용하면(자), SSLPeerUnverifiedException 가 throw 됩니다.

주:이 메소드는, 이전의 릴리스와의 호환성을 확보하기 위해서 짜넣어지고 있습니다. 새로운 어플리케이션에서는,getPeerCertificates() 를 사용해 주세요.

반환값:

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

예외:

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

관련 항목:

getPeerPrincipal()

getPeerPrincipal

public Principal  getPeerPrincipal()
                           throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 피어의 식별 정보를 돌려줍니다.

반환값:

피어의 주체. X509 베이스의 암호화 방식군의 경우는 엔드엔티티 증명서의 X500Principal 를 돌려주어, Kerberos 암호화 방식군의 경우는 KerberosPrincipal 를 돌려준다.

예외:

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

도입된 버젼:

1.5

관련 항목:

getPeerCertificates() , getLocalPrincipal()

getLocalPrincipal

public Principal  getLocalPrincipal()

핸드 쉐이크중에 피어에 송신된 주체를 돌려줍니다.

반환값:

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

도입된 버젼:

1.5

관련 항목:

getLocalCertificates() , getPeerPrincipal()

getSocket

public SSLSocket  getSocket()

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

반환값:

접속이 작성된 소켓