Interface ISession

All Known Implementing Classes:
AbstractSession

public interface ISession
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final long
    Default session timeout in milliseconds (20 minutes).
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addListener(de.uplanet.lucy.server.session.ISessionListener p_listener, boolean p_bWeak)
    Add a listener for session events.
    boolean
    containsKey(String p_strKey)
    Test if a certain session variable exists.
    get(String p_strKey)
    Get a session variable.
    get(String p_strKey, Object p_objFallback)
    Get a session variable or the specified fallback value.
    Get the name of the authentication configuration used to login this session.
    long
    Get the time when this session was created.
    Get the unique session identifier.
    long
    Get the time of the last access to this session.
    Get the subject that is associated with this session.
    long
    Get the session timeout.
    Get the user that is associated with the session.
    boolean
    Determine if the session is an anonymous session.
    boolean
    Check if the session is logged out.
    boolean
    Check if the session has timed out.
    boolean
    isStale(long p_lTimeNow)
    Test if the session has timed out.
    Get a set that contains all session variable names.
    void
    Performs a logout on this session.
    void
    put(String p_strKey, Object p_objValue)
    Set a session variable.
    void
    remove(String p_strKey)
    Remove a session variable.
    void
    setTimeout(long p_lTimeout)
    Set the session timeout.
    void
    Touch the session.
  • Field Details

    • DEFAULT_TIMEOUT

      static final long DEFAULT_TIMEOUT
      Default session timeout in milliseconds (20 minutes).
      See Also:
  • Method Details

    • getSubject

      Subject getSubject()
      Get the subject that is associated with this session.
      Returns:
      The associated subject.
    • getAuthConfigName

      String getAuthConfigName()
      Get the name of the authentication configuration used to login this session.
      Returns:
      The name of the authentication configuration.
    • getCreationTime

      long getCreationTime()
      Get the time when this session was created.
      Returns:
      The creation time, measured in milliseconds, between the current time and 01-01-1970 00:00:00 UTC.
    • getId

      String getId()
      Get the unique session identifier.
    • isAnonymous

      boolean isAnonymous()
      Determine if the session is an anonymous session.
      Returns:
      true if the session is anonymous, false otherwise.
    • getUser

      IUser getUser()
      Get the user that is associated with the session.
      Returns:
      The user that is associated with this session, or null.
    • get

      Object get(String p_strKey)
      Get a session variable.
      Parameters:
      p_strKey - The name of the session variable.
      Returns:
      The session variable.
    • get

      Object get(String p_strKey, Object p_objFallback)
      Get a session variable or the specified fallback value.
      Parameters:
      p_strKey - The name of the session variable.
      p_objFallback - The fallback value that's being used if the session variable does not exist.
      Returns:
      The session variable.
    • put

      void put(String p_strKey, Object p_objValue)
      Set a session variable.
      Parameters:
      p_strKey - The name of the session variable.
      p_objValue - The value of the session variable.
    • containsKey

      boolean containsKey(String p_strKey)
      Test if a certain session variable exists.
      Parameters:
      p_strKey - The name of the session variable.
    • keySet

      Set<String> keySet()
      Get a set that contains all session variable names.
      Returns:
      A set with all session variables.
    • remove

      void remove(String p_strKey)
      Remove a session variable.
      Parameters:
      p_strKey - The name of the session variable to be removed.
    • setTimeout

      void setTimeout(long p_lTimeout)
      Set the session timeout.
      Parameters:
      p_lTimeout - The timeout in milliseconds.
    • getTimeout

      long getTimeout()
      Get the session timeout.
      Returns:
      p_lTimeout The timeout in milliseconds.
    • touch

      void touch()
      Touch the session.
    • isLoggedOut

      boolean isLoggedOut()
      Check if the session is logged out.
      Returns:
      true is the session is logged out, or false otherwise.
    • getLastAccessTime

      long getLastAccessTime()
      Get the time of the last access to this session.
      Returns:
      The time of last access.
    • isStale

      boolean isStale()
      Check if the session has timed out.

      The natural implementation of this method will return isStale(System.currentTimeMillis()).

      Returns:
      true if the session already has timed out, false otherwise.
    • isStale

      boolean isStale(long p_lTimeNow)
      Test if the session has timed out.
      Returns:
      true if the session has timed out, false otherwise.
    • logout

      void logout()
      Performs a logout on this session.
    • addListener

      void addListener(de.uplanet.lucy.server.session.ISessionListener p_listener, boolean p_bWeak)
      Add a listener for session events.
      Parameters:
      p_listener - The session listener to add.
      p_bWeak - true if the listener should be weakly referenced, false otherwise.