Class DefaultContext
- java.lang.Object
-
- org.apache.avalon.framework.context.DefaultContext
-
- All Implemented Interfaces:
Context
public class DefaultContext extends java.lang.Object implements Context
Default implementation of Context. This implementation is a static hierarchial store.- Version:
- CVS $Revision: 1.25 $ $Date: 2003/02/11 15:58:40 $
- Author:
- Avalon Development Team
-
-
Constructor Summary
Constructors Constructor Description DefaultContext()
Create a Context with no parent.DefaultContext(java.util.Map contextData)
Create a Context with specified data.DefaultContext(java.util.Map contextData, Context parent)
Create a Context with specified data and parent.DefaultContext(Context parent)
Create a Context with specified parent.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
checkWriteable()
Utility method to check if context is writeable and if not throw exception.java.lang.Object
get(java.lang.Object key)
Retrieve an item from the Context.protected java.util.Map
getContextData()
Utility method to retrieve context data.protected Context
getParent()
Get parent context if any.void
hide(java.lang.Object key)
Hides the item in the context.void
makeReadOnly()
Make the context read-only.void
put(java.lang.Object key, java.lang.Object value)
Helper method fo adding items to Context.
-
-
-
Constructor Detail
-
DefaultContext
public DefaultContext(java.util.Map contextData, Context parent)
Create a Context with specified data and parent.- Parameters:
contextData
- the context dataparent
- the parent Context (may be null)
-
DefaultContext
public DefaultContext(java.util.Map contextData)
Create a Context with specified data.- Parameters:
contextData
- the context data
-
DefaultContext
public DefaultContext(Context parent)
Create a Context with specified parent.- Parameters:
parent
- the parent Context (may be null)
-
DefaultContext
public DefaultContext()
Create a Context with no parent.
-
-
Method Detail
-
get
public java.lang.Object get(java.lang.Object key) throws ContextException
Retrieve an item from the Context.- Specified by:
get
in interfaceContext
- Parameters:
key
- the key of item- Returns:
- the item stored in context
- Throws:
ContextException
- if item not present
-
put
public void put(java.lang.Object key, java.lang.Object value) throws java.lang.IllegalStateException
Helper method fo adding items to Context.- Parameters:
key
- the items keyvalue
- the item- Throws:
java.lang.IllegalStateException
- if context is read only
-
hide
public void hide(java.lang.Object key) throws java.lang.IllegalStateException
Hides the item in the context. After remove(key) has been called, a get(key) will always fail, even if the parent context has such a mapping.- Parameters:
key
- the items key- Throws:
java.lang.IllegalStateException
- if context is read only
-
getContextData
protected final java.util.Map getContextData()
Utility method to retrieve context data.- Returns:
- the context data
-
getParent
protected final Context getParent()
Get parent context if any.- Returns:
- the parent Context (may be null)
-
makeReadOnly
public void makeReadOnly()
Make the context read-only. Any attempt to write to the context via put() will result in an IllegalStateException.
-
checkWriteable
protected final void checkWriteable() throws java.lang.IllegalStateException
Utility method to check if context is writeable and if not throw exception.- Throws:
java.lang.IllegalStateException
- if context is read only
-
-