Package de.uplanet.lucy.server.session

Interface ISession

  • All Known Implementing Classes:
    AbstractSession
    public interface ISession

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static long DEFAULT_TIMEOUT
      Default session timeout in milliseconds (20 minutes).

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      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.
      Object get​(String p_strKey)
      Get a session variable.
      Object get​(String p_strKey, Object p_objFallback)
      Get a session variable or the specified fallback value.
      String getAuthConfigName()
      Get the name of the authentication configuration used to login this session.
      long getCreationTime()
      Get the time when this session was created.
      String getId()
      Get the unique session identifier.
      long getLastAccessTime()
      Get the time of the last access to this session.
      Subject getSubject()
      Get the subject that is associated with this session.
      long getTimeout()
      Get the session timeout.
      IUser getUser()
      Get the user that is associated with the session.
      boolean isAnonymous()
      Determine if the session is an anonymous session.
      boolean isLoggedOut()
      Check if the session is logged out.
      boolean isStale()
      Check if the session has timed out.
      boolean isStale​(long p_lTimeNow)
      Test if the session has timed out.
      Set<String> keySet()
      Get a set that contains all session variable names.
      void logout()
      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()
      Touch the session.

    • Field Detail

      • DEFAULT_TIMEOUT

        static final long DEFAULT_TIMEOUT
        Default session timeout in milliseconds (20 minutes).
        See Also:
        Constant Field Values

    • Method Detail

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