Module org.eclipse.jetty.session

Package org.eclipse.jetty.session

Class DefaultSessionCache

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.session.AbstractSessionCache

org.eclipse.jetty.session.DefaultSessionCache

All Implemented Interfaces:

SessionCache, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle

@ManagedObject
public class DefaultSessionCache
extends AbstractSessionCache

A session store that keeps its sessions in memory within a concurrent map

Nested Class Summary

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

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

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.Dumpable

org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.Dumpable.DumpAppendable

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.session.AbstractSessionCache

_context, _evictionPolicy, _flushOnResponseCommit, _invalidateOnShutdown, _manager, _removeUnloadableSessions, _saveOnCreate, _saveOnInactiveEviction, _sessionDataStore

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

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

LEGEND

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

EVICT_ON_INACTIVITY, EVICT_ON_SESSION_EXIT, NEVER_EVICT

Constructor Summary

Constructors

Constructor	Description
DefaultSessionCache(SessionManager manager)
DefaultSessionCache(SessionManager manager, ConcurrentMap<String,ManagedSession> sessions)

Method Summary

Modifier and Type	Method	Description
protected ManagedSession	doComputeIfAbsent(String id, Function<String,ManagedSession> mappingFunction)	Compute the mappingFunction to create a Session object iff the session with the given id isn't already in the map, otherwise return the existing Session.
ManagedSession	doDelete(String id)	Remove the session with this identity from the store
ManagedSession	doGet(String id)	Get the session matching the key from the cache.
org.eclipse.jetty.server.Session	doPutIfAbsent(String id, ManagedSession session)	Put the session into the map if it wasn't already there
boolean	doReplace(String id, ManagedSession oldValue, ManagedSession newValue)	Replace the mapping from id to oldValue with newValue
long	getSessionsCurrent()
long	getSessionsMax()
long	getSessionsTotal()
ManagedSession	newSession(SessionData data)	Create a new Session object from pre-existing session data
void	resetStats()
void	shutdown()

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

add, checkExpiration, checkInactiveSession, commit, contains, delete, doStart, doStop, exists, get, getAndEnter, getEvictionPolicy, getSessionDataStore, getSessionManager, initialize, isFlushOnResponseCommit, isInvalidateOnShutdown, isRemoveUnloadableSessions, isSaveOnCreate, isSaveOnInactiveEviction, newSession, release, renewSessionId, renewSessionId, setEvictionPolicy, setFlushOnResponseCommit, setInvalidateOnShutdown, setRemoveUnloadableSessions, setSaveOnCreate, setSaveOnInactiveEviction, setSessionDataStore, toString

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

addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, installBean, installBean, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans, updateBeans

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

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop

Methods inherited from class java.lang.Object

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

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

getCachedBeans, getEventListeners

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

dumpSelf

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

isDumpable

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

addEventListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, start, stop

Constructor Details

DefaultSessionCache

public DefaultSessionCache(SessionManager manager)

Parameters:

manager - The SessionHandler related to this SessionCache

DefaultSessionCache

public DefaultSessionCache(SessionManager manager,
 ConcurrentMap<String,ManagedSession> sessions)

Parameters:

manager - The SessionHandler related to this SessionCache

sessions - The session map implementation to use

Method Details

getSessionsCurrent

@ManagedAttribute(value="current sessions in cache",
                  readonly=true)
public long getSessionsCurrent()

Returns:

the number of sessions in the cache

getSessionsMax

@ManagedAttribute(value="max sessions in cache",
                  readonly=true)
public long getSessionsMax()

Returns:

the max number of sessions in the cache

getSessionsTotal

@ManagedAttribute(value="total sessions in cache",
                  readonly=true)
public long getSessionsTotal()

Returns:

a running total of sessions in the cache

resetStats

@ManagedOperation(value="reset statistics",
                  impact="ACTION")
public void resetStats()

doGet

public ManagedSession doGet(String id)

Description copied from class: AbstractSessionCache

Get the session matching the key from the cache. Does not load the session.

Specified by:

doGet in class AbstractSessionCache

Parameters:

id - session id

Returns:

the Session object matching the id

doPutIfAbsent

public org.eclipse.jetty.server.Session doPutIfAbsent(String id,
 ManagedSession 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

doComputeIfAbsent

protected ManagedSession doComputeIfAbsent(String id,
 Function<String,ManagedSession> mappingFunction)

Description copied from class: AbstractSessionCache

Compute the mappingFunction to create a Session object iff the session with the given id isn't already in the map, otherwise return the existing Session. This method is expected to have precisely the same behaviour as ConcurrentHashMap.computeIfAbsent(K, java.util.function.Function<? super K, ? extends V>)

Specified by:

doComputeIfAbsent in class AbstractSessionCache

Parameters:

id - the session id

mappingFunction - the function to load the data for the session

Returns:

an existing Session from the cache

doDelete

public ManagedSession doDelete(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:

Session that was removed or null

shutdown

public void shutdown()

newSession

public ManagedSession 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

doReplace

public boolean doReplace(String id,
 ManagedSession oldValue,
 ManagedSession 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