Class DefaultWorkflowInterceptor
- All Implemented Interfaces:
- Serializable,- ConditionalInterceptor,- Interceptor
An interceptor that makes sure there are not validation, conversion or action errors before allowing the interceptor chain to continue. If a single FieldError or ActionError (including the ones replicated by the Message Store Interceptor in a redirection) is found, the INPUT result will be triggered. This interceptor does not perform any validation.
This interceptor does nothing if the name of the method being invoked is specified in the excludeMethods parameter. excludeMethods accepts a comma-delimited list of method names. For example, requests to foo!input.action and foo!back.action will be skipped by this interceptor if you set the excludeMethods parameter to "input, back".
 Note: As this method extends off MethodFilterInterceptor, it is capable of
 deciding if it is applicable only to selective methods in the action class. This is done by adding param tags
 for the interceptor element, naming either a list of excluded method names and/or a list of included method
 names, whereby includeMethods overrides excludedMethods. A single * sign is interpreted as wildcard matching
 all methods for both parameters.
 See MethodFilterInterceptor for more info.
 
This interceptor also supports the following interfaces which can implemented by actions:
- ValidationAware - implemented by ActionSupport class
- ValidationWorkflowAware - allows changing result name programmatically
- ValidationErrorAware - notifies action about errors and also allow change result name
You can also use InputConfig annotation to change result name returned when validation errors occurred.
Interceptor parameters:
- inputResultName - Default to "input". Determine the result name to be returned when an action / field error is found.
Extending the interceptor:
There are no known extension points for this interceptor.
Example code:
 
 <action name="someAction" class="com.examples.SomeAction">
     <interceptor-ref name="params"/>
     <interceptor-ref name="validation"/>
     <interceptor-ref name="workflow"/>
     <result name="success">good_result.ftl</result>
 </action>
 <-- In this case myMethod as well as mySecondMethod of the action class
        will not pass through the workflow process -->
 <action name="someAction" class="com.examples.SomeAction">
     <interceptor-ref name="params"/>
     <interceptor-ref name="validation"/>
     <interceptor-ref name="workflow">
         <param name="excludeMethods">myMethod,mySecondMethod</param>
     </interceptor-ref name="workflow">
     <result name="success">good_result.ftl</result>
 </action>
 <-- In this case, the result named "error" will be used when
        an action / field error is found -->
 <-- The Interceptor will only be applied for myWorkflowMethod method of action
        classes, since this is the only included method while any others are excluded -->
 <action name="someAction" class="com.examples.SomeAction">
     <interceptor-ref name="params"/>
     <interceptor-ref name="validation"/>
     <interceptor-ref name="workflow">
        <param name="inputResultName">error</param>
         <param name="excludeMethods">*</param>
         <param name="includeMethods">myWorkflowMethod</param>
     </interceptor-ref>
     <result name="success">good_result.ftl</result>
 </action>
 
 - Author:
- Jason Carreira, Rainer Hermanns, Alexandru Popescu, Philip Luppens, tm_jee
- See Also:
- 
Field SummaryFields inherited from class org.apache.struts2.interceptor.MethodFilterInterceptorexcludeMethods, includeMethods
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected StringdoIntercept(ActionInvocation invocation) InterceptActionInvocationand returns ainputResultNamewhen action / field errors is found registered.protected StringprocessInputConfig(Object action, String method, String currentResultName) ProcessInputConfigannotation applied to methodprotected StringprocessValidationErrorAware(Object action, String currentResultName) Notify action if it implementsValidationErrorAwareinterfacevoidsetInputResultName(String inputResultName) Set theinputResultName(result name to be returned when a action / field error is found registered).Methods inherited from class org.apache.struts2.interceptor.MethodFilterInterceptorapplyInterceptor, getExcludeMethodsSet, getIncludeMethodsSet, intercept, setExcludeMethods, setIncludeMethodsMethods inherited from class org.apache.struts2.interceptor.AbstractInterceptordestroy, init, setDisabled, shouldIntercept
- 
Constructor Details- 
DefaultWorkflowInterceptorpublic DefaultWorkflowInterceptor()
 
- 
- 
Method Details- 
setInputResultNameSet theinputResultName(result name to be returned when a action / field error is found registered). Default toAction.INPUT- Parameters:
- inputResultName- what result name to use when there was validation error(s).
 
- 
doInterceptInterceptActionInvocationand returns ainputResultNamewhen action / field errors is found registered.- Specified by:
- doInterceptin class- MethodFilterInterceptor
- Parameters:
- invocation- the action invocation
- Returns:
- String result name
- Throws:
- Exception- in case of any errors
 
- 
processInputConfigprotected String processInputConfig(Object action, String method, String currentResultName) throws Exception ProcessInputConfigannotation applied to method- Parameters:
- action- action object
- method- method
- currentResultName- current result name
- Returns:
- result name
- Throws:
- Exception- in case of any errors
 
- 
processValidationErrorAwareNotify action if it implementsValidationErrorAwareinterface- Parameters:
- action- action object
- currentResultName- current result name
- Returns:
- result name
- See Also:
 
 
-