Skip navigation links

com.tangosol.coherence.servlet
Class SplitHttpSessionModel

java.lang.Object
com.tangosol.util.Base
com.tangosol.coherence.servlet.AbstractHttpSessionModel
com.tangosol.coherence.servlet.TraditionalHttpSessionModel
com.tangosol.coherence.servlet.SplitHttpSessionModel

All Implemented Interfaces:

HttpSessionModel, ExternalizableLite, java.io.Externalizable, java.io.Serializable

Deprecated. In releases following 3.6 customization will be declarative.

public class SplitHttpSessionModel

extends TraditionalHttpSessionModel

This is an implementation of HttpSessionModel that manages most of its state in a single serializable unit, but splits out its large attributes -- if any -- into separately managed units. By doing so, the cost of accessing those attributes is only realized when they are accessed or modified, and the core session data can remain very small, and thus very efficiently managed in a distributed environment.

Version:

Coherence 2.3

Author:

cp 2003.10.28

Field Summary

protected static ValueExtractor

SESSION_ID_EXTRACTOR Deprecated. ValueExtractor that can be used to extract the session ID from an external attribute key.

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

CTX_OPTIMIZE_MODIFIED_SESSIONS, MAGIC_V350, STRING_ARRAY

Constructor Summary

SplitHttpSessionModel()
Deprecated. Default constructor for deserialization.

SplitHttpSessionModel(SplitHttpSessionCollection collection, javax.servlet.http.HttpSession session, java.lang.String sId)
Deprecated. Session creation constructor.

Method Summary

protected void	flush() Deprecated. Flush the changes to this model to whatever data structure (for example, a cache) that is responsible for managing the model's data.
protected NamedCache	getExternalCache() Deprecated. Obtain the cache that holds split-out (external) attribute values.
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 SplitHttpSessionCollection	getSplitHttpSessionCollection() Deprecated. Get the SplitHttpSessionCollection that contains this model.
protected AttributeHolder	instantiateAttributeHolder() Deprecated. Factory method: Instantiate an AttributeHolder for deserialization purposes.
protected AttributeHolder	instantiateAttributeHolder(java.lang.String sName, java.lang.Object oValue) Deprecated. Factory method: Instantiate an AttributeHolder to manage the passed value.
protected void	remapExternalAttributes(java.lang.String sIdNew) Deprecated. Copy all attributes which are stored in an external cache so that the attribute key reflects the new session id.
protected void	removeExternalAttribute(java.lang.Object oKey) Deprecated. Removes an external attribute from the external cache.
protected void	removeExternalAttributes() Deprecated. Helper method used to forcefully remove all external attributes from the external attribute cache.
protected void	setCollection(AbstractHttpSessionCollection collection) Deprecated. After deserialization, the collection needs to be configured.
protected void	setExternalBinary(java.lang.Object oKey, Binary binValue) Deprecated. Adds this binary value to the temporary map for flushing.
java.lang.String	toString() Deprecated. Returns a string representation of the object.
protected void	unbind() Deprecated. Unbind session attributes.

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

activate, addEnteredThread, bind, checkActive, checkUsable, checkValid, discard, enter, exit, extractAttributeName, extractAttributeNames, getActualAttributeMap, getAttribute, getAttributeMap, getAttributeNameArray, getCollection, getCreationTime, getDescription, getEnteredThreads, getHttpSession, getId, getLastAccessedTime, getLastFlushedTime, getLocalAttributeMap, getMaxInactiveInterval, getNewId, getReferenceCount, getThreadOwner, getVersion, isActivatableAttributes, isActive, isExpired, isExpiredInternal, isImmutable, isLastAccessTimeFlushRequired, isLocal, isModified, isNew, isOwnedByThisThread, isUsable, isValid, logAttributeSerializationFailure, obtainThreadOwnership, passivate, qualifyAttributeName, readAttributes, readExternal, readExternal, releaseThreadOwnership, removeAttribute, removeEnteredThread, sessionReturned, setActivatableAttributes, setAttribute, setHttpSession, setId, setLastAccessedTime, setLastFlushedTime, setMaxInactiveInterval, setModified, setNewId, setValid, setVersion, touch, unbind, writeAttributes, writeExternal, writeExternal

Field Detail

SESSION_ID_EXTRACTOR

protected static ValueExtractor SESSION_ID_EXTRACTOR

Deprecated.

ValueExtractor that can be used to extract the session ID from an external attribute key.

Constructor Detail

SplitHttpSessionModel

public SplitHttpSessionModel()

Deprecated.

Default constructor for deserialization.

SplitHttpSessionModel

public SplitHttpSessionModel(SplitHttpSessionCollection collection,
                             javax.servlet.http.HttpSession session,
                             java.lang.String sId)

Deprecated.

Session creation constructor.

Parameters:

collection - the collection that manages this model

session - the session that delegates to this model

sId - the session ID

Method Detail

toString

public java.lang.String toString()

Deprecated.

Returns a string representation of the object.

Overrides:

toString in class TraditionalHttpSessionModel

Returns:

a string representation of the object

unbind

protected void unbind()

Deprecated.

Unbind session attributes.

This method may only be called by a thread that owns this model. See AbstractHttpSessionCollection.obtainThreadOwnership(java.lang.String).

Overrides:

unbind in class AbstractHttpSessionModel

flush

protected void flush()

Deprecated.

Flush the changes to this model to whatever data structure (for example, a cache) that is responsible for managing the model's data.

This method may only be called by a thread that owns this model. See AbstractHttpSessionCollection.obtainThreadOwnership(java.lang.String).

Overrides:

flush in class AbstractHttpSessionModel

setCollection

protected void setCollection(AbstractHttpSessionCollection collection)

Deprecated.

After deserialization, the collection needs to be configured.

Overrides:

setCollection in class AbstractHttpSessionModel

Parameters:

collection - the AbstractHttpSessionCollection that this model belongs to

getSplitHttpSessionCollection

protected SplitHttpSessionCollection getSplitHttpSessionCollection()

Deprecated.

Get the SplitHttpSessionCollection that contains this model.

Returns:

the SplitHttpSessionCollection that contains this model

removeExternalAttributes

protected void removeExternalAttributes()

Deprecated.

Helper method used to forcefully remove all external attributes from the external attribute cache.

setExternalBinary

protected void setExternalBinary(java.lang.Object oKey,
                                 Binary binValue)

Deprecated.

Adds this binary value to the temporary map for flushing.

Parameters:

oKey - The attribute name

binValue - The binary value

removeExternalAttribute

protected void removeExternalAttribute(java.lang.Object oKey)

Deprecated.

Removes an external attribute from the external cache.

Parameters:

oKey -

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

getExternalCache

protected NamedCache getExternalCache()

Deprecated.

Obtain the cache that holds split-out (external) attribute values.

Returns:

the cache that holds split-out (external) attribute values

remapExternalAttributes

protected void remapExternalAttributes(java.lang.String sIdNew)

Deprecated.

Copy all attributes which are stored in an external cache so that the attribute key reflects the new session id.

Parameters:

sIdNew - the new session id

instantiateAttributeHolder

protected AttributeHolder instantiateAttributeHolder()

Deprecated.

Factory method: Instantiate an AttributeHolder for deserialization purposes.

Overrides:

instantiateAttributeHolder in class TraditionalHttpSessionModel

Returns:

a new AttributeHolder that can be deserialized into

instantiateAttributeHolder

protected AttributeHolder instantiateAttributeHolder(java.lang.String sName,
                                                     java.lang.Object oValue)

Deprecated.

Factory method: Instantiate an AttributeHolder to manage the passed value.

Overrides:

instantiateAttributeHolder in class TraditionalHttpSessionModel

Parameters:

sName - the attribute name

oValue - a non-null Object value

Returns:

a new AttributeHolder that will manage the passed value

Skip navigation links