Package com.mulesoft.connectors.mcp.internal.server.session

Class DistributedL2SessionManager

java.lang.Object

com.mulesoft.connectors.mcp.internal.server.session.DistributedL2SessionManager

All Implemented Interfaces:

SessionManager

public class DistributedL2SessionManager
extends Object
implements SessionManager

A SessionManager implementation intended for cases in which the session information needs to be replicated across several replicas that (might or might not) be using OSv2 and/or be part of a Hazelcast cluster.

For instance, consider the case of streamable Http transport in which the sessions outlast the lifespan of an http request but CloudHub doesn't support sticky sessions. Therefore, we need to make sure that whatever replica handles each request it gets access to the session even if it was established by another node.

For this we use a two-layer cache, in which L1 is backed by a Guava cache (with idle invalidation) and the L2 is an ObjectStore that might or might not be backed by Hazelcast or OSv2.

Since:

0.2.0

Constructor Summary

Constructors

Constructor	Description
DistributedL2SessionManager(String ownerConfigName, org.mule.runtime.api.store.ObjectStore<MuleServerSession> l2ObjectStore, org.mule.runtime.api.lock.LockFactory lockFactory, Long sessionTimeoutMillis)

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this instance
List<MuleServerSession>	getLocalSessions()	For distributed implementations, it returns the sessions that were created in this particular Mule instances.
Optional<MuleServerSession>	recoverSession(String sessionId)
boolean	unregisterAndClose(String sessionId)	Unregisters the session associated to the sessionId and calls McpSessionDecorator.close() on it
void	upsert(MuleServerSession session)	Registers or updates the given session

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DistributedL2SessionManager

public DistributedL2SessionManager(String ownerConfigName,
 org.mule.runtime.api.store.ObjectStore<MuleServerSession> l2ObjectStore,
 org.mule.runtime.api.lock.LockFactory lockFactory,
 Long sessionTimeoutMillis)

Method Details

recoverSession

public Optional<MuleServerSession> recoverSession(String sessionId)

Specified by:

recoverSession in interface SessionManager

Parameters:

sessionId - the session id

Returns:

Optionally recover the session of the given sessionId

upsert

public void upsert(MuleServerSession session)

Description copied from interface: SessionManager

Registers or updates the given session

Specified by:

upsert in interface SessionManager

unregisterAndClose

public boolean unregisterAndClose(String sessionId)

Description copied from interface: SessionManager

Unregisters the session associated to the sessionId and calls McpSessionDecorator.close() on it

Specified by:

unregisterAndClose in interface SessionManager

Parameters:

sessionId - the session id

Returns:

whether a matching session existed or not

getLocalSessions

public List<MuleServerSession> getLocalSessions()

Description copied from interface: SessionManager

For distributed implementations, it returns the sessions that were created in this particular Mule instances. For non distributed implementations, it just returns all sessions.

Specified by:

getLocalSessions in interface SessionManager

Returns:

a collection of sessions

close

public void close()

Description copied from interface: SessionManager

Closes this instance

Specified by:

close in interface SessionManager