About the Struts Page Flow Diagram Elements

Icons appear in the Component Palette, Page Flow Diagram, Application Navigator, and Structure window as you develop a page flow. These icons represent elements in a Struts configuration file, and some related items that you can add to a Struts Page Flow Diagram.

action_icon Action

Represents the <action> element ( org.apache.struts.action.Action) in the Struts configutation file. An Action is an adapter between the contents of an incoming HTTP request and the corresponding business logic that should be executed to process this request. The action package is the core of the Struts framework, representing the Controller layer of a MVC model.

The icon you initially insert into the Page Flow Modeler diagram has a yellow warning icon overlaid, as shown:

action icon with overlay

This indicates that you have not yet associated an action class with the action element. After you double-click and associate and action class with the element, the icon appears appear without the warning icon.

actionwithinclude_icon Action with Include

Represents the <action> element ( org.apache.struts.action.Action) in the Struts configutation file. This icon only appears in the Page Flow Diagram after you set the value for the include attribute of an action. The value of the include attribute is a context-relative path for a web application resource that is to process the request using RequestDispatcher.include rather than instantiating and calling the Action class or subclass. You must set one of the attributes include, forward, or type for an action; these attributes are mutually exclusive.

action_mapping_icon Action Mappings

Represents the <action-mappings> element in the Struts configutation file. This element contains a series of zero or more <action> elements and their properties. The Action Mappings container icon appears only in the Structure window. See About the Struts Page Flow in Web Applications.

attachment_icon Attachment

Represents an attachment to a note for an element on a diagram. See Adding an Element to a Struts Page Flow Diagram and Creating and Attaching Notes to Diagram Elements.

controller_icon Controller

Represents the <controller> element, which describes the ControllerConfig bean ( org.apache.struts.config.ControllerConfig) that contains an application module's runtime configuration.

data_action_icon Data Source

Represents a <data-source> element in the Struts configutation file. You define data sources, for example, when you want to use an action handler to establish a connection for the application. The Data Source icon appears only in the Structure window.

datasources_icon Data Sources

Represents the <data-sources> element, which contains the <data source> elements in the Struts configutation file. This icon appears only in the Structure window.

exception_icon Exception

Represents an <exception> element, defined within an <action> or <global-exceptions> element, in the Struts configutation file. An ExceptionHandler is configured in the Struts configuration file to handle a specific type of exception thrown by an Action's execute method.

formbean_icon Form Bean

Represents the <form-beans> element ( org.apache.struts.config.FormBeanConfig) in the Struts configutation file. Form beans are descriptors that are used to create ActionForm instances at runtime. See Creating a Struts Form Bean.

formbeans_icon Form Beans

Represents the <form-beans> element, which contains all <form-bean> elements in the Struts configutation file. This icon appears only in the Structure window. See Creating a Struts Form Bean.

formproperty_icon Form Property

Represents the <set-property> definitions of an existing <form-property> definition in the Struts configutation file.

forward_icon Forward

Represents the forward definition in an action element. This is the destination to which the Struts controller servlet, ActionServlet, is directed to perform a RequestDispatcher.forward() or HttpServletResponse.sendRedirect() to, as a result of processing activities of an Action class. There can be multiple forwards for each action element. See About the Struts Page Flow in Web Applications. This icon appears only in the Structure window.

forward_icon Forward

Sets the path attribute for the local forward for an action . You can rename the forward by clicking on it and changing its properties in the Property Inspector.

global_exceptions_icon Global Exceptions

Represents the <global-exceptions> element in the Struts configutation file. You can define an ExceptionHandler to execute when an Action's execute method throws an Exception. First, you need to subclass org.apache.struts.action.ExceptionHandler and override the execute method. Your execute method should process the Exception and return an ActionForward object to tell Struts where to forward to next. This icon appears only in the Structure window.

global_forwards_icon Global Forwards

Represents the <global-forwards> element, which contains definitions for the forwards that can be used by all actions in the application. Forwards are instances of the ActionForward class returned from an ActionForm's execute method.This icon appears only in the Structure window.

message_resources_icon Message Resources

Represents the <message-resources> element in the Struts configutation file. See About Struts Properties Files and Resource Bundles.

note_icon Note

Represents a graphical object on a diagram that contains textual information about the diagram or about a diagram element. A note can be attached to one or more elements. A note is stored as part of the current diagram is not a separate file system element. See Adding an Element to a Struts Page Flow Diagram and Creating and Attaching Notes to Diagram Elements.

page_icon Page

Represents a standalone presentation page (JSP page, JSPX page, HTML page) in the current web context. No Struts action is associated with this page. Use the Page element instead of the Page Forward if you specifically do not want to create a forward action for the web page in your page flow. See About the Struts Page Flow in Web Applications.

The icon you initially insert into the Page Flow Diagram is overlaid with a yellow warning icon. This indicates that you have not yet associated a web page with the page forward element. After you double-click and associate a web page with the element, the icon appears without the warning.

page_forward_icon Page Forward

Represents a Struts forward action, which performs a simple forward to the destination (the context-relative URI such as a JSP page,JSPX page, or HTML page) specified by the forward attribute of the action. See About the Struts Page Flow in Web Applications.

The icon you initially insert into the Page Flow Diagram is overlaid with a yellow warning icon. This indicates that you have not yet associated a web page with the page forward element. After you double-click and associate a web page with the element, the icon appears without the warning.

pagelink_icon Page Link

Represents a link from a web page in the Struts Page Flow Modeler to another page or an action. See Defining a Struts Action Forward in the Page Flow Diagram and Adding a Struts Navigation Link in the Page Flow Diagram.

plugin_icon Plug-in

Represents a <plug-in> element (an implementation of org.apache.struts.action.PlugIn) in the Struts configutation file. This element specifies a fully qualified class name of a plugin module that allows a Struts application to find resources dynamically when the application starts.

plugins_icon Plug-ins

Contains the configuration information for all <plug-in> elements in a Struts configuration file.

setproperty_icon Set Property

Represents the <set-property> element, which allows you to set additional JavaBean configuration properties in certain elements in the Struts configutation file.

struts_actions_icon Struts Actions

The Struts Actions package provides special adapters between the incoming HTTP request and the corresponding business logic.

strutsconfig_icon Struts Config

Represents the Struts module configuration file. This icon appears only in the Structure window. See About the Struts Page Flow in Web Applications.


About the Struts Page Flow in Web Applications
Defining Colors and Fonts for Struts Page Flow Diagram Elements
Adding an Element to a Struts Page Flow Diagram
Deleting an Element from a Struts Page Flow Diagram
Laying out a Struts Page Flow Diagram