Интерфейс SSLSessionContext

public interface SSLSessionContext

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

Не все среды будут содержать контексты сессий. Например, бесследовая возобновляемость сессий.

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

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

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

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

Since:

1.4

See Also:

Краткое описание методов

Модификатор и тип	Метод	Описание
`Enumeration<byte[]>`	`getIds()`	Возвращает перечисление всех известных идентификаторов сессий, сгруппированных под данным `SSLSessionContext`.
`SSLSession`	`getSession(byte[] sessionId)`	Возвращает `SSLSession`, привязанную к указанному идентификатору сессии.
`int`	`getSessionCacheSize()`	Возвращает размер кэша, используемого для хранения `SSLSession` объектов, сгруппированных под данным `SSLSessionContext`.
`int`	`getSessionTimeout()`	Возвращает предел времени ожидания `SSLSession` объектов, сгруппированных под данным `SSLSessionContext`.
`void`	`setSessionCacheSize(int size)`	Устанавливает размер кэша, используемого для хранения `SSLSession` объектов, сгруппированных под данным `SSLSessionContext`.
`void`	`setSessionTimeout(int seconds)`	Устанавливает предел времени ожидания для `SSLSession` объектов, сгруппированных под данным `SSLSessionContext`.

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

getSession

SSLSession getSession(byte[] sessionId)

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

Parameters:: sessionId - идентификатор сессии
Returns:: SSLSession или null, если указанный идентификатор сессии не ссылается на действительную SSLSession.
Throws:: NullPointerException - если sessionId равно null.

getIds

Enumeration<byte[]> getIds()

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

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

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

setSessionTimeout

void setSessionTimeout(int seconds)

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

Если предел времени ожидания установлен в 't' секунд, сессия превышает предел времени ожидания 't' секунд после ее создания. Когда время ожидания сессии истекает, объект SSLSession становится недействительным, и будущие подключения не могут возобновить или присоединиться к сессии. Проверка сессий, превысивших время ожидания, выполняется немедленно всякий раз, когда предел времени ожидания изменяется для данного SSLSessionContext.

API Note:

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

Parameters:

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

Throws:

IllegalArgumentException - если указанное время ожидания < 0.

See Also:

getSessionTimeout

int getSessionTimeout()

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

Implementation Note:

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

Returns:

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

See Also:

setSessionCacheSize

void setSessionCacheSize(int size)

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

API Note:

Parameters:

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

Throws:

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

See Also:

getSessionCacheSize

int getSessionCacheSize()

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

Implementation Note:

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

Returns:

размер кэша сессий; ноль означает, что предела по размеру нет.

See Also:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/javax/net/ssl/SSLSessionContext.html