Package org.eclipse.jetty.server.session

Class AbstractSessionDataStore

    • Field Detail

      • _gracePeriodSec

        protected int _gracePeriodSec

      • _lastExpiryCheckTime

        protected long _lastExpiryCheckTime

      • _savePeriodSec

        protected int _savePeriodSec

    • Constructor Detail

      • AbstractSessionDataStore

        public AbstractSessionDataStore()

    • Method Detail

      • doStore

        public abstract void doStore​(java.lang.String id,
                             SessionData data,
                             long lastSaveTime)
                      throws java.lang.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:
        java.lang.Exception - if unable to store data

      • doLoad

        public abstract SessionData doLoad​(java.lang.String id)
                            throws java.lang.Exception
        Load the session from persistent store.
        Parameters:
        id - the id of the session to load
        Returns:
        the re-inflated session
        Throws:
        java.lang.Exception - if unable to load the session

      • doGetExpired

        public abstract java.util.Set<java.lang.String> doGetExpired​(java.util.Set<java.lang.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 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
        Parameters:
        context - context associated
        Throws:
        java.lang.Exception - if unable to initialize the

      • load

        public SessionData load​(java.lang.String id)
                 throws java.lang.Exception
        Description copied from interface: SessionDataMap
        Read in session data.
        Specified by:
        load in interface SessionDataMap
        Parameters:
        id - identity of session to load
        Returns:
        the SessionData matching the id
        Throws:
        java.lang.Exception - if unable to load session data

      • store

        public void store​(java.lang.String id,
                  SessionData data)
           throws java.lang.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:
        java.lang.Exception - if unable to write session data

      • getExpired

        public java.util.Set<java.lang.String> getExpired​(java.util.Set<java.lang.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

      • newSessionData

        public SessionData newSessionData​(java.lang.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

      • checkStarted

        protected void checkStarted()
                     throws java.lang.IllegalStateException
        Throws:
        java.lang.IllegalStateException

      • doStart

        protected void doStart()
                throws java.lang.Exception
        Description copied from class: ContainerLifeCycle
        Starts the managed lifecycle beans in the order they were added.
        Overrides:
        doStart in class ContainerLifeCycle
        Throws:
        java.lang.Exception

      • getGracePeriodSec

        @ManagedAttribute(value="interval in secs to prevent too eager session scavenging",
                  readonly=true)
public int getGracePeriodSec()

      • setGracePeriodSec

        public void setGracePeriodSec​(int sec)

      • setSavePeriodSec

        public void setSavePeriodSec​(int savePeriodSec)
        The minimum time in seconds between save operations. Saves normally occur every time the last request exits as session. If nothing changes on the session except for the access time and the persistence technology is slow, this can cause delays.

        By default the value is 0, which means we save after the last request exists. A non zero value means that we will skip doing the save if the session isn't dirty if the elapsed time since the session was last saved does not exceed this value.

        Parameters:
        savePeriodSec - the savePeriodSec to set