Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


com.tangosol.coherence.servlet
Class SplitHttpSessionModel

java.lang.Object
  extended by com.tangosol.util.Base
      extended by com.tangosol.coherence.servlet.AbstractHttpSessionModel
          extended by com.tangosol.coherence.servlet.TraditionalHttpSessionModel
              extended by 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 Binary NO_BINARY
          Deprecated. Special empty binary value used to optimize memory consumption when suspect attribute detection is disabled.
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
ENTRY_ARRAY, 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 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, getReferenceCount, getThreadOwner, getVersion, isActivatableAttributes, isActive, isExpired, isExpiredInternal, isImmutable, isLastAccessTimeFlushRequired, isLocal, isModified, isNew, isOwnedByThisThread, isUsable, isValid, logAttributeSerializationFailure, makeDistributed, obtainThreadOwnership, passivate, qualifyAttributeName, readAttributes, readExternal, readExternal, releaseThreadOwnership, removeAttribute, removeEnteredThread, sessionReturned, setActivatableAttributes, setAttribute, setHttpSession, setId, setLastAccessedTime, setLastFlushedTime, setMaxInactiveInterval, setModified, 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.

NO_BINARY

protected static final Binary NO_BINARY
Deprecated. 
Special empty binary value used to optimize memory consumption when suspect attribute detection is disabled.

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

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

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.