org.apache.struts.chain.legacy
Class DispatchAction

java.lang.Object
  org.apache.struts.action.Action
      org.apache.struts.chain.legacy.DispatchAction

public class DispatchAction

extends org.apache.struts.action.Action

An Action implementation that delegates to a Chain (or Command) that is specified by a request parameter whose name is configured in the parameter attribute of the <action> element configuring this action. For example:

   <action path="/myaction"
           type="org.apache.struts.chain.legacy.DispatchAction"
           name="myform"
          scope="request"
          input="/mypage.jsp"
      parameter="name-of-request-parameter"
 

Prior to calling the specified chain (or command), this action sets up a Context object containing the relevant properties, along with the following additional attributes:

• mapping - The ActionMapping passed to our execute() method
• form - The ActionForm passed to our execute() method

After execution of the specified command or chain is completed, the following context attributes are examined (in this order) to determine how to proceed.

• exception - If a java.lang.Exception is found here, it will be rethrown as the outcome of this action.
• forward - If an org.apache.struts.action.ActionForward is found here, it will be returned as the outcome of this action. Otherwise, null will be returned.

Field Summary

private org.apache.commons.chain.Catalog

catalog The Catalog that will be consulted to look up the Command to be executed.

Fields inherited from class org.apache.struts.action.Action

defaultLocale, servlet

Constructor Summary

DispatchAction()

Method Summary

org.apache.struts.action.ActionForward	execute(org.apache.struts.action.ActionMapping mapping, org.apache.struts.action.ActionForm form, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Delegate to the command chain specified in our configuration.
protected org.apache.commons.chain.Catalog	getCatalog() Return the Catalog we will use to acquire the Command to be executed.

Methods inherited from class org.apache.struts.action.Action

addErrors, addMessages, execute, generateToken, getDataSource, getDataSource, getErrors, getLocale, getMessages, getResources, getResources, getServlet, isCancelled, isTokenValid, isTokenValid, resetToken, saveErrors, saveErrors, saveErrors, saveMessages, saveMessages, saveToken, setLocale, setServlet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

catalog

private org.apache.commons.chain.Catalog catalog

The Catalog that will be consulted to look up the Command to be executed.

Constructor Detail

DispatchAction

public DispatchAction()

Method Detail

execute

public org.apache.struts.action.ActionForward execute(org.apache.struts.action.ActionMapping mapping,
                                                      org.apache.struts.action.ActionForm form,
                                                      javax.servlet.http.HttpServletRequest request,
                                                      javax.servlet.http.HttpServletResponse response)
                                               throws java.lang.Exception

Delegate to the command chain specified in our configuration.

Parameters:

mapping - ActionMapping configuring this action

form - ActionForm for this request (if any)

request - HttpServletRequest we are processing

response - HttpServletResponse we are creating

Throws:

java.lang.Exception

getCatalog

protected org.apache.commons.chain.Catalog getCatalog()

Return the Catalog we will use to acquire the Command to be executed. NOTE: Any race condition calling this method is harmless, so do not bother to synchronize.