javax.net.ssl: public interface: SSLSessionContext

javax.net.ssl
public interface: SSLSessionContext [javadoc | source] A SSLSessionContext represents a set of SSLSessions associated with a single entity. For example, it could be associated with a server or client who participates in many sessions concurrently.

Not all environments will contain session contexts.

There are SSLSessionContext parameters that affect how sessions are stored:

Sessions can be set to expire after a specified time limit.
The number of sessions that can be stored in context can be limited.

A session can be retrieved based on its session id, and all session id's in a SSLSessionContext can be listed.

Also see:

SSLSession

since: 1.4 -

author: Nathan - Abramson

author: David - Brownell

Method from javax.net.ssl.SSLSessionContext Summary:
getIds, getSession, getSessionCacheSize, getSessionTimeout, setSessionCacheSize, setSessionTimeout

Method from javax.net.ssl.SSLSessionContext Detail:
public Enumeration getIds() Returns an Enumeration of all session id's grouped under this `SSLSessionContext`.
public SSLSession getSession(byte[] sessionId) Returns the `SSLSession` bound to the specified session id.
public int getSessionCacheSize() Returns the size of the cache used for storing `SSLSession` objects grouped under this `SSLSessionContext`.
public int getSessionTimeout() Returns the timeout limit of `SSLSession` objects grouped under this `SSLSessionContext`. If the timeout limit is set to 't' seconds, a session exceeds the timeout limit 't' seconds after its creation time. When the timeout limit is exceeded for a session, the `SSLSession` object is invalidated and future connections cannot resume or rejoin the session. A check for sessions exceeding the timeout limit is made immediately whenever the timeout limit is changed for this `SSLSessionContext`.
public void setSessionCacheSize(int size) throws IllegalArgumentException Sets the size of the cache used for storing `SSLSession` objects grouped under this `SSLSessionContext`.
public void setSessionTimeout(int seconds) throws IllegalArgumentException Sets the timeout limit for `SSLSession` objects grouped under this `SSLSessionContext`. If the timeout limit is set to 't' seconds, a session exceeds the timeout limit 't' seconds after its creation time. When the timeout limit is exceeded for a session, the `SSLSession` object is invalidated and future connections cannot resume or rejoin the session. A check for sessions exceeding the timeout is made immediately whenever the timeout limit is changed for this `SSLSessionContext`.