Struts Configuration Editor - Action Mappings Page

Use to create the <action-mappings> element in the Struts configuration file. This is one of the two most important elements used to describe a form action (the other is the <form-beans> element). The action mapping describes your application's possible actions. Use this page to create an <action> element for each action you would like to define.

Action Mappings: The list of existing <action> definitions in the Struts configuration file. Click Add to create a new action definition or click D elete to remove an existing one from the list.

General

Use to modify the properties of the <action> definition in the Struts configuration file.

Path

The request URI path which, when received by the Struts servlet action controller, invokes the action mapping. The path name is a relative path and must include the forward slash (/). For example, to trigger an action for the logon.jsp page, you would specify the path /logon. Click Browse to choose an existing .jsp from your Struts project.

Parameter

A general purpose configuration parameter. You can use this to pass information to the action instance selected by the action mapping.

Classname

Optional, the fully qualified Java classname of your action mapping class.

Unknown

Optional, set to true if this action should be configured as the default for this application, to handle all requests not handled by another action. Only one action can be defined as a default within a single application.

Type

The fully qualified Java classname of the action handler used to process the request. Alternatively, you may choose to process using Forward or Include. Click Browse to choose an existing action handler from your Struts project.

Forward: The path of the servlet or JSP used to process the request (instead of using the action handler specified by Type or processing using Include). The path is is application relative and must include the forward slash (/).
Include: The path of the servlet or JSP used to process the request (instead of using the action handler specified by Type or processing using Forward). The path is is application relative and must include the forward slash (/).

Form Bean

Use to modify the form bean properties of the <action> definition in the struts-config.xml file. This lets you define how the form bean that this action mapping invokes should be used by the Struts action servlet controller. Choose the form bean from the dropdown list.

Name

A dropdown menu that displays the list of existing


            <form-bean>

definitions for the <action> element in the Struts configuration file.

Validate: Optional, select if the validate() method of the form bean associated with this mapping should be called for properties of the form bean. The default is true.
Input: The URI path to which control is passed when a validation error on the form bean occurs. The path name is relative to the application and must include the forward slash (/ ). For example, to pass control to a logon.jsp page, you would specify the path /logon. This may be the same page as the one in the forward control definition to allow the user to view the validation error message and correct the problem.
Scope: Choose the scope (request or session) of the form bean.
Attribute: Enter an attribute name for the request or session scope to be used by the form bean.
Prefix: The prefix used to match request parameter names to form bean property names.
Suffix: The suffix used to match request parameter names to form bean property names.

Forwards

Use to modify the forward properties of the <action> definition in the Struts configuration file. This lets you define local forwards that this action mapping should invoke. Click Add to create a new local forward definition or click Remove to delete an existing local forward definition.

Name: The logical name of the global forward. Your form action handler class uses the logical name in a global forward when the execute() method calls findFoward() on an action mapping instance:
actionMappingInstance.findForward("logicalName") .
Path: The request URI path to which control is passed when the action mapping is invoked for the named local forward. The path name is relative to the application and must include the forward slash (/). For example, to pass control to a logon.jsp page, you would specify the path /logon.
Redirect: Optionally, select when you want to cause the forward to use the redirect action class. Note: This option is not supported for use with Business Components JSP applications that you may create in JDeveloper.
Context-Relative: Optional, select if in a modular application, the path attribute starts with a slash "/" and should be considered relative to the entire web application rather than the module. The default is unselected.
Classname: Optional, the fully qualified Java class name of ActionForward subclass to use for this object, org.apache.struts.action.ActionForward

Exceptions

Use to modify an existing <exceptions> definition for the <action> element in the Struts configuration file. This lets you define local exceptions that exist for this action mapping. Click Add to create a new exception definition or click R emove to remove one you select from the list.

Type

A dropdown menu that displays the list of existing


            <exceptions>

definitions for the <action> element in the Struts configuration file.

Type: The fully qualified classname of the exception that is to be handled. This identifies the exception.
Handler: Optional, the implementation class of the configuration bean (subclass of org.apache.struts.config.ExceptionConfig ) that will hold the exception information.
Path: Optional, the path to a resource to which control is passed when the exception specified in Type occurs. The path name is relative to the application and must include the forward slash (/). Click B rowse to choose an existing resource from your Struts project.
Key: Optional, a message key specified in the resource bundle for the application. The value is used by ActionError.
Scope: Optional, the identifier request or session. Identifies the scope level, where the ActionError should be stored. Request scope is the default.

Properties

Use to modify the <set-property> definitions of an existing <action> definition in the Struts configuration file. This lets you initialize specific properties of the action. Click Add to create a new property definition or click Remove to delete an existing property definition.

Property: The name of the property that your action defines.
Value: The value that you want to to set on the specified property of the action.