Интерфейс SSLSessionContext

public interface SSLSessionContext

Объект SSLSessionContext представляет набор SSLSession, связанных с одним объектом. Например, он может быть связан с сервером или клиентом, участвующим во многих сессиях одновременно.

Не все среды содержат контексты сессий.

Существуют SSLSessionContext параметры, которые влияют на то, как хранятся сессии:

• Сессии могут быть настроены на истечение срока действия после определенного времени.
• Можно ограничить количество сессий, которые могут быть сохранены в контексте.

Сессию можно получить по её идентификатору, и все идентификаторы сессий в SSLSessionContext можно перечислить.

Методы

getSession

SSLSession getSession(byte[] sessionId)

Возвращает SSLSession, связанную с указанным идентификатором сессии.

Параметры:

sessionId - идентификатор сессии

Возвращает:

объект SSLSession или null, если указанный идентификатор сессии не относится к валидной SSLSession.

Исключение:

NullPointerException - если sessionId равно null.

getIds

Enumeration<byte[]> getIds()

Возвращает перечисление всех идентификаторов сессий, сгруппированных под данным SSLSessionContext.

Возвращает:

перечисление всех идентификаторов сессий

setSessionTimeout

void setSessionTimeout(int seconds)
                throws IllegalArgumentException

Примечание API:

Обратите внимание, что реализация JDK использует значения по умолчанию для размера кэша сессий и таймаута. Подробнее см. getSessionCacheSize и getSessionTimeout. Приложения должны учитывать свои требования к производительности и переопределять значения по умолчанию при необходимости.

Параметры:

seconds - новый предел времени ожидания сессии в секундах; ноль означает отсутствие ограничения.

Исключение:

IllegalArgumentException - если указанный таймаут < 0.

См. также:

getSessionTimeout()

getSessionTimeout

int getSessionTimeout()

Примечание реализации:

Реализация JDK возвращает таймаут сессии, установленный методом setSessionTimeout или, если не установлен, значение по умолчанию в 86400 секунд (24 часа).

Возвращает:

предел времени ожидания сессии в секундах; ноль означает отсутствие ограничения.

См. также:

setSessionTimeout(int)

setSessionCacheSize

void setSessionCacheSize(int size)
                  throws IllegalArgumentException

Устанавливает размер кэша, используемого для хранения SSLSession объектов, сгруппированных под данным SSLSessionContext.

Примечание API:

Обратите внимание, что реализация JDK использует значения по умолчанию для размера кэша сессий и таймаута. Подробнее см. getSessionCacheSize и getSessionTimeout. Приложения должны учитывать свои требования к производительности и переопределять значения по умолчанию при необходимости.

Параметры:

size - новый предел размера кэша сессий; ноль означает отсутствие ограничения.

Исключение:

IllegalArgumentException - если указанный размер < 0.

См. также:

getSessionCacheSize()

getSessionCacheSize

int getSessionCacheSize()

Возвращает размер кэша, используемого для хранения SSLSession объектов, сгруппированных под данным SSLSessionContext.

Примечание реализации:

Реализация JDK возвращает размер кэша, установленный методом setSessionCacheSize или, если не установлен, значение из системной переменной. Если ни то, ни другое не установлено, возвращается значение по умолчанию 20480.

Возвращает:

размер кэша сессий; ноль означает отсутствие ограничения.

См. также:

setSessionCacheSize(int)