Skip navigation links

com.tangosol.coherence.servlet
Class SplitHttpSessionCollection

java.lang.Object
com.tangosol.util.Base
com.tangosol.coherence.servlet.AbstractHttpSessionCollection
com.tangosol.coherence.servlet.TraditionalHttpSessionCollection
com.tangosol.coherence.servlet.SplitHttpSessionCollection

All Implemented Interfaces:

CoherenceHttpSessionCollection, HttpSessionCollection

Deprecated. In releases following 3.6 customization will be declarative.

public class SplitHttpSessionCollection

extends TraditionalHttpSessionCollection

An implementation of HttpSessionCollection that manages session objects as multiple units, splitting out larger session attributes into separately managed entries.

The collection uses three configurable named caches to manage its session information in the cluster:

• "session-storage": (See the documentation for the TraditionalHttpSessionCollection.)
• "session-death-certificates": (See the documentation for the TraditionalHttpSessionCollection.)
• "session-overflow": This cache is used to manage the session attributes that are large enough to warrant being "split out" from the core session data.

Version:

Coherence 2.3

Author:

cp 2003.08.20

Nested Class Summary

Nested classes/interfaces inherited from class com.tangosol.coherence.servlet.AbstractHttpSessionCollection

AbstractHttpSessionCollection.ApplicationScopeController, AbstractHttpSessionCollection.DistributedController, AbstractHttpSessionCollection.ExitAgent, AbstractHttpSessionCollection.ExitObserver, AbstractHttpSessionCollection.ExitTask, AbstractHttpSessionCollection.GlobalScopeController, AbstractHttpSessionCollection.HybridController, AbstractHttpSessionCollection.LocalController

Nested classes/interfaces inherited from interface com.tangosol.coherence.servlet.HttpSessionCollection

HttpSessionCollection.AttributeScopeController, HttpSessionCollection.SessionDistributionController

Field Summary

static java.lang.String	CACHENAME_OVERFLOW Deprecated. The name of the clustered cache that stores the attributes that are too large to store as part of the session objects.
static java.lang.String	CTX_INIT_ATTR_OVERFLOW_THRESHOLD Deprecated. The configuration property for the "split" model that overrides the length that attributes must be below to be stored inside a session ("embedded") or above which they will be stored in the separated "overflow" cache ("external").
static int	CTX_INIT_ATTR_OVERFLOW_THRESHOLD_DEFAULT Deprecated.
static java.lang.String	CTX_INIT_CACHENAME_OVERFLOW Deprecated. The configuration property that overrides the name of the clustered cache that stores the "overflowing" (split-out due to size) session attributes.

Fields inherited from class com.tangosol.coherence.servlet.AbstractHttpSessionCollection

CACHENAME_DEATHCERTS, CACHENAME_LOCAL_ATTRIBUTES, CACHENAME_LOCAL_SESSIONS, CACHENAME_SESSIONS, CTX_INIT_ENABLE_SESSION_ACCESS_DEBUG_LOGGING, CTX_INIT_SESSION_ACCESS_DEBUG_LOGGING_FILTER, SERVICENAME_OWNERSHIP

Constructor Summary

SplitHttpSessionCollection()
Deprecated. Default constructor (required).

Method Summary

void	configure(XmlElement xml, SessionHelper sessionHelper) Deprecated.
int	getAverageExternalAttributeSize() Deprecated. Calculate the average size (in bytes) of the session attributes stored in the external attribute cache since the last time statistics were reset.
NamedCache	getExternalAttributeCache() Deprecated. Obtain the cache used to store the large session attributes.
int	getExternalAttributeUpdates() Deprecated. Return the number of updates to session attributes stored in the external attribute cache since the last time statistics were reset.
int	getMaxExternalAttributeSize() Deprecated. Return the maximum size (in bytes) of a session attribute stored in the external attribute cache since the last time statistics were reset.
int	getMinExternalAttributeSize() Deprecated. Determine the minimum size of an attribute such that it is considered "large" and will be stored in a separate "external" or "overflow" cache.
protected AbstractHttpSessionModel	instantiateModel(javax.servlet.http.HttpSession session, java.lang.String sId) Deprecated. Factory Method: Instantiate a AbstractHttpSessionModel or subclass thereof.
protected void	onExternalAttributeUpdate(int cb) Deprecated. Notify the session collection that an attribute of the specified size (in bytes) was updated in the external attribute cache.
void	resetStatistics() Deprecated. Reset all statistics maintained by this session collection.
void	shutdown() Deprecated. Notify the session collection that it is being shut down.
java.lang.String	toString() Deprecated. Returns a string representation of the object.

Methods inherited from class com.tangosol.coherence.servlet.TraditionalHttpSessionCollection

getSerializer, setSerializer

Methods inherited from class com.tangosol.coherence.servlet.AbstractHttpSessionCollection

activate, addHttpSessionAttributeListener, addHttpSessionListener, create, create, create, deleteModelFromLocalCaches, destroy, destroyLocalAttributesCache, ensureLocalAttributesCache, enter, enter, exit, exit, fireSessionDestroyedListeners, generateSessionId, get, getActiveCache, getAppControlCache, getAverageModelLifetime, getAverageModelSize, getCacheDelegator, getClusterCache, getCollection, getConfig, getCurrentTime, getDeathCertCache, getDefaultMaxInactiveInterval, getDescription, getDistributionController, getHttpSessionAttributeListeners, getHttpSessionCollectionConfiguration, getHttpSessionListeners, getLocalAttributesCache, getLocalCache, getMaxModelSize, getMinModelSize, getModel, getModelDeaths, getModelUpdates, getOwnedCache, getOwnedModel, getScopeController, getSessionAccessDebugLoggingFilter, getSessionExpiryFilter, getSessionIdGenerator, getSessionIdLength, getSessionOwnershipInfo, getStickyCache, getStickyExitTaskCache, getStickyService, isActive, isAllowLocalAttributes, isAppLockingEnforced, isAssumeLocality, isEnableAttributeListenerOptimization, isEnabledSessionAccessDebugLogging, isEnableSuspectAttributes, isExistent, isMemberLockingEnforced, isOwned, isOwnershipSticky, isSessionLockingEnforced, isStrict, isStuck, isThreadLockingEnforced, iterateIds, iteratePotentiallyExpiredIds, logInvalidationExceptions, obtainAppOwnership, obtainClusterOwnership, obtainThreadOwnership, onModelUpdate, passivate, postCreate, putBlind, registerSessionInvalidationWithDeathCertCache, releaseAppOwnership, releaseCache, releaseClusterOwnership, releaseStuckSession, releaseThreadOwnership, removeBlind, removeHttpSessionAttributeListener, removeHttpSessionListener, setCacheDelegator, setConfiguration

Field Detail

CTX_INIT_CACHENAME_OVERFLOW

public static final java.lang.String CTX_INIT_CACHENAME_OVERFLOW

Deprecated.

The configuration property that overrides the name of the clustered cache that stores the "overflowing" (split-out due to size) session attributes. Only used for the "Split" model.

See Also:

Constant Field Values

CTX_INIT_ATTR_OVERFLOW_THRESHOLD

public static final java.lang.String CTX_INIT_ATTR_OVERFLOW_THRESHOLD

Deprecated.

The configuration property for the "split" model that overrides the length that attributes must be below to be stored inside a session ("embedded") or above which they will be stored in the separated "overflow" cache ("external").

See Also:

Constant Field Values

CACHENAME_OVERFLOW

public static final java.lang.String CACHENAME_OVERFLOW

Deprecated.

The name of the clustered cache that stores the attributes that are too large to store as part of the session objects.

See Also:

Constant Field Values

CTX_INIT_ATTR_OVERFLOW_THRESHOLD_DEFAULT

public static final int CTX_INIT_ATTR_OVERFLOW_THRESHOLD_DEFAULT

Deprecated.

See Also:

Constant Field Values

Constructor Detail

SplitHttpSessionCollection

public SplitHttpSessionCollection()

Deprecated.

Default constructor (required).

Method Detail

shutdown

public void shutdown()

Deprecated.

Notify the session collection that it is being shut down. After this method invocation has been made, the session collection may throw IllegalStateException for any subsequent method invocation made to it.

Specified by:

shutdown in interface HttpSessionCollection

Overrides:

shutdown in class AbstractHttpSessionCollection

configure

public void configure(XmlElement xml,
                      SessionHelper sessionHelper)

Deprecated.

Specified by:

configure in interface CoherenceHttpSessionCollection

Overrides:

configure in class AbstractHttpSessionCollection

getMinExternalAttributeSize

public int getMinExternalAttributeSize()

Deprecated.

Determine the minimum size of an attribute such that it is considered "large" and will be stored in a separate "external" or "overflow" cache.

Returns:

the length of attributes, above which they will be stored in the external ("overflow") cache

getExternalAttributeCache

public NamedCache getExternalAttributeCache()

Deprecated.

Obtain the cache used to store the large session attributes.

Returns:

the external cache used to store large session attributes

toString

public java.lang.String toString()

Deprecated.

Returns a string representation of the object.

Overrides:

toString in class TraditionalHttpSessionCollection

Returns:

a string representation of the object

instantiateModel

protected AbstractHttpSessionModel instantiateModel(javax.servlet.http.HttpSession session,
                                                    java.lang.String sId)

Deprecated.

Factory Method: Instantiate a AbstractHttpSessionModel or subclass thereof.

Overrides:

instantiateModel in class TraditionalHttpSessionCollection

Parameters:

session - the session that delegates to this model

sId - the session ID

Returns:

a new instance of AbstractHttpSessionModel or subclass thereof

getAverageExternalAttributeSize

public int getAverageExternalAttributeSize()

Deprecated.

Calculate the average size (in bytes) of the session attributes stored in the external attribute cache since the last time statistics were reset.

Returns:

the average external attribute size (in bytes)

getMaxExternalAttributeSize

public int getMaxExternalAttributeSize()

Deprecated.

Return the maximum size (in bytes) of a session attribute stored in the external attribute cache since the last time statistics were reset.

Returns:

the maximum external attribute size (in bytes)

getExternalAttributeUpdates

public int getExternalAttributeUpdates()

Deprecated.

Return the number of updates to session attributes stored in the external attribute cache since the last time statistics were reset.

Returns:

the number of updates to the external attribute cache

resetStatistics

public void resetStatistics()

Deprecated.

Reset all statistics maintained by this session collection.

Overrides:

resetStatistics in class AbstractHttpSessionCollection

onExternalAttributeUpdate

protected void onExternalAttributeUpdate(int cb)

Deprecated.

Notify the session collection that an attribute of the specified size (in bytes) was updated in the external attribute cache.

Parameters:

cb - the size (in bytes) of the external attribute

Skip navigation links