javax.net.ssl
Interface SSLSessionContext
- public interface SSLSessionContext
SSLSessionContext
represents a set of
SSLSession
s 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.
SSLSessionContext
can be listed.
Method Summary
Modifier and Type | Method and Description |
---|---|
|
getIds()
Returns an Enumeration of all session id's grouped under this
SSLSessionContext .
|
getSession(byte[] sessionId)
Returns the
SSLSession bound to the specified session id.
|
|
|
getSessionCacheSize()
Returns the size of the cache used for storing
SSLSession objects grouped under this
SSLSessionContext .
|
|
getSessionTimeout()
Returns the timeout limit of
SSLSession objects grouped
under this SSLSessionContext .
|
|
setSessionCacheSize(int size)
Sets the size of the cache used for storing
SSLSession objects grouped under this
SSLSessionContext .
|
|
setSessionTimeout(int seconds)
Sets the timeout limit for
SSLSession objects grouped
under this SSLSessionContext .
|
Method Detail
getSession
- SSLSession getSession(byte[] sessionId)
sessionId
- the Session identifier SSLSession
or null if
the specified session id does not refer to a valid SSLSession. NullPointerException
- if sessionId
is null. getIds
- Enumeration<byte[]> getIds()
SSLSessionContext
.
setSessionTimeout
- void setSessionTimeout(int seconds)
- throws IllegalArgumentException
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
.
seconds
- the new session timeout limit in seconds; zero means
there is no limit. IllegalArgumentException
- if the timeout specified is < 0. getSessionTimeout
- int getSessionTimeout()
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
.
setSessionCacheSize
- void setSessionCacheSize(int size)
- throws IllegalArgumentException
SSLSession
objects grouped under this
SSLSessionContext
.
size
- the new session cache size limit; zero means there is no
limit. IllegalArgumentException
- if the specified size is < 0. getSessionCacheSize
- int getSessionCacheSize()
SSLSession
objects grouped under this
SSLSessionContext
.
SSLSession
bound to the specified session id.