Class ChainingInterceptor

  extended by com.opensymphony.xwork2.interceptor.AbstractInterceptor
      extended by com.opensymphony.xwork2.interceptor.ChainingInterceptor
All Implemented Interfaces:
Interceptor, Serializable

public class ChainingInterceptor
extends AbstractInterceptor

An interceptor that copies all the properties of every object in the value stack to the currently executing object, except for any object that implements Unchainable. A collection of optional includes and excludes may be provided to control how and which parameters are copied. Only includes or excludes may be specified. Specifying both results in undefined behavior. See the javadocs for ReflectionProvider.copy(Object, Object, java.util.Map, java.util.Collection, java.util.Collection) for more information.

Note: It is important to remember that this interceptor does nothing if there are no objects already on the stack.
This means two things:
One, you can safely apply it to all your actions without any worry of adverse affects.
Two, it is up to you to ensure an object exists in the stack prior to invoking this action. The most typical way this is done is through the use of the chain result type, which combines with this interceptor to make up the action chaining feature.

Interceptor parameters:

Extending the interceptor:

There are no known extension points to this interceptor.

Example code:

 <action name="someAction" class="com.examples.SomeAction">
     <interceptor-ref name="basicStack"/>
     <result name="success" type="chain">otherAction</result>

 <action name="otherAction" class="com.examples.OtherAction">
     <interceptor-ref name="chain"/>
     <interceptor-ref name="basicStack"/>
     <result name="success">good_result.ftl</result>

mrdon, tm_jee ( tm_jee(at) )
See Also:
ActionChainResult, Serialized Form

Field Summary
protected  Collection<String> excludes
protected  Collection<String> includes
private static Logger LOG
protected  ReflectionProvider reflectionProvider
Constructor Summary
Method Summary
 Collection<String> getExcludes()
          Gets list of parameter names to exclude
 Collection<String> getIncludes()
          Gets list of parameter names to include
 String intercept(ActionInvocation invocation)
          Override to handle interception
 void setExcludes(Collection<String> excludes)
          Sets the list of parameter names to exclude from copying (all others will be included).
 void setIncludes(Collection<String> includes)
          Sets the list of parameter names to include when copying (all others will be excluded).
 void setReflectionProvider(ReflectionProvider prov)
Methods inherited from class com.opensymphony.xwork2.interceptor.AbstractInterceptor
destroy, init
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


private static final Logger LOG


protected Collection<String> excludes


protected Collection<String> includes


protected ReflectionProvider reflectionProvider
Constructor Detail


public ChainingInterceptor()
Method Detail


public void setReflectionProvider(ReflectionProvider prov)


public String intercept(ActionInvocation invocation)
                 throws Exception
Description copied from class: AbstractInterceptor
Override to handle interception

Specified by:
intercept in interface Interceptor
Specified by:
intercept in class AbstractInterceptor
invocation - the action invocation
the return code, either returned from ActionInvocation.invoke(), or from the interceptor itself.
Exception - any system-level error, as defined in Action.execute().


public Collection<String> getExcludes()
Gets list of parameter names to exclude

the exclude list


public void setExcludes(Collection<String> excludes)
Sets the list of parameter names to exclude from copying (all others will be included).

excludes - the excludes list


public Collection<String> getIncludes()
Gets list of parameter names to include

the include list


public void setIncludes(Collection<String> includes)
Sets the list of parameter names to include when copying (all others will be excluded).

includes - the includes list

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