Package com.ibm.websphere.servlet.session

Interface IBMSession

All Superinterfaces:
Externalizable, javax.servlet.http.HttpSession, Serializable
All Known Subinterfaces:
IBMSessionExt
public interface IBMSession extends javax.servlet.http.HttpSession, Externalizable
The IBMSession interface extends the javax.servlet.http.HttpSession interface of the Servlet API to
  • limit the number of sessions in memory
  • get at the user identity associated with session.
  • control the timing of writing session changes to an external place.

    The WebSphere implementation of the http session object implements this interface.

    With regards to overflow: When overflow is turned off in a non-persistent session mode, an invalid session object is returned when the maximum capacity, specified by Max In Memory Session Count property, has been reached. Example code: IBMSession sess = (IBMSession) request.getSession(); if(sess.isOverFlow()) throw new ServletException("Maximum number of sessions reached on the server");

    With regards to security: When security integration is turned on in the SessionManager, WebSphere Application Server maintains the notion of an authenticated or unauthenticated owner of a session. If a session is owned by an unauthenticated user (which we internally denote via the user name of "anonymous"), then a servlet operating under the credentials of any user can access the session, provided the request has the session identifier(from either cookie or rewritten url). However, if the session is marked as being owned by an authenticated user (where the user name is provided by the WebSphere Security API's and management), then a servlet must be operating under the credentials of the same user in order for WebSphere to return the requested session to the servlet. A session gets denoted one time with the first authenticated user name seen by the Application Server while processing the session. This can either happen if the user has already been authenticated on the Http Request which leads to the creation of the session, or it can happen on the first authenticated user name seen after an "anonymous" session is created. Example code: IBMSession sess = (IBMSession) request.getSession(); String userName = sess.getUserName();

    With regard to sync in persistent sessions mode(both database and memory-to-memory): The application can control when to persist the http session updates to external store by calling the sync method on this extension. Starting with WebSphere version 5.0, this can be called independent of the write frequency selected in the SessionManager. Example code: IBMSession sess = (IBMSession) request.getSession(); sess.sync();

    • See Also:

    • Method Summary

      Modifier and Type
      Method
      Description
      IBMApplicationSession
      getIBMApplicationSession()
       
      IBMApplicationSession
      getIBMApplicationSession(boolean create)
       
      String
      getUserName()
      To get at the user identity associated with this session.
      boolean
      isOverflow()
      To determine if the number of sessions in memory has exceeded the value specified by the Max In Memory Session Count property on the SessionManager.
      void
      sync()
      To persist the session updates to external store.

      Methods inherited from interface java.io.Externalizable

      readExternal, writeExternal

      Methods inherited from interface javax.servlet.http.HttpSession

      getAttribute, getAttributeNames, getCreationTime, getId, getLastAccessedTime, getMaxInactiveInterval, getServletContext, getSessionContext, getValue, getValueNames, invalidate, isNew, putValue, removeAttribute, removeValue, setAttribute, setMaxInactiveInterval

    • Method Details

      • getUserName

        String getUserName()
        To get at the user identity associated with this session. When security integration is turned off on the SessionManager, this method will always return "anonymous". When security integration is turned on and the session is accessed in an authenticated page, then this method returns the authenticated user name as set by the security context. Otherwise, this method returns "anonymous".

      • sync

        void sync()
        To persist the session updates to external store. This is applicable only in persistent sessions mode.

      • isOverflow

        boolean isOverflow()
        To determine if the number of sessions in memory has exceeded the value specified by the Max In Memory Session Count property on the SessionManager. This is applicable only in non-persistent sessions mode. In persistent sessions mode this method always returns false.

      • getIBMApplicationSession

        IBMApplicationSession getIBMApplicationSession()

      • getIBMApplicationSession

        IBMApplicationSession getIBMApplicationSession(boolean create)