javax.net.ssl
인터페이스 SSLSessionContext

public interface SSLSessionContext

SSLSessionContext는 특정의 엔티티와 관련된 일련의 SSLSession을 나타냅니다. 예를 들어 동시에 복수의 세션에 참가하고 있는 서버 또는 클라이언트를, 특정의 엔티티에 관련지을 수가 있습니다.

세션 컨텍스트은 일부의 환경에서는 사용할 수 없습니다.

SSLSessionContext 파라미터를 사용하면, 세션의 포함 방법을 제어할 수 있습니다.

• 지정된 제한 시간이 경과하면, 세션을 무효로 할 수 있다
• 컨텍스트에 포함할 수 있는 세션의 수를 제한할 수 있다

세션은 세션 ID에 근거해 꺼낼 수가 있습니다. SSLSessionContext 내의 세션 ID는 일람표시 할 수 있습니다.

도입된 버전 :

1.4

관련 항목:

SSLSession

메서드 개요

Enumeration	getIds () 이 SSLSessionContext에 그룹화 떠날 수 있어 모든 세션 ID 열거를 리턴합니다.
SSLSession	getSession (byte[] sessionId) 특정의 세션 ID에 바인드 되고 있는 SSLSession을 리턴합니다.
int	getSessionCacheSize () 이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 포함에 사용되는 캐쉬의 사이즈를 리턴합니다.
int	getSessionTimeout () 이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 타임 아웃 제한을 리턴합니다.
void	setSessionCacheSize (int size) 이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 포함에 사용되는 캐쉬의 사이즈를 설정합니다.
void	setSessionTimeout (int seconds) 이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 타임 아웃 제한을 설정합니다.

메서드의 상세

getSession

SSLSession  getSession(byte[] sessionId)

특정의 세션 ID에 바인드 되고 있는 SSLSession을 리턴합니다.

파라미터:

sessionId - 세션 식별자

반환값:

SSLSession. 지정된 세션 ID가 유효한 SSLSession를 가리키지 않은 경우는 null

getIds

Enumeration  getIds()

이 SSLSessionContext에 그룹화 떠날 수 있어 모든 세션 ID 열거를 리턴합니다.

반환값:

모든 세션 ID 열거

setSessionTimeout

void setSessionTimeout(int seconds)
                       throws IllegalArgumentException 

이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 타임 아웃 제한을 설정합니다.

타임 아웃 제한이 t 초로 설정되어 있는 경우, 작성 시각부터 t 초경과한 세션은 타임 아웃 제한을 넘습니다. 세션이 타임 아웃 제한을 넘으면, SSLSession객체는 무효가 되어, 후속의 접속에서는 그 세션을 재개 또는 참가할 수 없습니다. SSLSessionContext 타임 아웃 제한을 변경하면, 타임 아웃을 넘은 세션의 확인이 즉시 행해집니다.

파라미터:

seconds - 새로운 타임 아웃 제한 (초단위). 제로는 제한 없음

예외:

IllegalArgumentException - 지정된 타임 아웃 제한이 0 보다 작은 경우

관련 항목:

getSessionTimeout()

getSessionTimeout

int getSessionTimeout()

이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 타임 아웃 제한을 리턴합니다.

타임 아웃 제한이 t 초로 설정되어 있는 경우, 작성 시각부터 t 초경과한 세션은 타임 아웃 제한을 넘습니다. 세션이 타임 아웃 제한을 넘으면, SSLSession객체는 무효가 되어, 후속의 접속에서는 그 세션을 재개 또는 참가할 수 없습니다. SSLSessionContext 타임 아웃 제한을 변경하면, 타임 아웃 제한을 넘은 세션의 확인이 즉시 행해집니다.

반환값:

타임 아웃 제한 (초단위). 제로는 제한 없음

관련 항목:

setSessionTimeout(int)

setSessionCacheSize

void setSessionCacheSize(int size)
                         throws IllegalArgumentException 

이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 포함에 사용되는 캐쉬의 사이즈를 설정합니다.

파라미터:

size - 세션 캐쉬의 새로운 사이즈 제한. 제로는 제한 없음

예외:

IllegalArgumentException - 지정된 사이즈가 0 보다 작은 경우

관련 항목:

getSessionCacheSize()

getSessionCacheSize

int getSessionCacheSize()

이 SSLSessionContext에 그룹화 되고 있는 SSLSession 객체의 포함에 사용되는 캐쉬의 사이즈를 리턴합니다.

반환값:

세션 캐쉬의 사이즈. 제로는 제한 없음

관련 항목:

setSessionCacheSize(int)