com.opensymphony.xwork2
Class ActionContext

java.lang.Object
  extended by com.opensymphony.xwork2.ActionContext
All Implemented Interfaces:
java.io.Serializable

public class ActionContext
extends java.lang.Object
implements java.io.Serializable

The ActionContext is the context in which an Action is executed. Each context is basically a container of objects an action needs for execution like the session, parameters, locale, etc.

The ActionContext is thread local which means that values stored in the ActionContext are unique per thread. See the ThreadLocal class for more information. The benefit of this is you don't need to worry about a user specific action context, you just get it:

Finally, because of the thread local usage you don't need to worry about making your actions thread safe.

Author:
Patrick Lightbody, Bill Lynch (docs)
See Also:
Serialized Form

Field Summary
static java.lang.String ACTION_INVOCATION
          Constant for the action's invocation context.
static java.lang.String ACTION_NAME
          Constant for the name of the action being executed.
static java.lang.String APPLICATION
          Constant for the action's application context.
static java.lang.String CONTAINER
          Constant for the container
static java.lang.String CONVERSION_ERRORS
          Constant for the map of type conversion errors.
static java.lang.String LOCALE
          Constant for the action's locale.
static java.lang.String PARAMETERS
          Constant for the action's parameters.
static java.lang.String SESSION
          Constant for the action's session.
static java.lang.String TYPE_CONVERTER
          Constant for the action's type converter.
static java.lang.String VALUE_STACK
          Constant for the OGNL value stack.
 
Constructor Summary
ActionContext(java.util.Map<java.lang.String,java.lang.Object> context)
          Creates a new ActionContext initialized with another context.
 
Method Summary
 java.lang.Object get(java.lang.String key)
          Returns a value that is stored in the current ActionContext by doing a lookup using the value's key.
 ActionInvocation getActionInvocation()
          Gets the action invocation (the execution state).
 java.util.Map<java.lang.String,java.lang.Object> getApplication()
          Returns a Map of the ServletContext when in a servlet environment or a generic application level Map otherwise.
 Container getContainer()
          Sets the container for this request
static ActionContext getContext()
          Returns the ActionContext specific to the current thread.
 java.util.Map<java.lang.String,java.lang.Object> getContextMap()
          Gets the context map.
 java.util.Map<java.lang.String,java.lang.Object> getConversionErrors()
          Gets the map of conversion errors which occurred when executing the action.
<T> T
getInstance(java.lang.Class<T> type)
           
 java.util.Locale getLocale()
          Gets the Locale of the current action.
 java.lang.String getName()
          Gets the name of the current Action.
 java.util.Map<java.lang.String,java.lang.Object> getParameters()
          Returns a Map of the HttpServletRequest parameters when in a servlet environment or a generic Map of parameters otherwise.
 java.util.Map<java.lang.String,java.lang.Object> getSession()
          Gets the Map of HttpSession values when in a servlet environment or a generic session map otherwise.
 ValueStack getValueStack()
          Gets the OGNL value stack.
 void put(java.lang.String key, java.lang.Object value)
          Stores a value in the current ActionContext.
 void setActionInvocation(ActionInvocation actionInvocation)
          Sets the action invocation (the execution state).
 void setApplication(java.util.Map<java.lang.String,java.lang.Object> application)
          Sets the action's application context.
 void setContainer(Container cont)
          Gets the container for this request
static void setContext(ActionContext context)
          Sets the action context for the current thread.
 void setContextMap(java.util.Map<java.lang.String,java.lang.Object> contextMap)
          Sets the action's context map.
 void setConversionErrors(java.util.Map<java.lang.String,java.lang.Object> conversionErrors)
          Sets conversion errors which occurred when executing the action.
 void setLocale(java.util.Locale locale)
          Sets the Locale for the current action.
 void setName(java.lang.String name)
          Sets the name of the current Action in the ActionContext.
 void setParameters(java.util.Map<java.lang.String,java.lang.Object> parameters)
          Sets the action parameters.
 void setSession(java.util.Map<java.lang.String,java.lang.Object> session)
          Sets a map of action session values.
 void setValueStack(ValueStack stack)
          Sets the OGNL value stack.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ACTION_NAME

public static final java.lang.String ACTION_NAME
Constant for the name of the action being executed.

See Also:
Constant Field Values

VALUE_STACK

public static final java.lang.String VALUE_STACK
Constant for the OGNL value stack.

See Also:
Constant Field Values

SESSION

public static final java.lang.String SESSION
Constant for the action's session.

See Also:
Constant Field Values

APPLICATION

public static final java.lang.String APPLICATION
Constant for the action's application context.

See Also:
Constant Field Values

PARAMETERS

public static final java.lang.String PARAMETERS
Constant for the action's parameters.

See Also:
Constant Field Values

LOCALE

public static final java.lang.String LOCALE
Constant for the action's locale.

See Also:
Constant Field Values

TYPE_CONVERTER

public static final java.lang.String TYPE_CONVERTER
Constant for the action's type converter.

See Also:
Constant Field Values

ACTION_INVOCATION

public static final java.lang.String ACTION_INVOCATION
Constant for the action's invocation context.

See Also:
Constant Field Values

CONVERSION_ERRORS

public static final java.lang.String CONVERSION_ERRORS
Constant for the map of type conversion errors.

See Also:
Constant Field Values

CONTAINER

public static final java.lang.String CONTAINER
Constant for the container

See Also:
Constant Field Values
Constructor Detail

ActionContext

public ActionContext(java.util.Map<java.lang.String,java.lang.Object> context)
Creates a new ActionContext initialized with another context.

Parameters:
context - a context map.
Method Detail

setActionInvocation

public void setActionInvocation(ActionInvocation actionInvocation)
Sets the action invocation (the execution state).

Parameters:
actionInvocation - the action execution state.

getActionInvocation

public ActionInvocation getActionInvocation()
Gets the action invocation (the execution state).

Returns:
the action invocation (the execution state).

setApplication

public void setApplication(java.util.Map<java.lang.String,java.lang.Object> application)
Sets the action's application context.

Parameters:
application - the action's application context.

getApplication

public java.util.Map<java.lang.String,java.lang.Object> getApplication()
Returns a Map of the ServletContext when in a servlet environment or a generic application level Map otherwise.

Returns:
a Map of ServletContext or generic application level Map

setContext

public static void setContext(ActionContext context)
Sets the action context for the current thread.

Parameters:
context - the action context.

getContext

public static ActionContext getContext()
Returns the ActionContext specific to the current thread.

Returns:
the ActionContext for the current thread, is never null.

setContextMap

public void setContextMap(java.util.Map<java.lang.String,java.lang.Object> contextMap)
Sets the action's context map.

Parameters:
contextMap - the context map.

getContextMap

public java.util.Map<java.lang.String,java.lang.Object> getContextMap()
Gets the context map.

Returns:
the context map.

setConversionErrors

public void setConversionErrors(java.util.Map<java.lang.String,java.lang.Object> conversionErrors)
Sets conversion errors which occurred when executing the action.

Parameters:
conversionErrors - a Map of errors which occurred when executing the action.

getConversionErrors

public java.util.Map<java.lang.String,java.lang.Object> getConversionErrors()
Gets the map of conversion errors which occurred when executing the action.

Returns:
the map of conversion errors which occurred when executing the action or an empty map if there were no errors.

setLocale

public void setLocale(java.util.Locale locale)
Sets the Locale for the current action.

Parameters:
locale - the Locale for the current action.

getLocale

public java.util.Locale getLocale()
Gets the Locale of the current action. If no locale was ever specified the platform's default locale is used.

Returns:
the Locale of the current action.

setName

public void setName(java.lang.String name)
Sets the name of the current Action in the ActionContext.

Parameters:
name - the name of the current action.

getName

public java.lang.String getName()
Gets the name of the current Action.

Returns:
the name of the current action.

setParameters

public void setParameters(java.util.Map<java.lang.String,java.lang.Object> parameters)
Sets the action parameters.

Parameters:
parameters - the parameters for the current action.

getParameters

public java.util.Map<java.lang.String,java.lang.Object> getParameters()
Returns a Map of the HttpServletRequest parameters when in a servlet environment or a generic Map of parameters otherwise.

Returns:
a Map of HttpServletRequest parameters or a multipart map when in a servlet environment, or a generic Map of parameters otherwise.

setSession

public void setSession(java.util.Map<java.lang.String,java.lang.Object> session)
Sets a map of action session values.

Parameters:
session - the session values.

getSession

public java.util.Map<java.lang.String,java.lang.Object> getSession()
Gets the Map of HttpSession values when in a servlet environment or a generic session map otherwise.

Returns:
the Map of HttpSession values when in a servlet environment or a generic session map otherwise.

setValueStack

public void setValueStack(ValueStack stack)
Sets the OGNL value stack.

Parameters:
stack - the OGNL value stack.

getValueStack

public ValueStack getValueStack()
Gets the OGNL value stack.

Returns:
the OGNL value stack.

setContainer

public void setContainer(Container cont)
Gets the container for this request

Parameters:
cont - The container

getContainer

public Container getContainer()
Sets the container for this request

Returns:
The container

getInstance

public <T> T getInstance(java.lang.Class<T> type)

get

public java.lang.Object get(java.lang.String key)
Returns a value that is stored in the current ActionContext by doing a lookup using the value's key.

Parameters:
key - the key used to find the value.
Returns:
the value that was found using the key or null if the key was not found.

put

public void put(java.lang.String key,
                java.lang.Object value)
Stores a value in the current ActionContext. The value can be looked up using the key.

Parameters:
key - the key of the value.
value - the value to be stored.


Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.