Package org.apache.axis2.context
Class AbstractContext
- java.lang.Object
-
- org.apache.axis2.context.AbstractContext
-
- Direct Known Subclasses:
ConfigurationContext,MessageContext,OperationContext,ServiceContext,ServiceGroupContext,SessionContext
public abstract class AbstractContext extends Object
This is the top most level of the Context hierarchy and is a bag of properties.
-
-
Field Summary
Fields Modifier and Type Field Description static StringCOPY_PROPERTIESProperty used to indicate copying of properties is needed by context.protected longlastTouchedTimeprotected AbstractContextparentprotected Map<String,Object>properties
-
Constructor Summary
Constructors Modifier Constructor Description protectedAbstractContext()protectedAbstractContext(AbstractContext parent)
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidclearPropertyDifferences()Once the clustering mechanism transmits the property differences, it should call this method to avoid retransmitting stuff that has already been sent.voidflush()longgetLastTouchedTime()ObjectgetLocalProperty(String key)Retrieves an object given a key.AbstractContextgetParent()Map<String,Object>getProperties()Deprecated.ObjectgetProperty(String key)Retrieves an object given a key.Map<String,Object>getPropertyDifferences()Get the property differences since the last transmission by the clustering mechanismIterator<String>getPropertyNames()An iterator over a collection ofStringobjects, which are the keys in the properties object.ObjectgetPropertyNonReplicable(String key)Retrieves an object given a key.abstract ConfigurationContextgetRootContext()booleanisAncestor(AbstractContext context)voidmergeProperties(Map<String,Object> props)This will do a copy of the given properties to the current properties table.voidremoveProperty(String key)Remove a property.voidremovePropertyNonReplicable(String key)Remove a property.voidsetLastTouchedTime(long t)voidsetNonReplicableProperty(String key, Object value)Store a property in this context.voidsetParent(AbstractContext context)voidsetProperties(Map<String,Object> properties)This will set the properties to the context.voidsetProperty(String key, Object value)Store a property in this contextprotected voidtouch()ServiceContext and ServiceGroupContext are not getting automatically garbage collected.
-
-
-
Field Detail
-
COPY_PROPERTIES
public static final String COPY_PROPERTIES
Property used to indicate copying of properties is needed by context.- See Also:
- Constant Field Values
-
lastTouchedTime
protected long lastTouchedTime
-
parent
protected transient AbstractContext parent
-
-
Constructor Detail
-
AbstractContext
protected AbstractContext(AbstractContext parent)
-
AbstractContext
protected AbstractContext()
-
-
Method Detail
-
getParent
public AbstractContext getParent()
- Returns:
- Returns the parent of this context.
-
isAncestor
public boolean isAncestor(AbstractContext context)
- Parameters:
context-- Returns:
- true if the context is an ancestor
-
getPropertyNames
public Iterator<String> getPropertyNames()
An iterator over a collection ofStringobjects, which are the keys in the properties object.- Returns:
- Iterator over a collection of keys
-
getProperty
public Object getProperty(String key)
Retrieves an object given a key.- Parameters:
key- - if not found, will return null- Returns:
- Returns the property.
-
getLocalProperty
public Object getLocalProperty(String key)
Retrieves an object given a key. Only searches at this level i.e. getLocalProperty on MessageContext does not look in the OperationContext properties map if a local result is not found.- Parameters:
key- - if not found, will return null- Returns:
- Returns the property.
-
getPropertyNonReplicable
public Object getPropertyNonReplicable(String key)
Retrieves an object given a key. The retrieved property will not be replicated to other nodes in the clustered scenario.- Parameters:
key- - if not found, will return null- Returns:
- Returns the property.
-
setProperty
public void setProperty(String key, Object value)
Store a property in this context- Parameters:
key-value-
-
setNonReplicableProperty
public void setNonReplicableProperty(String key, Object value)
Store a property in this context. But these properties should not be replicated when Axis2 is clustered.- Parameters:
key-value-
-
removeProperty
public void removeProperty(String key)
Remove a property. Only properties at this level will be removed. Properties of the parents cannot be removed using this method.- Parameters:
key-
-
removePropertyNonReplicable
public void removePropertyNonReplicable(String key)
Remove a property. Only properties at this level will be removed. Properties of the parents cannot be removed using this method. The removal of the property will not be replicated when Axis2 is clustered.- Parameters:
key-
-
getPropertyDifferences
public Map<String,Object> getPropertyDifferences()
Get the property differences since the last transmission by the clustering mechanism- Returns:
- The property differences
-
clearPropertyDifferences
public void clearPropertyDifferences()
Once the clustering mechanism transmits the property differences, it should call this method to avoid retransmitting stuff that has already been sent.
-
setParent
public void setParent(AbstractContext context)
- Parameters:
context-
-
setProperties
public void setProperties(Map<String,Object> properties)
This will set the properties to the context. But in setting that one may need to "copy" all the properties from the source properties to the target properties. To enable this we introduced a property (COPY_PROPERTIES) so that if set to true, this code will copy the whole thing, without just referencing to the source.- Parameters:
properties-
-
mergeProperties
public void mergeProperties(Map<String,Object> props)
This will do a copy of the given properties to the current properties table.- Parameters:
props- The table of properties to copy
-
touch
protected void touch()
ServiceContext and ServiceGroupContext are not getting automatically garbage collected. And there is no specific way for some one to go and make it garbage collectible. So the current solution is to make them time out. So the logic is that, there is a timer task in each and every service group which will check for the last touched time. And if it has not been touched for some time, the timer task will remove it from the memory. The touching logic happens like this. Whenever there is a call to addMessageContext in the operationContext it will go and update operationCOntext -> serviceContext -> serviceGroupContext.
-
getLastTouchedTime
public long getLastTouchedTime()
-
setLastTouchedTime
public void setLastTouchedTime(long t)
-
getRootContext
public abstract ConfigurationContext getRootContext()
-
-