public
interface
SSLSessionContext
| javax.net.ssl.SSLSessionContext |
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:
Developers
SSLSessionContext can be listed.
See also:
Public methods | |
|---|---|
abstract
Enumeration<byte[]>
|
getIds()
Returns an Enumeration of all session id's grouped under this
|
abstract
SSLSession
|
getSession(byte[] sessionId)
Returns the |
abstract
int
|
getSessionCacheSize()
Returns the size of the cache used for storing
|
abstract
int
|
getSessionTimeout()
Returns the timeout limit of |
abstract
void
|
setSessionCacheSize(int size)
Sets the size of the cache used for storing
|
abstract
void
|
setSessionTimeout(int seconds)
Sets the timeout limit for |
Enumeration<byte[]> getIds ()
Returns an Enumeration of all session id's grouped under this
SSLSessionContext.
| Returns | |
|---|---|
Enumeration<byte[]> |
an enumeration of all the Session id's |
SSLSession getSession (byte[] sessionId)
Returns the SSLSession bound to the specified session id.
| Parameters | |
|---|---|
sessionId |
byte:
the Session identifier |
| Returns | |
|---|---|
SSLSession |
the SSLSession or null if
the specified session id does not refer to a valid SSLSession. |
| Throws | |
|---|---|
NullPointerException |
if sessionId is null.
|
int getSessionCacheSize ()
Returns the size of the cache used for storing
SSLSession objects grouped under this
SSLSessionContext.
| Returns | |
|---|---|
int |
size of the session cache; zero means there is no size limit. |
See also:
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.
| Returns | |
|---|---|
int |
the session timeout limit in seconds; zero means there is no limit. |
See also:
void setSessionCacheSize (int size)
Sets the size of the cache used for storing
SSLSession objects grouped under this
SSLSessionContext.
| Parameters | |
|---|---|
size |
int:
the new session cache size limit; zero means there is no
limit. |
| Throws | |
|---|---|
IllegalArgumentException |
if the specified size is < 0. |
See also:
void setSessionTimeout (int seconds)
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.
| Parameters | |
|---|---|
seconds |
int:
the new session timeout limit in seconds; zero means
there is no limit. |
| Throws | |
|---|---|
IllegalArgumentException |
if the timeout specified is < 0. |
See also: