Package org.eclipse.jetty.server.session

Class NullSessionCache

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.session.AbstractSessionCache

org.eclipse.jetty.server.session.NullSessionCache

All Implemented Interfaces:

SessionCache, org.eclipse.jetty.util.component.LifeCycle

public class NullSessionCache
extends AbstractSessionCache

NullSessionCache Does not actually cache any Session objects. Useful for testing. Also useful if you do not want to share Session objects with the same id between simultaneous requests: note that this means that context forwarding can't share the same id either.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from class org.eclipse.jetty.server.session.AbstractSessionCache

AbstractSessionCache.PlaceHolderSession

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

org.eclipse.jetty.util.component.LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from class org.eclipse.jetty.server.session.AbstractSessionCache

_context, _evictionPolicy, _handler, _removeUnloadableSessions, _saveOnCreate, _saveOnInactiveEviction, _sessionDataStore

Fields inherited from interface org.eclipse.jetty.server.session.SessionCache

EVICT_ON_INACTIVITY, EVICT_ON_SESSION_EXIT, NEVER_EVICT

Constructor Summary

Constructors

Constructor	Description
NullSessionCache(SessionHandler handler)

Method Summary

Modifier and Type	Method	Description
Session	doDelete(java.lang.String id)	Remove the session with this identity from the store
Session	doGet(java.lang.String id)	Get the session matching the key
Session	doPutIfAbsent(java.lang.String id, Session session)	Put the session into the map if it wasn't already there
boolean	doReplace(java.lang.String id, Session oldValue, Session newValue)	Replace the mapping from id to oldValue with newValue
Session	newSession(HttpServletRequest request, SessionData data)	Create a new Session for a request.
Session	newSession(SessionData data)	Create a new Session object from pre-existing session data
void	setEvictionPolicy(int evictionTimeout)	-1 means we never evict inactive sessions.
void	shutdown()

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class org.eclipse.jetty.server.session.AbstractSessionCache

checkExpiration, checkInactiveSession, contains, delete, doStart, doStop, exists, get, getEvictionPolicy, getSessionDataStore, getSessionHandler, initialize, isRemoveUnloadableSessions, isSaveOnCreate, isSaveOnInactiveEviction, newSession, put, renewSessionId, setRemoveUnloadableSessions, setSaveOnCreate, setSaveOnInactiveEviction, setSessionDataStore, toString

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, dumpThis, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, start, stop, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NullSessionCache

public NullSessionCache(SessionHandler handler)

Parameters:

handler - The SessionHandler related to this SessionCache

Method Detail

shutdown

public void shutdown()

See Also:

SessionCache.shutdown()

newSession

public Session newSession(SessionData data)

Description copied from class: AbstractSessionCache

Create a new Session object from pre-existing session data

Specified by:

newSession in interface SessionCache

Specified by:

newSession in class AbstractSessionCache

Parameters:

data - the session data

Returns:

a new Session object

See Also:

AbstractSessionCache.newSession(org.eclipse.jetty.server.session.SessionData)

newSession

public Session newSession(HttpServletRequest request,
                          SessionData data)

Description copied from class: AbstractSessionCache

Create a new Session for a request.

Specified by:

newSession in class AbstractSessionCache

Parameters:

request - the request

data - the session data

Returns:

the new session

See Also:

AbstractSessionCache.newSession(javax.servlet.http.HttpServletRequest, org.eclipse.jetty.server.session.SessionData)

doGet

public Session doGet(java.lang.String id)

Description copied from class: AbstractSessionCache

Get the session matching the key

Specified by:

doGet in class AbstractSessionCache

Parameters:

id - session id

Returns:

the Session object matching the id

See Also:

AbstractSessionCache.doGet(java.lang.String)

doPutIfAbsent

public Session doPutIfAbsent(java.lang.String id,
                             Session session)

Description copied from class: AbstractSessionCache

Put the session into the map if it wasn't already there

Specified by:

doPutIfAbsent in class AbstractSessionCache

Parameters:

id - the identity of the session

session - the session object

Returns:

null if the session wasn't already in the map, or the existing entry otherwise

See Also:

AbstractSessionCache.doPutIfAbsent(java.lang.String, org.eclipse.jetty.server.session.Session)

doReplace

public boolean doReplace(java.lang.String id,
                         Session oldValue,
                         Session newValue)

Description copied from class: AbstractSessionCache

Replace the mapping from id to oldValue with newValue

Specified by:

doReplace in class AbstractSessionCache

Parameters:

id - the id

oldValue - the old value

newValue - the new value

Returns:

true if replacement was done

See Also:

AbstractSessionCache.doReplace(java.lang.String, org.eclipse.jetty.server.session.Session, org.eclipse.jetty.server.session.Session)

doDelete

public Session doDelete(java.lang.String id)

Description copied from class: AbstractSessionCache

Remove the session with this identity from the store

Specified by:

doDelete in class AbstractSessionCache

Parameters:

id - the id

Returns:

true if removed false otherwise

See Also:

AbstractSessionCache.doDelete(java.lang.String)

setEvictionPolicy

public void setEvictionPolicy(int evictionTimeout)

Description copied from class: AbstractSessionCache

-1 means we never evict inactive sessions. 0 means we evict a session after the last request for it exits >0 is the number of seconds after which we evict inactive sessions from the cache

Specified by:

setEvictionPolicy in interface SessionCache

Overrides:

setEvictionPolicy in class AbstractSessionCache

Parameters:

evictionTimeout - -1 is never evict; 0 is evict-on-exit; and any other positive value is the time in seconds that a session can be idle before it can be evicted.

See Also:

AbstractSessionCache.setEvictionPolicy(int)