org.eclipse.jetty.server.session

Class AbstractSessionDataStore

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.session.AbstractSessionDataStore

All Implemented Interfaces:

SessionDataMap, SessionDataStore, Container, Destroyable, Dumpable, LifeCycle

Direct Known Subclasses:

FileSessionDataStore, JDBCSessionDataStore, NullSessionDataStore

public abstract class AbstractSessionDataStore
extends ContainerLifeCycle
implements SessionDataStore

AbstractSessionDataStore

Nested Class Summary

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

AbstractLifeCycle.AbstractLifeCycleListener

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

LifeCycle.Listener

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

Container.InheritedListener, Container.Listener

Field Summary

Fields

Modifier and Type	Field and Description
protected SessionContext	_context
protected int	_gracePeriodSec
protected long	_lastExpiryCheckTime

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

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
AbstractSessionDataStore()

Method Summary

Modifier and Type	Method and Description
protected void	checkStarted()
abstract Set<String>	doGetExpired(Set<String> candidates) Implemented by subclasses to resolve which sessions this node should attempt to expire.
protected void	doStart()
abstract void	doStore(String id, SessionData data, long lastSaveTime) Store the session data persistently.
Set<String>	getExpired(Set<String> candidates) Called periodically, this method should search the data store for sessions that have been expired for a 'reasonable' amount of time.
int	getGracePeriodSec()
void	initialize(SessionContext context) Initialize this data map for the given context.
SessionData	newSessionData(String id, long created, long accessed, long lastAccessed, long maxInactiveMs) Create a new SessionData
void	setGracePeriodSec(int sec)
void	store(String id, SessionData data) Store the session data.
String	toString()

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

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

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 java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.server.session.SessionDataStore

exists, isPassivating

Methods inherited from interface org.eclipse.jetty.server.session.SessionDataMap

delete, load

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

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

Field Detail

_context

protected SessionContext _context

_gracePeriodSec

protected int _gracePeriodSec

_lastExpiryCheckTime

protected long _lastExpiryCheckTime

Constructor Detail

AbstractSessionDataStore

public AbstractSessionDataStore()

Method Detail

doStore

public abstract void doStore(String id,
                             SessionData data,
                             long lastSaveTime)
                      throws Exception

Store the session data persistently.

Parameters:

id - identity of session to store

data - info of the session

lastSaveTime - time of previous save or 0 if never saved

Throws:

Exception - if unable to store data

doGetExpired

public abstract Set<String> doGetExpired(Set<String> candidates)

Implemented by subclasses to resolve which sessions this node should attempt to expire.

Parameters:

candidates - the ids of sessions the SessionDataStore thinks has expired

Returns:

the reconciled set of session ids that this node should attempt to expire

initialize

public void initialize(SessionContext context)
                throws Exception

Description copied from interface: SessionDataMap

Initialize this data map for the given context. A SessionDataMap can only be used by one context(/session manager).

Specified by:

initialize in interface SessionDataMap

Parameters:

context - context associated

Throws:

Exception

See Also:

SessionDataMap.initialize(org.eclipse.jetty.server.session.SessionContext)

store

public void store(String id,
                  SessionData data)
           throws Exception

Description copied from interface: SessionDataMap

Store the session data.

Specified by:

store in interface SessionDataMap

Parameters:

id - identity of session to store

data - info of session to store

Throws:

Exception - if unable to write session data

See Also:

SessionDataMap.store(java.lang.String, org.eclipse.jetty.server.session.SessionData)

getExpired

public Set<String> getExpired(Set<String> candidates)

Description copied from interface: SessionDataStore

Called periodically, this method should search the data store for sessions that have been expired for a 'reasonable' amount of time.

Specified by:

getExpired in interface SessionDataStore

Parameters:

candidates - if provided, these are keys of sessions that the SessionDataStore thinks has expired and should be verified by the SessionDataStore

Returns:

set of session ids

See Also:

SessionDataStore.getExpired(java.util.Set)

newSessionData

public SessionData newSessionData(String id,
                                  long created,
                                  long accessed,
                                  long lastAccessed,
                                  long maxInactiveMs)

Description copied from interface: SessionDataStore

Create a new SessionData

Specified by:

newSessionData in interface SessionDataStore

Parameters:

id - the id

created - the timestamp when created

accessed - the timestamp when accessed

lastAccessed - the timestamp when last accessed

maxInactiveMs - the max inactive time in milliseconds

Returns:

a new SessionData object

See Also:

SessionDataStore.newSessionData(java.lang.String, long, long, long, long)

checkStarted

protected void checkStarted()
                     throws IllegalStateException

Throws:

IllegalStateException

doStart

protected void doStart()
                throws Exception

Overrides:

doStart in class ContainerLifeCycle

Throws:

Exception

getGracePeriodSec

public int getGracePeriodSec()

setGracePeriodSec

public void setGracePeriodSec(int sec)

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()