Home » openjdk-7 » javax » net » ssl » [javadoc | source]
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:

A session can be retrieved based on its session id, and all session id's in a SSLSessionContext can be listed.
Method from javax.net.ssl.SSLSessionContext Summary:
getIds,   getSession,   getSessionCacheSize,   getSessionTimeout,   setSessionCacheSize,   setSessionTimeout
Method from javax.net.ssl.SSLSessionContext Detail:
 public Enumeration<byte> 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.