org.apache.struts.tiles.actions
Class DefinitionDispatcherAction

java.lang.Object
  |
  +--org.apache.struts.action.Action
        |
        +--org.apache.struts.tiles.actions.DefinitionDispatcherAction

public final class DefinitionDispatcherAction
extends org.apache.struts.action.Action

An Action that dispatches to a Tiles Definition that is named by the request parameter whose name is specified by the parameter property of the corresponding ActionMapping. This action is usefull in following situations :

  • To configure the use of this action in your struts-config.xml file, create an entry like this:

    <action path="/saveSubscription" type="org.apache.struts.tiles.actions.DefinitionDispatcherAction" parameter="def"/> <forward name="success" path="anything" //> <forward name="error" path="path.to.error.page" //>

    which will use the value of the request parameter named "def" to pick the appropriate definition name.

    The value for success doesn't matter. The forward will forward to appropriate definition.

    The value for error should denote a valid jsp path or definition name.

    Version:
    $Revision: 1.3 $ $Date: 2002/10/10 16:32:27 $
    Author:
    Niall Pemberton , Craig R. McClanahan, Cedric Dumoulin

    Field Summary
    protected static org.apache.commons.logging.Log log
              Commons Logging instance.
     
    Fields inherited from class org.apache.struts.action.Action
    ACTION_SERVLET_KEY, APPLICATION_KEY, DATA_SOURCE_KEY, defaultLocale, ERROR_KEY, EXCEPTION_KEY, FORM_BEANS_KEY, FORWARDS_KEY, LOCALE_KEY, MAPPING_KEY, MAPPINGS_KEY, MESSAGE_KEY, MESSAGES_KEY, MULTIPART_KEY, PLUG_INS_KEY, REQUEST_PROCESSOR_KEY, servlet, SERVLET_KEY, TRANSACTION_TOKEN_KEY
     
    Constructor Summary
    DefinitionDispatcherAction()
               
     
    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)
              Process the specified HTTP request, and create the corresponding HTTP response (or forward to another web component that will create it), with provision for handling exceptions thrown by the business logic.
    protected  void printError(javax.servlet.http.HttpServletResponse response, java.lang.String msg)
               
     
    Methods inherited from class org.apache.struts.action.Action
    execute, generateToken, getDataSource, getDataSource, getLocale, getResources, getResources, getResources, getServlet, isCancelled, isTokenValid, isTokenValid, perform, perform, resetToken, saveErrors, saveMessages, saveToken, setLocale, setServlet, toHex
     
    Methods inherited from class java.lang.Object
    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
     

    Field Detail

    log

    protected static org.apache.commons.logging.Log log
    Commons Logging instance.

    Constructor Detail

    DefinitionDispatcherAction

    public DefinitionDispatcherAction()
    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
    Process the specified HTTP request, and create the corresponding HTTP response (or forward to another web component that will create it), with provision for handling exceptions thrown by the business logic.

    Overrides:
    execute in class org.apache.struts.action.Action
    Parameters:
    mapping - The ActionMapping used to select this instance
    form - The optional ActionForm bean for this request (if any)
    request - The HTTP request we are processing
    response - The HTTP response we are creating
    Throws:
    java.lang.Exception - if the application business logic throws an exception
    Since:
    Struts 1.1

    printError

    protected void printError(javax.servlet.http.HttpServletResponse response,
                              java.lang.String msg)
                       throws java.io.IOException
    java.io.IOException


    Copyright 2000-2002 - Cedric Dumoulin and Apache Software Foundation