JBossWeb/Tomcat HTTP Session Implementation Details

Internal

• HTTP Session

Relevance

• EAP 6.4.6
• JBoss AS 5.1.2

Clustered Session Diagram

Lifecycle

Each org.apache.catalina.connector.Request maintains a direct reference to the active Session instance the request belongs to. The reference can be null.

The repository of sessions for a specific application (context) is an instance of org.apache.catalina.Manager. The manager is referred to from the StandardContext via the manager reference.

• If the application is not clustered, the Manager implementation is an org.apache.catalina.session.StandardManager.
• If the application is clustered, the Manager implementation is an org.jboss.as.web.session.DistributableSessionManager.

Sessions are not created automatically by the Tomcat machinery, unless we invoke HttpServletRequest.getSession() (which is equivalent with HttpServletRequest.getSession(true)) or org.apache.catalina.connector.Request.getSessionInternal().

When HttpServletRequest.getSession() is invoked, the following happen:

• The Manager instance is obtained from the StandardContext associated with the request.
• Manager.findSession(sessionId) is messaged on the Manager instance.
• The Session is looked up in the sessions map by its session ID. This applies to both non-clustered and clustered sessions.

Session Found

If the session is found, access() method is invoked on it.

If the session is not clustered, it is then simply returned.

If the session is clustered (an org.jboss.as.web.session.ClusteredSession implementation), the node attempt to acquire ownership, by invoking acquireSessionOwnership() method. For more details on session ownership, see Session Ownership and Locking.

Session Not Found

If no session is found, and org.apache.catalina.connector.Request.SESSION_ID_CHECK is true, the request tries to find the session with the ID equals to requestedSessionId among the Host's children.

If no session is found, the Manager instance is messaged to createSession(sessionId).

Common

Once the session is created by the manager (and its id generated), or it is retrieved, the request then sets a "session" cookie on Response "Set-Cookie" "JSESSIONID=FFB6...56; Path=/mycontext". The internal implementation of the cookie is TomcatCookie.

Clustered Session Access and Replication

The write entry point is org.jboss.as.web.session.ClusteredSession.setAttribute(...)

The write access consists in the following sequence:

• The state of the session is checked.
• The write arguments are checked to make sure they're are Serializable.
• The "sessionAttributesDirty" is set to true.
• The change is applied by firing HttpSessionBindingEvent instances to HttpSessionAttributeListener implementations.

This is where the interaction with the session ends. The replication is triggered either by the ClusteredSessionValve or the InstantSnapshotManager. See below:

Synchronous Replication

ClusteredSessionValve triggers replication by messaging org.jboss.as.web.session.InstantSnapshotManager.

Asynchronous Replication

org.jboss.as.web.session.InstantSnapshotManager takes periodic "snapshots" by itself.

Common

In both cases, org.jboss.as.web.session.InstantSnapshotManager messages org.jboss.as.web.session.DistributableSessionManager instance by invoking storeSession(...).

SessionID Generation

SessionID is generated by ManagerBase.generateSessionId().

Session Counter

Maintained by the sessionCounter variable of the StandardManager instance of the web application.

Session Ownership and Locking

Before a node tries to use a session, it first tries to obtain the session ownership via locking, which translates into a RPC call across the cluster. That is why is almost a good idea to configure session stickiness. For more details on general concepts related to session replication and ownership, see HTTP Session Replication - Session Ownership and Stickiness.

The session ownership is acquired by the DistributedCacheManager instance from the lock manager (DistributedLockManager instance). The result of the lock acquisition attempt could be:

• NEW_LOCK
• ALREADY_HELD
• ACQUIRED_FROM_CLUSTER

The default timeout when the lock manager is trying to lock is 15,000 ms (15 seconds).

Interaction with the Underlying Cache

The session is initially retrieved from the underlying cache by retrieving a value associated with the session ID (example: "e7H9cWGDBFoM-KjyKpFug+uu"). The result is an org.infinispan.container.entries.ImmortalCacheEntry instance. The cache entry's key is the session ID, and the value is a map:

Stored Data Structure

An ImmortalCacheEntry instance whose value is a Map:

• byte (0) - Integer (version?)
• byte (1) - Long (timestamp?)
• byte (2) - org.jboss.as.clustering.web.DistributableSessionMetadata instance.
  • String id
  • long creationTime
  • int maxIntactiveInterval
  • boolean isNew
  • boolean isValid
• byte (3) - org.jboss.as.clustering.SimpleMarshalledValue instance - representing the attribute being written.