Package org.eclipse.jetty.server.session

Class FileSessionDataStore

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.session.AbstractSessionDataStore

org.eclipse.jetty.server.session.FileSessionDataStore

All Implemented Interfaces:

SessionDataMap, SessionDataStore, Container, Destroyable, Dumpable, LifeCycle

@ManagedObject
public class FileSessionDataStore
extends AbstractSessionDataStore

FileSessionDataStore A file-based store of session data.

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

Container.InheritedListener, Container.Listener

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

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field	Description
protected long	_lastSweepTime

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

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

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

_context, _gracePeriodSec, _lastExpiryCheckTime, _savePeriodSec

Constructor Summary

Constructors

Constructor	Description
FileSessionDataStore()

Method Summary

Modifier and Type	Method	Description
boolean	delete(java.lang.String id)	Delete a session
boolean	deleteFile(java.lang.String filename)	Delete the file associated with a session
java.util.Set<java.lang.String>	doGetExpired(java.util.Set<java.lang.String> candidates)	Check to see which sessions have expired.
protected void	doStart()
protected void	doStop()
void	doStore(java.lang.String id, SessionData data, long lastSaveTime)	Store the session data persistently.
boolean	exists(java.lang.String id)	Test if data exists for a given session id.
java.io.File	getStoreDir()
void	initialize(SessionContext context)	Initialize this data map for the given context.
void	initializeStore()	Read the names of the existing session files and build a map of fully qualified session ids (ie with context) to filename.
boolean	isDeleteUnrestorableFiles()
boolean	isPassivating()	True if this type of datastore will passivate session objects
SessionData	load(java.lang.String id)	Read in session data.
void	setDeleteUnrestorableFiles(boolean deleteUnrestorableFiles)
void	setStoreDir(java.io.File storeDir)
void	sweepDisk()	Check all session files that do not belong to this context and remove any that expired long ago (ie at least 5 gracePeriods ago).
void	sweepFile(long now, java.nio.file.Path p)	Check to see if the expiry on the file is very old, and delete the file if so.
java.lang.String	toString()

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

checkStarted, getExpired, getGracePeriodSec, getSavePeriodSec, newSessionData, setGracePeriodSec, setSavePeriodSec, store

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

Field Detail

_lastSweepTime

protected long _lastSweepTime

Constructor Detail

FileSessionDataStore

public FileSessionDataStore()

Method Detail

initialize

public void initialize(SessionContext context)
                throws java.lang.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

Overrides:

initialize in class AbstractSessionDataStore

Parameters:

context - context associated

Throws:

java.lang.Exception - if unable to initialize the

See Also:

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

doStart

protected void doStart()
                throws java.lang.Exception

Overrides:

doStart in class AbstractSessionDataStore

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Overrides:

doStop in class ContainerLifeCycle

Throws:

java.lang.Exception

getStoreDir

@ManagedAttribute(value="dir where sessions are stored",
                  readonly=true)
public java.io.File getStoreDir()

setStoreDir

public void setStoreDir(java.io.File storeDir)

isDeleteUnrestorableFiles

public boolean isDeleteUnrestorableFiles()

setDeleteUnrestorableFiles

public void setDeleteUnrestorableFiles(boolean deleteUnrestorableFiles)

delete

public boolean delete(java.lang.String id)
               throws java.lang.Exception

Delete a session

Parameters:

id - session id

Returns:

true if the session was deleted

Throws:

java.lang.Exception - if unable to delete session data

deleteFile

public boolean deleteFile(java.lang.String filename)
                   throws java.lang.Exception

Delete the file associated with a session

Parameters:

filename - name of the file containing the session's information

Returns:

true if file was deleted, false otherwise

Throws:

java.lang.Exception - indicating delete failure

doGetExpired

public java.util.Set<java.lang.String> doGetExpired(java.util.Set<java.lang.String> candidates)

Check to see which sessions have expired.

Specified by:

doGetExpired in class AbstractSessionDataStore

Parameters:

candidates - the set of session ids that the SessionCache believes have expired

Returns:

the complete set of sessions that have expired, including those that are not currently loaded into the SessionCache

sweepDisk

public void sweepDisk()

Check all session files that do not belong to this context and remove any that expired long ago (ie at least 5 gracePeriods ago).

sweepFile

public void sweepFile(long now,
                      java.nio.file.Path p)
               throws java.lang.Exception

Check to see if the expiry on the file is very old, and delete the file if so. "Old" means that it expired at least 5 gracePeriods ago. The session can belong to any context.

Parameters:

now - the time now in msec

p - the file to check

Throws:

java.lang.Exception - indicating error in sweep

load

public SessionData load(java.lang.String id)
                 throws java.lang.Exception

Description copied from interface: SessionDataMap

Read in session data.

Parameters:

id - identity of session to load

Returns:

the SessionData matching the id

Throws:

java.lang.Exception - if unable to load session data

See Also:

SessionDataMap.load(java.lang.String)

doStore

public void doStore(java.lang.String id,
                    SessionData data,
                    long lastSaveTime)
             throws java.lang.Exception

Description copied from class: AbstractSessionDataStore

Store the session data persistently.

Specified by:

doStore in class AbstractSessionDataStore

Parameters:

id - identity of session to store

data - info of the session

lastSaveTime - time of previous save or 0 if never saved

Throws:

java.lang.Exception - if unable to store data

See Also:

AbstractSessionDataStore.doStore(java.lang.String, org.eclipse.jetty.server.session.SessionData, long)

initializeStore

public void initializeStore()
                     throws java.lang.Exception

Read the names of the existing session files and build a map of fully qualified session ids (ie with context) to filename. If there is more than one file for the same session, only the most recently modified will be kept and the rest deleted. At the same time, any files - for any context - that expired a long time ago will be cleaned up.

Throws:

java.lang.Exception - if storeDir doesn't exist, isn't readable/writeable or contains 2 files with the same lastmodify time for the same session. Throws IOException if the lastmodifytimes can't be read.

isPassivating

@ManagedAttribute(value="are sessions serialized by this store",
                  readonly=true)
public boolean isPassivating()

Description copied from interface: SessionDataStore

True if this type of datastore will passivate session objects

Returns:

true if this store can passivate sessions, false otherwise

See Also:

SessionDataStore.isPassivating()

exists

public boolean exists(java.lang.String id)
               throws java.lang.Exception

Description copied from interface: SessionDataStore

Test if data exists for a given session id.

Parameters:

id - Identity of session whose existance should be checked

Returns:

true if valid, non-expired session exists

Throws:

java.lang.Exception - if problem checking existance with persistence layer

See Also:

SessionDataStore.exists(java.lang.String)

toString

public java.lang.String toString()

Overrides:

toString in class AbstractSessionDataStore

See Also:

AbstractSessionDataStore.toString()