JBoss Tools SVN: r5252 - trunk/jsf/docs/userguide/en.
by jbosstools-commits@lists.jboss.org
Author: ochikvina
Date: 2007-12-12 05:55:54 -0500 (Wed, 12 Dec 2007)
New Revision: 5252
Modified:
trunk/jsf/docs/userguide/en/master.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-162 - changing the section title
Modified: trunk/jsf/docs/userguide/en/master.xml
===================================================================
--- trunk/jsf/docs/userguide/en/master.xml 2007-12-12 10:55:09 UTC (rev 5251)
+++ trunk/jsf/docs/userguide/en/master.xml 2007-12-12 10:55:54 UTC (rev 5252)
@@ -6,7 +6,7 @@
<!ENTITY Visual_Web_Tools SYSTEM "modules/Visual_Web_Tools.xml">
<!ENTITY features_list SYSTEM "modules/features_list.xml">
<!ENTITY jsf_support SYSTEM "modules/jsf_support.xml">
-<!ENTITY struts SYSTEM "modules/struts.xml">
+<!ENTITY struts_support SYSTEM "modules/struts_support.xml">
<!ENTITY editors SYSTEM "modules/editors.xml">
<!ENTITY palette SYSTEM "modules/palette.xml">
<!ENTITY web_projects SYSTEM "modules/web_projects.xml">
@@ -36,7 +36,7 @@
&Visual_Web_Tools;
&features_list;
&jsf_support;
- &struts;
+ &struts_support;
&editors;
&palette;
&web_projects;
18 years
JBoss Tools SVN: r5251 - trunk/jsf/docs/userguide/en/modules.
by jbosstools-commits@lists.jboss.org
Author: ochikvina
Date: 2007-12-12 05:55:09 -0500 (Wed, 12 Dec 2007)
New Revision: 5251
Added:
trunk/jsf/docs/userguide/en/modules/struts_support.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-162 - updating the section 4.5. Graphical Editor for Struts Validation Files
Added: trunk/jsf/docs/userguide/en/modules/struts_support.xml
===================================================================
--- trunk/jsf/docs/userguide/en/modules/struts_support.xml (rev 0)
+++ trunk/jsf/docs/userguide/en/modules/struts_support.xml 2007-12-12 10:55:09 UTC (rev 5251)
@@ -0,0 +1,904 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<chapter id="struts1" xreflabel="struts">
+ <?dbhtml filename="struts.html"?>
+ <title>Struts support</title>
+ <para>If you prefer develop web applications using <property>Struts</property> technology
+ JBoss Developer Studio also meets your needs.</para>
+ <para>JBDS supports the Struts 1.1, 1.2.x versions.</para>
+
+ <section id="SupportForStruts1.2.x1.1">
+ <?dbhtml filename="SupportForStruts1.1.1.2.x.html"?>
+ <title>Support for Struts 1.1, 1.2.x</title>
+
+
+ <para>When you create a brand new or import an existing project you can set which
+ Struts version to use:</para>
+ <figure>
+ <title>Choosing Struts Environment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="WorkingWithStrutsProjects866">
+ <?dbhtml filename="WorkingWithStrutsProjects.html"?>
+ <title>Working with Projects</title>
+ <section id="CreatingANewStrutsProjec745t">
+ <?dbhtml filename="CreatingANewStrutsProject.html"?>
+ <title>Creating a New Struts Project</title>
+
+ <para>JBoss Developer Studio provides the following when working with Struts.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Create new <property>Struts projects</property></para>
+ </listitem>
+ <listitem>
+ <para>Import (open) existing Struts projects</para>
+ <para>You can import any project structure</para>
+ </listitem>
+ <listitem>
+ <para>Add <property>Struts capabilities</property> to any
+ existing Eclipse project</para>
+ </listitem>
+ <listitem>
+ <para>Import and add Struts capabilities to any existing project
+ created outside Eclipse</para>
+ </listitem>
+ </itemizedlist>
+ <para>JBoss Developer Studio includes a New Struts Project Wizard that
+ radically simplifies the process for getting started with a new Struts
+ project. You just need to follow these 4 steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Select<emphasis>
+ <property> File > New > Project...</property>
+ </emphasis> from the menu bar. Then, select <emphasis>
+ <property>JBoss Tools Web > Struts > Struts
+ Project</property>
+ </emphasis> in this dialog box. Click <emphasis>
+ <property>Next</property>
+ </emphasis>:</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Selecting Struts Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>On this screen, provide the project name. You can leave all
+ other values as they are:</para>
+ </listitem>
+ </orderedlist>
+
+ <figure>
+ <title>Creating Struts Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>Don't put spaces in project names.</para>
+ </tip>
+ <note>
+ <title>Note:</title>
+ <para>If you select the KickStart template, then the project created
+ will include a simple Hello World type application that is
+ ready-to-run.</para>
+ </note>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>Next, you can register this application with the current
+ servlet container defined for your workspace (JBoss AS, by
+ default) in order to allow you to test your application
+ more easily while still developing it. A new entry will be
+ added in the servlet container configuration file to
+ enable running the application in-place (called null
+ deployment or link deployment). Uncheck the <emphasis
+ role="italic">
+ <property>"Target
+ Server"</property>
+ </emphasis> check box if for some reason you
+ don't want to register your application at this
+ point.</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Registering The Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>On the next screen, you can select the TLD files to include
+ in this project:</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Selecting Tag Libraries</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>After the project is created, you should have the following project
+ structure (if you used the KickStart template):</para>
+
+ <figure>
+ <title>Project Structure</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>If you want to hide the jar files from Web App Libraries in view,
+ select the down-pointing arrow in the upper right corner, select
+ <emphasis>Filters...</emphasis>, check the box next to
+ Name filter patterns (matching names will be hidden), and type
+ *.jar into the field. Then, click OK. </para>
+ </tip>
+ </section>
+ <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653">
+ <?dbhtml filename="ImportingAnExistingStrutsProjectWithAnyStructure.html"?>
+ <title>Importing an Existing Struts Project with Any Structure</title>
+
+ <para>For detailed information on migration projects to JBoss Developer Studio
+ see <ulink
+ url="../../../../../../documentation/guides/build/Exadel-migration/en/html_single/index.html"
+ >Migration Guide</ulink>.</para>
+
+ </section>
+ <section id="AddingStrutsCapabilityToAnExistingWebApplication532">
+ <?dbhtml filename="AddingStrutsCapabilityToAnExistingWebApplication.html"?>
+ <title>Adding Struts Capability to an Existing Web Application</title>
+
+ <para>With JBoss Developer Studio you can add <property>Struts
+ capabilities</property> (including Struts libraries, tag libraries and a
+ Struts configuration file) to any existing Web application project in
+ your Eclipse workspace. By adding a Struts Nature to your project, you
+ can now edit files using JBoss Developer Studio editors, such as the
+ Struts configuration editor and the JBoss Tools JSP editor.</para>
+ <para>To add Struts Nature t oyour existing Project right-click the project and
+ select <emphasis>
+ <property>JBoss Tools > Add Struts Capabilities</property>
+ </emphasis> from the context menu. This will start the process of adding
+ all necessary libraries and files to make this a Web Struts project.</para>
+
+ <figure>
+ <title>Adding Struts Capabilities</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>In the wizard you should point to location of your deployment descriptor
+ file web.xml and name of Web application.</para>
+
+ <figure>
+ <title>Choosing Project Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>After hitting <emphasis>
+ <property>Next</property>
+ </emphasis>, you will see the following screen. This screen simply means
+ that you need to add at least one Struts module to your project to make
+ this project a Struts project. Adding a Struts module means that a new
+ struts-config.xml will be added to your project and registered in the
+ web.xml file. In addition, all required Struts libraries will be added.
+ To add a Struts module, select the <emphasis>
+ <property>Add Struts Support</property>
+ </emphasis> button.</para>
+ <figure>
+ <title>Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_9.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Here you can select what Struts version, Servlet class, URL pattern and
+ TLDs to add to this project.</para>
+
+ <figure>
+ <title>Selecting Struts Support Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_10.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When done, you will see the default Struts module configuration
+ information. See how to Edit <link
+ linkend="SupportForMultipleStrutsModules75">Struts
+ modules</link>.</para>
+
+ <figure>
+ <title>Project Configuration Information</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_11.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On the last screen you can set the different folders for your project as
+ well as register this application with a servlet container.</para>
+
+ <figure>
+ <title>Registering the Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_12.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>When done, you can open nd edit the struts-config.xml file using usefull
+ Struts configuration file editor provided by JBDS. (The Struts
+ configuration is shown below in the Tree viewer).</para>
+
+ <figure>
+ <title>Struts-config.xml File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_13.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="GraphicalEditorForStrutsConfigurationFiles564">
+ <?dbhtml filename="GraphicalEditorForStrutsConfigurationFiles.html"?>
+ <title>Graphical Editor for Struts Configuration Files</title>
+
+ <para><property>The Struts configuration file editor</property> has three modes with
+ different reprisentation of <emphasis>
+ <property>struts-config.xml</property>
+ </emphasis>: Diagram, Tree and Source. The modes can be selected via the tabs
+ at the bottom of the editor. Any changes made in one mode are immediately
+ visible when you switch to any other mode.</para>
+
+ <para>When working in Source view, you always have all the following features
+ available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ <listitem>
+ <para>File Folding</para>
+ </listitem>
+ </itemizedlist>
+ <section id="StrutsDiagramMode453">
+ <?dbhtml filename="DiagramMode.html"?>
+ <title>Diagram Mode</title>
+
+ <para>The Diagram mode graphically displays the Web flow of the application
+ defined in the Struts configuration file.</para>
+
+ <figure>
+ <title>Diagram Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_14.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Just by right-clicking anywhere on the diagram, you can use a context
+ menu to create the building blocks of a Struts application:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Actions</para>
+ </listitem>
+ <listitem>
+ <para>Global forwards</para>
+ </listitem>
+ <listitem>
+ <para>Global exceptions</para>
+ </listitem>
+ <listitem>
+ <para>JSP Pages</para>
+ </listitem>
+ </itemizedlist>
+
+ <figure>
+ <title>Diagram Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_15.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Along the upper-left side of the editor is a stack of seven icons for
+ changing the behavior of the cursor in the diagram. The first icon
+ switches to the default regular selection cursor, the second to the
+ marquee selection cursor and the third to the new connection cursor. The
+ last four icons switch the cursor to an insert cursor for each type of
+ Struts build block listed above (and in the order listed).</para>
+
+ <para>For instance, clicking on the first of these four icons (the one with the
+ gears) will switch the cursor to insert actions. Clicking anywhere in
+ the diagram with this cursor has the same effect as right-click and
+ selecting <emphasis>
+ <property>Add > Action...</property>
+ </emphasis> from the context menu with the regular cursor active.
+ It's just more efficient to use this cursor if you're
+ adding more than one action at once.</para>
+
+ <figure>
+ <title>Insert Actions Cursor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_16.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsTreeMode42">
+ <?dbhtml filename="TreeMode.html"?>
+ <title>Tree Mode</title>
+
+ <para>The Tree mode represents the different elements of the Struts application
+ that are organized into functional categories on the left-hand side and
+ a form for editing the properties of currently selected items on the
+ right-hand side.</para>
+
+ <figure>
+ <title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_17.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also right-click on any node in the category tree and perform
+ appropriate operations through a context menu. For instance, by
+ right-clicking on the action-mappings category node, you can add new
+ actions to the application.</para>
+
+ <figure>
+ <title>Tree Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_18.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsSourceMode9655">
+ <?dbhtml filename="SourceMode.html"?>
+ <title>Source Mode</title>
+
+ <para>In the Source mode, you have complete editing control of the underlying
+ XML coding:</para>
+
+ <figure>
+ <title>Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_19.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can take advantage of code assist:</para>
+
+ <figure>
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_20.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The editor will also immediately flag any errors:</para>
+
+ <figure>
+ <title>Errors in Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_21.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Finally, you can use the Outline view with the editor to easily navigate
+ through the file:</para>
+
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_22.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+
+ <section id="GraphicalEditorForTilesFiles132">
+ <?dbhtml filename="GraphicalEditorForTilesFiles.html"?>
+ <title>Graphical Editor for Tiles Files</title>
+
+ <para><property>The Tiles configuration file editor</property> has three main modes:
+ Tree (shown), Diagram and Source. The modes can be selected via the tabs at the
+ bottom of the editor. Any changes made in one mode are immediately visible when
+ you switch to any other mode.</para>
+
+ <para>When working in Source view, you always have all following features available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ </itemizedlist>
+ <section id="CreateNewTilesFile1422">
+ <?dbhtml filename="CreateNewTilesFile.html"?>
+ <title>Create New Tiles File</title>
+
+ <para>To create a new Tiles files, right click any folder and select <emphasis>
+ <property>New > Tiles File</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Creating a New Tiles File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_23.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsTreeView896">
+ <?dbhtml filename="TreeView.html"?>
+ <title>Tree Mode</title>
+
+ <para>The Tree mode represents the different elements of the Tiles file that
+ are organized into functional categories on the left-hand side and a
+ form for editing the properties of currently selected items on the
+ right-hand side.</para>
+ <figure>
+ <title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_24.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To edit the file, simply right click any node and select among the
+ available actions:</para>
+ <figure>
+ <title>Editing in Tiles Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_25.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsDiagramView4643">
+ <?dbhtml filename="DigramView.html"?>
+ <title>Diagram Mode</title>
+
+ <para>The Diagram mode allows you to create complex Tiles files in the form of
+ a diagram.</para>
+ <figure>
+ <title>Diagram Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_26.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To create new definitions, simply right click anywhere in the diagram:</para>
+ <figure>
+ <title>Creating New Definition</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_27.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also use the Diagram toolbar to make editing easier.</para>
+ <figure>
+ <title>Diagram Toolbar</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_28.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para> It contains four icons for changing the cursor state. The first one is
+ the default cursor state for selecting existing nodes. The second icon
+ is marquee selector. The third is used for creating new connections and
+ the last one is for adding definition template to the content.</para>
+ </section>
+ <section id="StrutsSource75">
+ <?dbhtml filename="Source.html"?>
+ <title>Source</title>
+
+ <para>The other mode of the <property>Tiles editor</property> is the Source
+ mode that gives you full control over the source. Any changes here will
+ immediately appear in other modes when you switch to them.</para>
+ <figure>
+ <title>Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_29.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Code assist is available in the Source mode:</para>
+ <figure>
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_30.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Any errors are immediately reported as shown below:</para>
+ <figure>
+ <title>Errors Reporting</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_31.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also use the Outline view together with the editor's
+ Source mode. It provides an easier navigation through the file.</para>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_32.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="GraphicalEditorForStrutsValidationFiles86">
+ <?dbhtml filename="GraphicalEditorForStrutsValidationFiles.html"?>
+ <title>Graphical Editor for Struts Validation Files</title>
+
+ <para>Providing full support for development Struts applications JBoss Developer
+ Studio comes with a <property>visual validation editor</property>. To create a
+ new validation file, right click any folder in Project Explorer and select <emphasis>
+ <property>File > New > Other...</property>
+ </emphasis>from the context menu and then <emphasis>
+ <property>jBoss Tools Web > Struts > Validation File</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Creating New Validation File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_33.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The validation editor works through five modes: Formsets, Validators, Constants
+ and standard Tree and Source that you can easily switch over to using tabs at
+ the bottom of the editor.</para>
+ <para>The Formsets mode shows forms and their elements on the
+ left side and the dialogue for defining their validation rules on the right side.</para>
+ <figure>
+ <title>Formsets Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_34.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The Constants mode let you set constant values for your validation rules.</para>
+ <figure>
+ <title>Constansts Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_35.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The validation file can also be viewed in a Tree mode.</para>
+ <figure>
+ <title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_36.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>At any point you have full control over the source by switching to the Source
+ mode. Any editing in this mode will immediately be available in other
+ modes of the editor.</para>
+ <figure>
+ <title>Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_37.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You can also open your own custom or Struts-standard validation-rules.xml file.</para>
+ <para>The Validators mode shows the validation rules for a selected validator. You
+ can of course add your own rules.</para>
+ <figure>
+ <title>Validators Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_38.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Here are the validation rules shown in the Source mode.</para>
+ <figure>
+ <title>Validation Rules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_39.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="SupportForMultipleStrutsModules75">
+ <?dbhtml filename="SupportForMultipleStrutsModules.html"?>
+ <title>Support for Multiple Struts Modules</title>
+ <section id="StrutsModulesghf07">
+ <?dbhtml filename="StrutsModules.html"?>
+ <title>Struts Modules</title>
+ <para>JBoss Developer Studio supports working with Struts projects that have
+ multiple <property>modules</property>. You can easily do the following:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Add new modules</para>
+ </listitem>
+ <listitem>
+ <para>Edit modules for an existing project or during Struts
+ project import</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="WhenImportingAStrutsProject432">
+ <?dbhtml filename="WhenImportingAStrutsProject.html"?>
+ <title>When Importing a Struts Project</title>
+
+ <para>During Struts project import, if the project has multiple modules, you
+ will see a screen with all existing modules. You can select each module
+ and edit its details.</para>
+
+ <figure>
+ <title>Configuring Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_40.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="EditingModulesInAnExistingProject1">
+ <?dbhtml filename="EditingModulesInAnExistingProject.html"?>
+ <title>Editing Modules in an Existing Project</title>
+ <para>To edit modules in an existing project, right click the project and
+ select <emphasis>
+ <property>JBoss Tools > Modules Configuration</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Choosing Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_41.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the same screen as above where you will be able to select a
+ module and edit its details:</para>
+ <figure>
+ <title>Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_42.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="AddingNewModules1">
+ <?dbhtml filename="AddingMewModules.html"?>
+ <title>Adding New Modules</title>
+
+ <para>Adding a new module is very simple. First switch to Web Project view.
+ Expand your project to the Configuration folder. Under that folder you
+ should see the current modules. Right click on Configuration and select <emphasis>
+ <property>New > Struts Config</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_43.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the screen below. You can specify a new module name and also
+ add the new Struts configuration file to web.xml file.</para>
+ <figure>
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_44.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="CodeGenerationForActionFormBeanForwardAndExceptionClasses1">
+ <?dbhtml filename="CodeGenerationForActionFormBeanForwardAndExceptionClasses.html"?>
+ <title>Code Generation for Action, FormBean, Forward and Exception Classes</title>
+
+ <para>JBoss Developer Studio comes with a <property>code generation</property>
+ feature. You can generate stub code for Struts Actions, FormBeans, Forwards and
+ Exceptions.</para>
+
+ <para>The code generation in JBoss Developer Studio is based on Velocity templates
+ which can be modified for your use. The templates are located at <emphasis>
+ <property> {RedHatDeveloperStudioHome} > templates >
+ codegeneration</property>
+ </emphasis>.</para>
+
+ <para>There are a number of ways to invoke code generation. One is simply
+ right-clicking the Struts diagram and selecting <emphasis>
+ <property>Generate Java Code....</property>
+ </emphasis></para>
+
+ <figure>
+ <title>Selecting Generate Java Code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_45.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On this screen you can select for which elements to generate code. If you select
+ Next you will be able to specify more options for each of the categories you
+ selected.</para>
+
+ <figure>
+ <title>Generate - Step 1</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_46.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>please be careful not to override your existing files.</para>
+ </tip>
+
+ <para>When generation is complete, a result window will appear letting you know how
+ many classes were generated:</para>
+
+ <figure>
+ <title>Generation Finished</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_47.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You don't always have to generate code for all elements at once. You
+ can invoke generation for just an individual Struts artifact as well.
+ Right-click an element on the diagram of the Struts configuration file and
+ select <emphasis>
+ <property>Generate Java Code...</property>
+ </emphasis> from the context menu.</para>
+
+ <figure>
+ <title>Generation For Individual Struts Artifact</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_48.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The same can be done from within the Tree viewer for the editor of the Struts
+ configuration file.</para>
+
+ <figure>
+ <title>Generation in Struts Config Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_49.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsConfigurationFileDebugger097">
+ <?dbhtml filename="StrutsConfigurationFileDebugger.html"?>
+ <title>Struts Configuration File Debugger</title>
+
+ <para>JBoss Developer Studio comes with <property>Struts configuration file
+ debugger</property>. It allows you to set break points on Struts diagram and
+ then simply launch the server in debug mode.</para>
+
+ <para>Simply right click an Action or a page and select Add <emphasis>
+ <property>Breakpoint</property>
+ </emphasis>. </para>
+ <figure>
+ <title>Adding Breakpoint</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_50.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="CustomizablePageLinksRecognizer1">
+ <?dbhtml filename="CustomizablePageLinksRecognizer.html"?>
+ <title>Customizable Page Links Recognizer</title>
+
+ <para><property>Custom page links</property> allow you to define custom Struts page
+ links that will be recognizable in the Struts application diagram. You can
+ define these links by selecting <emphasis>
+ <property>Window > Preferences</property>
+ </emphasis> from the menu bar and then selecting <emphasis>
+ <property>JBoss Tools > Web > Struts > Customization</property>
+ </emphasis> from the Preferences dialog box.</para>
+ <figure>
+ <title>Customization Panel</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_51.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+</chapter>
18 years
JBoss Tools SVN: r5250 - trunk/hibernatetools/plugins/org.hibernate.eclipse.console/src/org/hibernate/eclipse/console/views.
by jbosstools-commits@lists.jboss.org
Author: dgeraskov
Date: 2007-12-12 03:02:02 -0500 (Wed, 12 Dec 2007)
New Revision: 5250
Modified:
trunk/hibernatetools/plugins/org.hibernate.eclipse.console/src/org/hibernate/eclipse/console/views/ConfigurationsViewActionGroup.java
Log:
http://jira.jboss.com/jira/browse/JBIDE-1412
Modified: trunk/hibernatetools/plugins/org.hibernate.eclipse.console/src/org/hibernate/eclipse/console/views/ConfigurationsViewActionGroup.java
===================================================================
--- trunk/hibernatetools/plugins/org.hibernate.eclipse.console/src/org/hibernate/eclipse/console/views/ConfigurationsViewActionGroup.java 2007-12-11 15:17:31 UTC (rev 5249)
+++ trunk/hibernatetools/plugins/org.hibernate.eclipse.console/src/org/hibernate/eclipse/console/views/ConfigurationsViewActionGroup.java 2007-12-12 08:02:02 UTC (rev 5250)
@@ -140,7 +140,7 @@
if (first instanceof RootClass
//|| first instanceof Property
|| first instanceof Subclass){
- menu.appendToGroup("deagramEditorAction", openSourceAction);
+ menu.add(openSourceAction);
menu.add(openMappingAction);
}
if (first instanceof Property
18 years
JBoss Tools SVN: r5249 - trunk/common/plugins/org.jboss.tools.common.model/src/org/jboss/tools/common/meta/action/impl/handlers.
by jbosstools-commits@lists.jboss.org
Author: scabanovich
Date: 2007-12-11 10:17:31 -0500 (Tue, 11 Dec 2007)
New Revision: 5249
Modified:
trunk/common/plugins/org.jboss.tools.common.model/src/org/jboss/tools/common/meta/action/impl/handlers/PasteEnterNewNameSupport.java
Log:
JBIDE-1471
Modified: trunk/common/plugins/org.jboss.tools.common.model/src/org/jboss/tools/common/meta/action/impl/handlers/PasteEnterNewNameSupport.java
===================================================================
--- trunk/common/plugins/org.jboss.tools.common.model/src/org/jboss/tools/common/meta/action/impl/handlers/PasteEnterNewNameSupport.java 2007-12-11 15:17:09 UTC (rev 5248)
+++ trunk/common/plugins/org.jboss.tools.common.model/src/org/jboss/tools/common/meta/action/impl/handlers/PasteEnterNewNameSupport.java 2007-12-11 15:17:31 UTC (rev 5249)
@@ -42,6 +42,10 @@
+ getCapitalizedName(getTarget());
}
+ public String getSubtitle() {
+ return "" + getCapitalizedName(copy);
+ }
+
static String getCapitalizedName(XModelObject o) {
String n = o.getAttributeValue("element type");
if(n == null || n.length() == 0) n = o.getModelEntity().getXMLSubPath();
18 years
JBoss Tools SVN: r5248 - trunk/common/plugins/org.jboss.tools.common.model/resources/help.
by jbosstools-commits@lists.jboss.org
Author: scabanovich
Date: 2007-12-11 10:17:09 -0500 (Tue, 11 Dec 2007)
New Revision: 5248
Modified:
trunk/common/plugins/org.jboss.tools.common.model/resources/help/keys-model.properties
Log:
JBIDE-1471
Modified: trunk/common/plugins/org.jboss.tools.common.model/resources/help/keys-model.properties
===================================================================
--- trunk/common/plugins/org.jboss.tools.common.model/resources/help/keys-model.properties 2007-12-11 15:16:36 UTC (rev 5247)
+++ trunk/common/plugins/org.jboss.tools.common.model/resources/help/keys-model.properties 2007-12-11 15:17:09 UTC (rev 5248)
@@ -278,35 +278,35 @@
SharableIcons_CreateIcon.WindowTitle=Add Icon
SharableIcons_CreateIcon.Title=Icon
+SharableXStudioIcons=/model/PaletteEditor.html
+
+SharableXStudioIcons_CreateIcons=/model/PaletteEditor.html
+SharableXStudioIcons_CreateIcons.WindowTitle=Add Icon Set
+SharableXStudioIcons_CreateIcons.Title=Icon Set
+
+SharableXStudioIcons_Properties=/model/PaletteEditor.html
+SharableXStudioIcons_Properties.WindowTitle=Properties
+SharableXStudioIcons_Properties.Title=
+
SharablePalette=/model/PaletteEditor.html
SharablePalette_CreatePageTabHTML_0=/model/PaletteEditor.html
+SharablePalette_CreatePageTabHTML_0.WindowTitle=Create Group
+SharablePalette_CreatePageTabHTML_0.Title=Palette Top-Level Group
-SharablePalette_CreatePageTabHTML=/model/PaletteEditor.html
-SharablePalette_CreatePageTabHTML.WindowTitle=Palette Tab
-
SharablePalette_Properties=/model/PaletteEditor.html
SharablePalette_Properties.WindowTitle=Properties
SharablePalette_Properties.Title=
SharablePalette_HiddenTabs=/model/PaletteEditor.html
SharablePalette_HiddenTabs.WindowTitle=Show/Hide Drawers
-SharablePalette_HiddenTabs.Title=
+SharablePalette_HiddenTabs.Title=Customize Palette
SharableXStudio=/model/PaletteEditor.html
SharableXStudio_Properties=/model/PaletteEditor.html
SharableXStudio_Properties.WindowTitle=Properties
-SharableXStudioIcons=/model/PaletteEditor.html
-
-SharableXStudioIcons_CreateIcons=/model/PaletteEditor.html
-SharableXStudioIcons_CreateIcons.WindowTitle=Add Icons
-
-SharableXStudioIcons_Properties=/model/PaletteEditor.html
-SharableXStudioIcons_Properties.WindowTitle=Properties
-SharableXStudioIcons_Properties.Title=
-
SharableGroup=/model/PaletteEditor.html
SharableGroup_CreateGroup=/model/PaletteEditor.html
@@ -323,6 +323,7 @@
SharableGroupHTML_CreateMacro=/model/PaletteEditor.html
SharableGroupHTML_CreateMacro.WindowTitle=Add Palette Macro
+SharableGroupHTML_CreateMacro.Title=Palette Macro
SharableGroupHTML_Properties=/model/PaletteEditor.html
SharableGroupHTML_Properties.WindowTitle=Properties
@@ -347,6 +348,9 @@
SharableMacroHTML_Edit_description.Title=Edit Description
SharableMacroHTML_Edit_description.WindowTitle=Macro
+SharableMacroHTML_Edit.WindowTitle=Edit
+SharableMacroHTML_Edit.Title=Palette Macro
+
SharablePageTab=/model/PaletteEditor.html
SharablePageTab_CreateGroup=/model/PaletteEditor.html
18 years
JBoss Tools SVN: r5247 - trunk/jst/plugins/org.jboss.tools.jst.web/resources/help.
by jbosstools-commits@lists.jboss.org
Author: scabanovich
Date: 2007-12-11 10:16:36 -0500 (Tue, 11 Dec 2007)
New Revision: 5247
Modified:
trunk/jst/plugins/org.jboss.tools.jst.web/resources/help/keys-web.properties
Log:
JBIDE-1471
Modified: trunk/jst/plugins/org.jboss.tools.jst.web/resources/help/keys-web.properties
===================================================================
--- trunk/jst/plugins/org.jboss.tools.jst.web/resources/help/keys-web.properties 2007-12-11 15:13:39 UTC (rev 5246)
+++ trunk/jst/plugins/org.jboss.tools.jst.web/resources/help/keys-web.properties 2007-12-11 15:16:36 UTC (rev 5247)
@@ -667,9 +667,11 @@
WebAppMessageDestinationRef_Properties.Title=Message Destination Reference
+ImportTLDToPaletteWizard_ImportTLD.Title=Create Macro from Tags in TLD file
ImportTLDToPaletteWizard.tld=TLD File
ImportTLDToPaletteWizard.tld.edit=Edit TLD
ImportTLDToPaletteWizard.default_prefix=Default Prefix
ImportTLDToPaletteWizard.library_uri=Library URI
-SharableGroupHTML.add_taglib=Automatic insertion of taglib to the page
\ No newline at end of file
+SharableGroupHTML.add_taglib=Automatic insertion of taglib to the page
+
18 years
JBoss Tools SVN: r5246 - trunk/jsf/docs/userguide/en.
by jbosstools-commits@lists.jboss.org
Author: ochikvina
Date: 2007-12-11 10:13:39 -0500 (Tue, 11 Dec 2007)
New Revision: 5246
Modified:
trunk/jsf/docs/userguide/en/master.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-162 - fixing the mistake that was revealed during the building
Modified: trunk/jsf/docs/userguide/en/master.xml
===================================================================
--- trunk/jsf/docs/userguide/en/master.xml 2007-12-11 15:11:19 UTC (rev 5245)
+++ trunk/jsf/docs/userguide/en/master.xml 2007-12-11 15:13:39 UTC (rev 5246)
@@ -6,7 +6,7 @@
<!ENTITY Visual_Web_Tools SYSTEM "modules/Visual_Web_Tools.xml">
<!ENTITY features_list SYSTEM "modules/features_list.xml">
<!ENTITY jsf_support SYSTEM "modules/jsf_support.xml">
-<!ENTITY struts SYSTEM "modules/struts_support.xml">
+<!ENTITY struts SYSTEM "modules/struts.xml">
<!ENTITY editors SYSTEM "modules/editors.xml">
<!ENTITY palette SYSTEM "modules/palette.xml">
<!ENTITY web_projects SYSTEM "modules/web_projects.xml">
@@ -32,7 +32,7 @@
</releaseinfo>
</bookinfo>
- <toc/>
+<toc/>
&Visual_Web_Tools;
&features_list;
&jsf_support;
18 years
JBoss Tools SVN: r5245 - trunk/jsf/docs/userguide/en/modules.
by jbosstools-commits@lists.jboss.org
Author: ochikvina
Date: 2007-12-11 10:11:19 -0500 (Tue, 11 Dec 2007)
New Revision: 5245
Modified:
trunk/jsf/docs/userguide/en/modules/jsf_support.xml
trunk/jsf/docs/userguide/en/modules/struts.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-162 - sections from 3.7 to 4.4 includingly are updated
Modified: trunk/jsf/docs/userguide/en/modules/jsf_support.xml
===================================================================
--- trunk/jsf/docs/userguide/en/modules/jsf_support.xml 2007-12-11 15:10:09 UTC (rev 5244)
+++ trunk/jsf/docs/userguide/en/modules/jsf_support.xml 2007-12-11 15:11:19 UTC (rev 5245)
@@ -1046,7 +1046,7 @@
</figure>
<orderedlist continuation="continues">
<listitem>
- <para>Let's create <emphasis role="italic">
+ <para>Now you can create <emphasis role="italic">
<property>"converter"</property>
</emphasis> class. In the Converter section you should see
your Converter-id and Converter-class. Click on <emphasis>
@@ -1082,7 +1082,7 @@
<orderedlist continuation="continues">
<listitem>
<para>To open converter class click again on Converter-class link in
- the Converter section. Now you are able to write business
+ the Converter section. Now you are able to add business
logic of converter.</para>
</listitem>
</orderedlist>
@@ -1100,6 +1100,7 @@
<?dbhtml filename="CreateAndRegisterACustomValidator.html"?>
<title>Create and Register a Custom Validator</title>
+ <para>With the help of JBDS you can easy develop your own custom validators.</para>
<orderedlist>
<listitem>
<para>In the Project Explorer view open<emphasis>
@@ -1126,7 +1127,7 @@
</emphasis>button.</para>
</listitem>
<listitem>
- <para>Type the name of your validator in the Valifator-id field an d
+ <para>Type the name of your validator in the Valifator-id field and
name of the class for validators. After clicking <emphasis>
<property>Finish</property>
</emphasis> button your custom validator is registered under
@@ -1141,14 +1142,17 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>Now you can create the "validatir" class.
+ </para>
<orderedlist continuation="continues">
<listitem>
<para>Let's create <emphasis role="italic">
<property>"validator"</property>
</emphasis> class. In the Validator section you should see
- your Validator-id and Validator-class. Click on <emphasis>
+ your Validator-id and Validator-class. To generate the source code click on <emphasis>
<property>Validator-class</property>
- </emphasis> to generate the source code.</para>
+ </emphasis>.</para>
</listitem>
</orderedlist>
<figure>
@@ -1195,6 +1199,9 @@
<section id="CreateAndRegisterReferencedBeans64322">
<?dbhtml filename="CreateAndRegisterReferencedBeans.html"?>
<title>Create and Register Referenced Beans</title>
+
+ <para>Creation of Referenced Beans is similar to creation of Custom Validator.</para>
+
<orderedlist>
<listitem>
<para>In the Project Explorer view open<emphasis>
@@ -1205,7 +1212,7 @@
</listitem>
</orderedlist>
<figure>
- <title>Validator in Faces Config Editor</title>
+ <title>Referenced Beans in Faces Config Editor</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/jsf_support/jsf_support_54.png"/>
@@ -1226,7 +1233,7 @@
</listitem>
</orderedlist>
<figure>
- <title>Add Validator Form</title>
+ <title>Add Referenced Bean</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/jsf_support/jsf_support_55.png"/>
@@ -1241,7 +1248,7 @@
</listitem>
</orderedlist>
<figure>
- <title>Create Validator Class</title>
+ <title>Create Referenced Bean Class</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/jsf_support/jsf_support_56.png"/>
Modified: trunk/jsf/docs/userguide/en/modules/struts.xml
===================================================================
--- trunk/jsf/docs/userguide/en/modules/struts.xml 2007-12-11 15:10:09 UTC (rev 5244)
+++ trunk/jsf/docs/userguide/en/modules/struts.xml 2007-12-11 15:11:19 UTC (rev 5245)
@@ -1,734 +1,899 @@
<?xml version='1.0' encoding='UTF-8'?>
<chapter id="struts1" xreflabel="struts">
- <?dbhtml filename="struts.html"?>
-<title>Struts</title>
-<para>If you prefer develop web applications using <property>Struts</property> technology JBoss Developer Studio also meets your needs.</para>
+ <?dbhtml filename="struts.html"?>
+ <title>Struts support</title>
+ <para>If you prefer develop web applications using <property>Struts</property> technology
+ JBoss Developer Studio also meets your needs.</para>
<para>JBDS supports the Struts 1.1, 1.2.x versions.</para>
-<section id="SupportForStruts1.2.x1.1">
-<?dbhtml filename="SupportForStruts1.1.1.2.x.html"?>
-<title>Support for Struts 1.1, 1.2.x</title>
+ <section id="SupportForStruts1.2.x1.1">
+ <?dbhtml filename="SupportForStruts1.1.1.2.x.html"?>
+ <title>Support for Struts 1.1, 1.2.x</title>
-<para>When you create a brand new or import an existing project you can set which Struts version to use:</para>
-<figure>
-<title>Choosing Struts Environment</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_1.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-<section id="WorkingWithStrutsProjects866">
-<?dbhtml filename="WorkingWithStrutsProjects.html"?>
-<title>Working with Projects</title>
-<section id="CreatingANewStrutsProjec745t">
-<?dbhtml filename="CreatingANewStrutsProject.html"?>
-<title>Creating a New Struts Project</title>
+ <para>When you create a brand new or import an existing project you can set which
+ Struts version to use:</para>
+ <figure>
+ <title>Choosing Struts Environment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="WorkingWithStrutsProjects866">
+ <?dbhtml filename="WorkingWithStrutsProjects.html"?>
+ <title>Working with Projects</title>
+ <section id="CreatingANewStrutsProjec745t">
+ <?dbhtml filename="CreatingANewStrutsProject.html"?>
+ <title>Creating a New Struts Project</title>
-<para>JBoss Developer Studio provides the following when working with Struts.</para>
+ <para>JBoss Developer Studio provides the following when working with Struts.</para>
-<itemizedlist>
- <listitem><para>Create new <property>Struts projects</property></para></listitem>
-<listitem><para>Import (open) existing Struts projects</para>
- <para>You can import any project structure</para>
-</listitem>
- <listitem><para>Add <property>Struts capabilities</property> to any existing Eclipse project</para></listitem>
-<listitem><para>Import and add Struts capabilities to any existing project created outside Eclipse</para></listitem>
-</itemizedlist>
-<para>JBoss Developer Studio includes a New Struts Project Wizard that radically simplifies the process
-for getting started with a new Struts project. You just need to follow these 4 steps:</para>
-<orderedlist>
- <listitem><para>Select<emphasis><property> File > New > Project...</property></emphasis> from the menu bar. Then, select <emphasis><property>JBoss Tools Web > Struts > Struts Project</property></emphasis> in this dialog box. Click <emphasis><property>Next</property></emphasis>:</para></listitem>
-</orderedlist>
-<figure>
-<title>Selecting Struts Wizard</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_2.png"/>
- </imageobject>
- </mediaobject>
-</figure>
- <orderedlist continuation="continues">
- <listitem><para>On this screen, provide the project name. You can leave all other values as they are:</para></listitem>
-</orderedlist>
-
-<figure>
-<title>Creating Struts Project</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Create new <property>Struts projects</property></para>
+ </listitem>
+ <listitem>
+ <para>Import (open) existing Struts projects</para>
+ <para>You can import any project structure</para>
+ </listitem>
+ <listitem>
+ <para>Add <property>Struts capabilities</property> to any
+ existing Eclipse project</para>
+ </listitem>
+ <listitem>
+ <para>Import and add Struts capabilities to any existing project
+ created outside Eclipse</para>
+ </listitem>
+ </itemizedlist>
+ <para>JBoss Developer Studio includes a New Struts Project Wizard that
+ radically simplifies the process for getting started with a new Struts
+ project. You just need to follow these 4 steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Select<emphasis>
+ <property> File > New > Project...</property>
+ </emphasis> from the menu bar. Then, select <emphasis>
+ <property>JBoss Tools Web > Struts > Struts
+ Project</property>
+ </emphasis> in this dialog box. Click <emphasis>
+ <property>Next</property>
+ </emphasis>:</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Selecting Struts Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>On this screen, provide the project name. You can leave all
+ other values as they are:</para>
+ </listitem>
+ </orderedlist>
-<tip><title>Tip:</title><para>Don't put spaces in project names.</para></tip>
-<note>
- <title>Note:</title>
- <para>If you select the KickStart template, then the project created will include a simple Hello
- World type application that is ready-to-run.</para>
- </note>
-<orderedlist continuation="continues">
-<listitem><para>Next, you can register this application with the current servlet container defined for your
-workspace (JBoss AS, by default) in order to allow you to test your application more easily while still
- developing it. A new entry will be added in the servlet container configuration file to enable running
- the application in-place (called null deployment or link deployment). Uncheck the <emphasis role="italic"><property>"Target Server"</property></emphasis>
- check box if for some reason you don't want to register your application at this point.</para></listitem>
-</orderedlist>
-<figure><title>Registering The Project at Server</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_4.png"/>
- </imageobject>
- </mediaobject>
-</figure>
-<orderedlist continuation="continues">
-<listitem><para>On the next screen, you can select the TLD files to include in this project:</para></listitem>
-</orderedlist>
-<figure><title>Selecting Tag Libraries</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_5.png"/>
- </imageobject>
- </mediaobject>
-</figure>
+ <figure>
+ <title>Creating Struts Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>After the project is created, you should have the following project structure (if you used the
-KickStart template):</para>
-
-<figure>
-<title>Project Structure</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_6.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <tip>
+ <title>Tip:</title>
+ <para>Don't put spaces in project names.</para>
+ </tip>
+ <note>
+ <title>Note:</title>
+ <para>If you select the KickStart template, then the project created
+ will include a simple Hello World type application that is
+ ready-to-run.</para>
+ </note>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>Next, you can register this application with the current
+ servlet container defined for your workspace (JBoss AS, by
+ default) in order to allow you to test your application
+ more easily while still developing it. A new entry will be
+ added in the servlet container configuration file to
+ enable running the application in-place (called null
+ deployment or link deployment). Uncheck the <emphasis
+ role="italic">
+ <property>"Target
+ Server"</property>
+ </emphasis> check box if for some reason you
+ don't want to register your application at this
+ point.</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Registering The Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <orderedlist continuation="continues">
+ <listitem>
+ <para>On the next screen, you can select the TLD files to include
+ in this project:</para>
+ </listitem>
+ </orderedlist>
+ <figure>
+ <title>Selecting Tag Libraries</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<tip><title>Tip:</title><para>If you want to hide the jar files from Web App Libraries in view, select the down-pointing
-arrow in the upper right corner, select <emphasis>Filters...</emphasis>, check the box next to Name filter patterns (matching names will be hidden), and type *.jar into the field. Then, click OK. </para></tip>
-</section>
-<section id="ImportingAnExistingStrutsProjectWithAnyStructure9653">
-<?dbhtml filename="ImportingAnExistingStrutsProjectWithAnyStructure.html"?>
-<title>Importing an Existing Struts Project with Any Structure</title>
+ <para>After the project is created, you should have the following project
+ structure (if you used the KickStart template):</para>
- <para>For detailed information on migration projects to JBoss Developer Studio see <ulink url="../../../../../../documentation/guides/build/Exadel-migration/en/html_single/index.html">Migration Guide</ulink>.</para>
-
- </section>
- <section id="AddingStrutsCapabilityToAnExistingWebApplication532">
- <?dbhtml filename="AddingStrutsCapabilityToAnExistingWebApplication.html"?>
-<title>Adding Struts Capability to an Existing Web Application</title>
+ <figure>
+ <title>Project Structure</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>With JBoss Developer Studio you can add <property>Struts capabilities</property> (including Struts libraries, tag libraries and a Struts configuration file) to any existing Web application project in your Eclipse workspace. By adding a
- Struts Nature to your project, you can now edit files using JBoss Developer Studio editors, such as the Struts
- configuration editor and the JBoss Tools JSP editor.</para>
-<para>Right-click the project and select <emphasis><property>JBoss Tools > Add Struts Capabilities</property></emphasis> from the context menu. This will start the process of adding all necessary libraries and files to make this a Web JSF project.</para>
-
-<figure>
-<title>Adding Struts Capabilities</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_7.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <tip>
+ <title>Tip:</title>
+ <para>If you want to hide the jar files from Web App Libraries in view,
+ select the down-pointing arrow in the upper right corner, select
+ <emphasis>Filters...</emphasis>, check the box next to
+ Name filter patterns (matching names will be hidden), and type
+ *.jar into the field. Then, click OK. </para>
+ </tip>
+ </section>
+ <section id="ImportingAnExistingStrutsProjectWithAnyStructure9653">
+ <?dbhtml filename="ImportingAnExistingStrutsProjectWithAnyStructure.html"?>
+ <title>Importing an Existing Struts Project with Any Structure</title>
-<para>The wizard will first show you the web.xml file location and the project name.</para>
+ <para>For detailed information on migration projects to JBoss Developer Studio
+ see <ulink
+ url="../../../../../../documentation/guides/build/Exadel-migration/en/html_single/index.html"
+ >Migration Guide</ulink>.</para>
-<figure>
-<title>Choosing Project Location</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_8.png"/>
- </imageobject>
-</mediaobject>
-</figure>
- <para>After hitting <emphasis><property>Next</property></emphasis>, you will see the following screen. This screen simply means that you need to add
-at least one Struts module to your project to make this project a Struts project. Adding a Struts module
-means that a new struts-config.xml will be added to your project and registered in the web.xml file. In
-addition, all required Struts libraries will be added. To add a Struts module, select the <emphasis><property>Add Struts Support</property></emphasis> button.</para>
-<figure>
-<title>Project Modules</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_9.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-
-<para>Here you can select what Struts version, Servlet class, URL pattern and TLDs to add to this project.</para>
-
-<figure>
-<title>Selecting Struts Support Options</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_10.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-
-<para>When done, you will see the default Struts module configuration information. See how to Edit
-<link linkend="SupportForMultipleStrutsModules75">Struts modules</link>.</para>
-
-<figure>
-<title>Project Configuration Information</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_11.png" />
- </imageobject>
-</mediaobject>
-</figure>
-
-<para>On the last screen you can set the different folders for your project as well as register this
-application with a servlet container.</para>
-
-<figure>
-<title>Registering the Project at Server</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_12.png" />
- </imageobject>
-</mediaobject>
-</figure>
-
-<para>When done, you can open the struts-config.xml file. (The Struts configuration is shown below in the
-Tree viewer).</para>
-
-<figure>
-<title>Struts-config.xml File</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_13.png" />
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-</section>
-<section id="GraphicalEditorForStrutsConfigurationFiles564">
-<?dbhtml filename="GraphicalEditorForStrutsConfigurationFiles.html"?>
-<title>Graphical Editor for Struts Configuration Files</title>
+ </section>
+ <section id="AddingStrutsCapabilityToAnExistingWebApplication532">
+ <?dbhtml filename="AddingStrutsCapabilityToAnExistingWebApplication.html"?>
+ <title>Adding Struts Capability to an Existing Web Application</title>
-<para><property>The Struts configuration file editor</property> has three main viewers (modes): Diagram (shown), Tree and Source. The modes can be selected via the tabs at the bottom of the editor. Any changes made in one mode are
- immediately visible when you switch to any other mode.</para>
+ <para>With JBoss Developer Studio you can add <property>Struts
+ capabilities</property> (including Struts libraries, tag libraries and a
+ Struts configuration file) to any existing Web application project in
+ your Eclipse workspace. By adding a Struts Nature to your project, you
+ can now edit files using JBoss Developer Studio editors, such as the
+ Struts configuration editor and the JBoss Tools JSP editor.</para>
+ <para>To add Struts Nature t oyour existing Project right-click the project and
+ select <emphasis>
+ <property>JBoss Tools > Add Struts Capabilities</property>
+ </emphasis> from the context menu. This will start the process of adding
+ all necessary libraries and files to make this a Web Struts project.</para>
-<para>When working in Source view, you always have all the following features available:</para>
-<itemizedlist>
-<listitem><para>Content Assist</para></listitem>
-<listitem><para>Open On Selection</para></listitem>
-<listitem><para>File Folding</para></listitem>
-</itemizedlist>
-<section id="StrutsDiagramMode453">
-<?dbhtml filename="DiagramMode.html"?>
-<title>Diagram Mode</title>
+ <figure>
+ <title>Adding Struts Capabilities</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>The Diagram mode graphically displays the Web flow of the application defined in the Struts
-configuration file.</para>
+ <para>In the wizard you should point to location of your deployment descriptor
+ file web.xml and name of Web application.</para>
-<figure>
-<title>Diagram Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_14.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Choosing Project Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>After hitting <emphasis>
+ <property>Next</property>
+ </emphasis>, you will see the following screen. This screen simply means
+ that you need to add at least one Struts module to your project to make
+ this project a Struts project. Adding a Struts module means that a new
+ struts-config.xml will be added to your project and registered in the
+ web.xml file. In addition, all required Struts libraries will be added.
+ To add a Struts module, select the <emphasis>
+ <property>Add Struts Support</property>
+ </emphasis> button.</para>
+ <figure>
+ <title>Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_9.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>Just by right-clicking anywhere on the diagram, you can use a context menu to create the building
- blocks of a Struts application:</para>
-<itemizedlist>
-<listitem><para>Actions</para></listitem>
-<listitem><para>Global forwards</para></listitem>
-<listitem><para>Global exceptions</para></listitem>
-<listitem><para>JSP Pages</para></listitem>
-</itemizedlist>
+ <para>Here you can select what Struts version, Servlet class, URL pattern and
+ TLDs to add to this project.</para>
-<figure><title>Diagram Context Menu</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_15.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Selecting Struts Support Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_10.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>Along the upper-left side of the editor is a stack of seven icons for changing the behavior of the
-cursor in the diagram. The first icon switches to the default regular selection cursor, the second to the
- marquee selection cursor and the third to the new connection cursor. The last four icons switch the cursor
- to an insert cursor for each type of Struts build block listed above (and in the order listed).</para>
+ <para>When done, you will see the default Struts module configuration
+ information. See how to Edit <link
+ linkend="SupportForMultipleStrutsModules75">Struts
+ modules</link>.</para>
-<para>For instance, clicking on the first of these four icons (the one with the gears) will switch the
-cursor to insert actions. Clicking anywhere in the diagram with this cursor has the same effect as
-right-click and selecting <emphasis><property>Add > Action...</property></emphasis> from the context menu with the regular cursor active. It's just more efficient to use this cursor if you're adding more than one action at once.</para>
+ <figure>
+ <title>Project Configuration Information</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_11.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure><title>Insert Actions Cursor</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_16.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsTreeMode42">
- <?dbhtml filename="TreeMode.html"?>
-<title>Tree Mode</title>
+ <para>On the last screen you can set the different folders for your project as
+ well as register this application with a servlet container.</para>
-<para>In the Tree mode, the different elements of the Struts application are organized into functional
- categories on the left-hand side and a form for editing the properties of currently selected items on
- the right-hand side.</para>
+ <figure>
+ <title>Registering the Project at Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_12.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure><title>Tree Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_17.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>When done, you can open nd edit the struts-config.xml file using usefull
+ Struts configuration file editor provided by JBDS. (The Struts
+ configuration is shown below in the Tree viewer).</para>
-<para>You can also right-click on any node in the category tree and perform appropriate operations through
- a context menu. For instance, by right-clicking on the action-mappings category node, you can add new
- actions to the application.</para>
+ <figure>
+ <title>Struts-config.xml File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_13.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="GraphicalEditorForStrutsConfigurationFiles564">
+ <?dbhtml filename="GraphicalEditorForStrutsConfigurationFiles.html"?>
+ <title>Graphical Editor for Struts Configuration Files</title>
-<figure><title>Tree Context Menu</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_18.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsSourceMode9655">
- <?dbhtml filename="SourceMode.html"?>
-<title>Source Mode</title>
+ <para><property>The Struts configuration file editor</property> has three modes with
+ different reprisentation of <emphasis>
+ <property>struts-config.xml</property>
+ </emphasis>: Diagram, Tree and Source. The modes can be selected via the tabs
+ at the bottom of the editor. Any changes made in one mode are immediately
+ visible when you switch to any other mode.</para>
-<para>In the Source mode, you have complete editing control of the underlying XML coding:</para>
+ <para>When working in Source view, you always have all the following features
+ available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ <listitem>
+ <para>File Folding</para>
+ </listitem>
+ </itemizedlist>
+ <section id="StrutsDiagramMode453">
+ <?dbhtml filename="DiagramMode.html"?>
+ <title>Diagram Mode</title>
-<figure>
-<title>Source Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_19.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>The Diagram mode graphically displays the Web flow of the application
+ defined in the Struts configuration file.</para>
-<para>You can take advantage of code assist:</para>
+ <figure>
+ <title>Diagram Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_14.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure><title>Code Assist</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_20.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>Just by right-clicking anywhere on the diagram, you can use a context
+ menu to create the building blocks of a Struts application:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Actions</para>
+ </listitem>
+ <listitem>
+ <para>Global forwards</para>
+ </listitem>
+ <listitem>
+ <para>Global exceptions</para>
+ </listitem>
+ <listitem>
+ <para>JSP Pages</para>
+ </listitem>
+ </itemizedlist>
-<para>The editor will also immediately flag any errors:</para>
+ <figure>
+ <title>Diagram Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_15.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure>
-<title>Errors in Source Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_21.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>Along the upper-left side of the editor is a stack of seven icons for
+ changing the behavior of the cursor in the diagram. The first icon
+ switches to the default regular selection cursor, the second to the
+ marquee selection cursor and the third to the new connection cursor. The
+ last four icons switch the cursor to an insert cursor for each type of
+ Struts build block listed above (and in the order listed).</para>
-<para>Finally, you can use the Outline view with the editor to easily navigate through the file:</para>
+ <para>For instance, clicking on the first of these four icons (the one with the
+ gears) will switch the cursor to insert actions. Clicking anywhere in
+ the diagram with this cursor has the same effect as right-click and
+ selecting <emphasis>
+ <property>Add > Action...</property>
+ </emphasis> from the context menu with the regular cursor active.
+ It's just more efficient to use this cursor if you're
+ adding more than one action at once.</para>
-<figure><title>Outline View</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_22.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-</section>
-</section>
+ <figure>
+ <title>Insert Actions Cursor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_16.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsTreeMode42">
+ <?dbhtml filename="TreeMode.html"?>
+ <title>Tree Mode</title>
-<section id="GraphicalEditorForTilesFiles132">
-<?dbhtml filename="GraphicalEditorForTilesFiles.html"?>
-<title>Graphical Editor for Tiles Files</title>
+ <para>The Tree mode represents the different elements of the Struts application
+ that are organized into functional categories on the left-hand side and
+ a form for editing the properties of currently selected items on the
+ right-hand side.</para>
-<para><property>The Tiles configuration file editor</property> has three main viewers (modes): Tree (shown), Diagram and
-Source. The modes can be selected via the tabs at the bottom of the editor. Any changes made in one mode
- are immediately visible when you switch to any other mode.</para>
+ <figure>
+ <title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_17.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>When working in Source view, you always have all following features available:</para>
-<itemizedlist>
-<listitem><para>Content Assist</para></listitem>
-<listitem><para>Open On Selection</para></listitem>
-</itemizedlist>
-<section id="CreateNewTilesFile1422">
-<?dbhtml filename="CreateNewTilesFile.html"?>
-<title>Create New Tiles File</title>
+ <para>You can also right-click on any node in the category tree and perform
+ appropriate operations through a context menu. For instance, by
+ right-clicking on the action-mappings category node, you can add new
+ actions to the application.</para>
-<para>To create a new Tiles files, right click any folder and select <emphasis><property>New > Tiles File</property></emphasis>.</para>
-<figure><title>Creating a New Tiles File</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_23.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsTreeView896">
-<?dbhtml filename="TreeView.html"?>
-<title>Tree View</title>
+ <figure>
+ <title>Tree Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_18.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsSourceMode9655">
+ <?dbhtml filename="SourceMode.html"?>
+ <title>Source Mode</title>
-<para>In the Tree mode, the different elements of the Tiles file are organized into functional
-categories on the left-hand side and a form for editing the properties of currently selected items on
-the right-hand side.</para>
-<figure><title>Tree View</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_24.png" />
- </imageobject>
- </mediaobject>
- </figure>
+ <para>In the Source mode, you have complete editing control of the underlying
+ XML coding:</para>
-<para>To edit the file, simply right click any node and select among the available actions:</para>
-<figure>
-<title>Editing in Tiles Editor</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_25.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-</section>
-<section id="StrutsDiagramView4643">
-<?dbhtml filename="DigramView.html"?>
-<title>Diagram View</title>
+ <figure>
+ <title>Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_19.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>The Diagram mode is shown below:</para>
-<figure>
-<title>Diagram Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_26.png" />
- </imageobject>
- </mediaobject>
- </figure>
+ <para>You can take advantage of code assist:</para>
-<para>To create new definitions, simply right click anywhere in the diagram:</para>
-<figure>
-<title>Creating New Definition</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_27.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_20.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>You can also use the Diagram toolbar to make editing easier:</para>
-<figure>
-<title>Diagram Toolbar</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_28.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-</section>
-<section id="StrutsSource75">
-<?dbhtml filename="Source.html"?>
-<title>Source</title>
+ <para>The editor will also immediately flag any errors:</para>
-<para><property>The Tiles</property> editor also comes with a Source view that gives you full control over the source. Any
- changes here will immediately appear in other viewers when you switch to them.</para>
-<figure>
-<title>Source View</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_29.png" />
- </imageobject>
- </mediaobject>
- </figure>
-<para>Content assist is available in the Source mode:</para>
-<figure>
-<title>Content Assist in Source Mode</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_30.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-<para>Any errors are immediately reported as shown below:</para>
-<figure>
-<title>Errors Reporting</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_31.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Errors in Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_21.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>You can also use the Outline view together with the editor's Source mode. Selecting any node in
- the Outline view will jump to that place in the source.</para>
-<figure>
-<title>Outline View</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_32.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-</section>
-</section>
-<section id="GraphicalEditorForStrutsValidationFiles86">
-<?dbhtml filename="GraphicalEditorForStrutsValidationFiles.html"?>
-<title>Graphical Editor for Struts Validation Files</title>
+ <para>Finally, you can use the Outline view with the editor to easily navigate
+ through the file:</para>
-<para>JBoss Developer Studio comes with a <property>visual validation editor</property>. To create a new validation file,
- right click any folder and select <emphasis><property>File > Validation File</property></emphasis> from the context menu.</para>
-<figure>
-<title>Creating New Validation File</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_33.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_22.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
-<para>The validation editor works through a number of viewers.</para>
-<para>The Formsets viewer shows forms and their elements for which to define validation rules.</para>
-<figure>
-<title>Formsets Viewer</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_34.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <section id="GraphicalEditorForTilesFiles132">
+ <?dbhtml filename="GraphicalEditorForTilesFiles.html"?>
+ <title>Graphical Editor for Tiles Files</title>
-<para>The Constants viewer lets you set constant values for your validation rules.</para>
-<figure>
-<title>Constansts Viewer</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_35.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <para><property>The Tiles configuration file editor</property> has three main modes:
+ Tree (shown), Diagram and Source. The modes can be selected via the tabs at the
+ bottom of the editor. Any changes made in one mode are immediately visible when
+ you switch to any other mode.</para>
-<para>The validation file also can be viewed in a Tree viewer.</para>
-<figure>
-<title>Tree Viewer</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_36.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <para>When working in Source view, you always have all following features available:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Content Assist</para>
+ </listitem>
+ <listitem>
+ <para>Open On Selection</para>
+ </listitem>
+ </itemizedlist>
+ <section id="CreateNewTilesFile1422">
+ <?dbhtml filename="CreateNewTilesFile.html"?>
+ <title>Create New Tiles File</title>
-<para>At any point you have full control over the source by switching to the Source viewer. Any editing
- in this viewer will immediately be available in other viewers of this editor.</para>
-<figure>
-<title>Source Viewer</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_37.png"/>
- </imageobject>
-</mediaobject>
-</figure>
+ <para>To create a new Tiles files, right click any folder and select <emphasis>
+ <property>New > Tiles File</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Creating a New Tiles File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_23.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsTreeView896">
+ <?dbhtml filename="TreeView.html"?>
+ <title>Tree Mode</title>
-<para>You can also open your own custom or Struts-standard validation-rules.xml file.</para>
-<para>The Validators viewer shows the validation rules for a selected validator. You can of course add
-your own rules.</para>
-<figure>
-<title>Validators Viewer</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_38.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Here are the validation rules shown in the Source viewer.</para>
-<figure>
-<title>Validation Rules</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_39.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-<section id="SupportForMultipleStrutsModules75">
-<?dbhtml filename="SupportForMultipleStrutsModules.html"?>
-<title>Support for Multiple Struts Modules</title>
-<section id="StrutsModulesghf07">
-<?dbhtml filename="StrutsModules.html"?>
-<title>Struts Modules</title>
-<para>JBoss Developer Studio supports working with Struts projects that have multiple <property>modules</property>. You can easily do the following:</para>
-<itemizedlist>
-<listitem><para>Add new modules</para></listitem>
-<listitem><para>Edit modules for an existing project or during Struts project import</para></listitem>
-</itemizedlist>
-</section>
-<section id="WhenImportingAStrutsProject432">
-<?dbhtml filename="WhenImportingAStrutsProject.html"?>
-<title>When Importing a Struts Project</title>
+ <para>The Tree mode represents the different elements of the Tiles file that
+ are organized into functional categories on the left-hand side and a
+ form for editing the properties of currently selected items on the
+ right-hand side.</para>
+ <figure>
+ <title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_24.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>During Struts project import, if the project has multiple modules, you will see a screen with all
- existing modules. You can select each module and edit its details.</para>
+ <para>To edit the file, simply right click any node and select among the
+ available actions:</para>
+ <figure>
+ <title>Editing in Tiles Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_25.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsDiagramView4643">
+ <?dbhtml filename="DigramView.html"?>
+ <title>Diagram Mode</title>
-<figure>
-<title>Configuring Project Modules</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_40.png" />
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-<section id="EditingModulesInAnExistingProject1">
-<?dbhtml filename="EditingModulesInAnExistingProject.html"?>
-<title>Editing Modules in an Existing Project</title>
-<para>To edit modules in an existing project, right click the project and select
-<emphasis><property>JBoss Tools > Modules Configuration</property></emphasis>.</para>
-<figure>
-<title>Choosing Modules Configuration</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_41.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>You will see the same screen as above where you will be able to select a module and edit its details:</para>
-<figure>
-<title>Modules Configuration</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_42.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-<section id="AddingNewModules1">
-<?dbhtml filename="AddingMewModules.html"?>
-<title>Adding New Modules</title>
+ <para>The Diagram mode is shown below:</para>
+ <figure>
+ <title>Diagram Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_26.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>Adding a new module is very simple. First switch to Web Project view. Expand your project to
- the Configuration folder. Under that folder you should see the current modules. Right click on Configuration
- and select <emphasis><property>New > Struts Config</property></emphasis>.</para>
- <figure>
- <title>Adding New Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_43.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>You will see the screen below. You can specify a new module name and also
- add the new Struts configuration file to web.xml file.</para>
-<figure>
-<title>Adding New Modules</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_44.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-</section>
-</section>
-<section id="CodeGenerationForActionFormBeanForwardAndExceptionClasses1">
-<?dbhtml filename="CodeGenerationForActionFormBeanForwardAndExceptionClasses.html"?>
-<title>Code Generation for Action, FormBean, Forward and Exception Classes</title>
+ <para>To create new definitions, simply right click anywhere in the diagram:</para>
+ <figure>
+ <title>Creating New Definition</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_27.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>JBoss Developer Studio comes with a <property>code generation</property> feature. You can generate stub code for
- Struts Actions, FormBeans, Forwards and Exceptions.</para>
+ <para>You can also use the Diagram toolbar to make editing easier.</para>
+ <figure>
+ <title>Diagram Toolbar</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_28.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>The code generation in JBoss Developer Studio is based on Velocity templates which can be modified for your use. The templates are located at <emphasis><property> {RedHatDeveloperStudioHome} > templates > codegeneration</property> </emphasis>.</para>
+ <para> It contains four icons for changing the cursor state. The first one is
+ the default cursor state for selecting existing nodes. The second icon
+ is marquee selector. The third is used for creating new connections and
+ the last one is for adding definition template.</para>
+ </section>
+ <section id="StrutsSource75">
+ <?dbhtml filename="Source.html"?>
+ <title>Source</title>
-<para>There are a number of ways to invoke code generation. One is simply right-clicking the Struts
- diagram and selecting <emphasis><property>Generate Java Code....</property></emphasis></para>
+ <para>The other mode of the <property>Tiles editor</property> is the Source mode that
+ gives you full control over the source. Any changes here will
+ immediately appear in other modes when you switch to them.</para>
+ <figure>
+ <title>Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_29.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Code assist is available in the Source mode:</para>
+ <figure>
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_30.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Any errors are immediately reported as shown below:</para>
+ <figure>
+ <title>Errors Reporting</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_31.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure><title>Selecting Generate Java Code</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_45.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>You can also use the Outline view together with the editor's
+ Source mode. It provides the navigation through the file.</para>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_32.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="GraphicalEditorForStrutsValidationFiles86">
+ <?dbhtml filename="GraphicalEditorForStrutsValidationFiles.html"?>
+ <title>Graphical Editor for Struts Validation Files</title>
-<para>On this screen you can select for which elements to generate code. If you select Next you will be
- able to specify more options for each of the categories you selected.</para>
+ <para>JBoss Developer Studio comes with a <property>visual validation
+ editor</property>. To create a new validation file, right click any folder and
+ select <emphasis>
+ <property>File > Validation File</property>
+ </emphasis> from the context menu.</para>
+ <figure>
+ <title>Creating New Validation File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_33.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure>
-<title>Generate - Step 1</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_46.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>The validation editor works through a number of viewers.</para>
+ <para>The Formsets viewer shows forms and their elements for which to define
+ validation rules.</para>
+ <figure>
+ <title>Formsets Viewer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_34.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<tip><title>Tip:</title><para>please be careful not to override your existing files.</para></tip>
+ <para>The Constants viewer lets you set constant values for your validation rules.</para>
+ <figure>
+ <title>Constansts Viewer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_35.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>When generation is complete, a result window will appear letting you know how many classes were
-generated:</para>
+ <para>The validation file also can be viewed in a Tree viewer.</para>
+ <figure>
+ <title>Tree Viewer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_36.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<figure>
-<title>Generation Finished</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_47.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>At any point you have full control over the source by switching to the Source
+ viewer. Any editing in this viewer will immediately be available in other
+ viewers of this editor.</para>
+ <figure>
+ <title>Source Viewer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_37.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-<para>You don't always have to generate code for all elements at once. You can invoke generation
- for just an individual Struts artifact as well. Right-click an element on the diagram of the Struts
- configuration file and select <emphasis><property>Generate Java Code...</property></emphasis> from the context menu.</para>
+ <para>You can also open your own custom or Struts-standard validation-rules.xml file.</para>
+ <para>The Validators viewer shows the validation rules for a selected validator. You
+ can of course add your own rules.</para>
+ <figure>
+ <title>Validators Viewer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_38.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Here are the validation rules shown in the Source viewer.</para>
+ <figure>
+ <title>Validation Rules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_39.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="SupportForMultipleStrutsModules75">
+ <?dbhtml filename="SupportForMultipleStrutsModules.html"?>
+ <title>Support for Multiple Struts Modules</title>
+ <section id="StrutsModulesghf07">
+ <?dbhtml filename="StrutsModules.html"?>
+ <title>Struts Modules</title>
+ <para>JBoss Developer Studio supports working with Struts projects that have
+ multiple <property>modules</property>. You can easily do the following:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Add new modules</para>
+ </listitem>
+ <listitem>
+ <para>Edit modules for an existing project or during Struts
+ project import</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="WhenImportingAStrutsProject432">
+ <?dbhtml filename="WhenImportingAStrutsProject.html"?>
+ <title>When Importing a Struts Project</title>
-<figure>
-<title>Generation For Individual Struts Artifact</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_48.png"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>During Struts project import, if the project has multiple modules, you
+ will see a screen with all existing modules. You can select each module
+ and edit its details.</para>
-<para>The same can be done from within the Tree viewer for the editor of the Struts configuration file.</para>
+ <figure>
+ <title>Configuring Project Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_40.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="EditingModulesInAnExistingProject1">
+ <?dbhtml filename="EditingModulesInAnExistingProject.html"?>
+ <title>Editing Modules in an Existing Project</title>
+ <para>To edit modules in an existing project, right click the project and
+ select <emphasis>
+ <property>JBoss Tools > Modules Configuration</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Choosing Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_41.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the same screen as above where you will be able to select a
+ module and edit its details:</para>
+ <figure>
+ <title>Modules Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_42.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="AddingNewModules1">
+ <?dbhtml filename="AddingMewModules.html"?>
+ <title>Adding New Modules</title>
-<figure>
-<title>Generation in Struts Config Editor</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_49.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-</section>
-<section id="StrutsConfigurationFileDebugger097">
-<?dbhtml filename="StrutsConfigurationFileDebugger.html"?>
-<title>Struts Configuration File Debugger</title>
+ <para>Adding a new module is very simple. First switch to Web Project view.
+ Expand your project to the Configuration folder. Under that folder you
+ should see the current modules. Right click on Configuration and select <emphasis>
+ <property>New > Struts Config</property>
+ </emphasis>.</para>
+ <figure>
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_43.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>You will see the screen below. You can specify a new module name and also
+ add the new Struts configuration file to web.xml file.</para>
+ <figure>
+ <title>Adding New Modules</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_44.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ </section>
+ <section id="CodeGenerationForActionFormBeanForwardAndExceptionClasses1">
+ <?dbhtml filename="CodeGenerationForActionFormBeanForwardAndExceptionClasses.html"?>
+ <title>Code Generation for Action, FormBean, Forward and Exception Classes</title>
-<para>JBoss Developer Studio comes with <property>Struts configuration file debugger</property>. It allows you to set break points on Struts diagram and then simply launch the server in debug mode.</para>
+ <para>JBoss Developer Studio comes with a <property>code generation</property>
+ feature. You can generate stub code for Struts Actions, FormBeans, Forwards and
+ Exceptions.</para>
- <para>Simply right click an Action or a page and select Add <emphasis><property>Breakpoint</property></emphasis>. </para>
-<figure>
-<title>Adding Breakpoint</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_50.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-<section id="CustomizablePageLinksRecognizer1">
- <?dbhtml filename="CustomizablePageLinksRecognizer.html"?>
-<title>Customizable Page Links Recognizer</title>
+ <para>The code generation in JBoss Developer Studio is based on Velocity templates
+ which can be modified for your use. The templates are located at <emphasis>
+ <property> {RedHatDeveloperStudioHome} > templates >
+ codegeneration</property>
+ </emphasis>.</para>
-<para><property>Custom page links</property> allow you to define custom Struts page links that will be recognizable in the
- Struts application diagram. You can define these links by selecting <emphasis><property>Window > Preferences</property></emphasis> from the menu bar and then selecting <emphasis><property>JBoss Tools > Web > Struts > Customization</property></emphasis> from the Preferences dialog box.</para>
- <figure>
-<title>Customization Panel</title>
-<mediaobject>
- <imageobject>
- <imagedata fileref="images/struts/struts_51.png" />
- </imageobject>
- </mediaobject>
- </figure>
-</section>
+ <para>There are a number of ways to invoke code generation. One is simply
+ right-clicking the Struts diagram and selecting <emphasis>
+ <property>Generate Java Code....</property>
+ </emphasis></para>
+
+ <figure>
+ <title>Selecting Generate Java Code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_45.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>On this screen you can select for which elements to generate code. If you select
+ Next you will be able to specify more options for each of the categories you
+ selected.</para>
+
+ <figure>
+ <title>Generate - Step 1</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_46.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para>please be careful not to override your existing files.</para>
+ </tip>
+
+ <para>When generation is complete, a result window will appear letting you know how
+ many classes were generated:</para>
+
+ <figure>
+ <title>Generation Finished</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_47.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>You don't always have to generate code for all elements at once. You
+ can invoke generation for just an individual Struts artifact as well.
+ Right-click an element on the diagram of the Struts configuration file and
+ select <emphasis>
+ <property>Generate Java Code...</property>
+ </emphasis> from the context menu.</para>
+
+ <figure>
+ <title>Generation For Individual Struts Artifact</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_48.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The same can be done from within the Tree viewer for the editor of the Struts
+ configuration file.</para>
+
+ <figure>
+ <title>Generation in Struts Config Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_49.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsConfigurationFileDebugger097">
+ <?dbhtml filename="StrutsConfigurationFileDebugger.html"?>
+ <title>Struts Configuration File Debugger</title>
+
+ <para>JBoss Developer Studio comes with <property>Struts configuration file
+ debugger</property>. It allows you to set break points on Struts diagram and
+ then simply launch the server in debug mode.</para>
+
+ <para>Simply right click an Action or a page and select Add <emphasis>
+ <property>Breakpoint</property>
+ </emphasis>. </para>
+ <figure>
+ <title>Adding Breakpoint</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_50.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="CustomizablePageLinksRecognizer1">
+ <?dbhtml filename="CustomizablePageLinksRecognizer.html"?>
+ <title>Customizable Page Links Recognizer</title>
+
+ <para><property>Custom page links</property> allow you to define custom Struts page
+ links that will be recognizable in the Struts application diagram. You can
+ define these links by selecting <emphasis>
+ <property>Window > Preferences</property>
+ </emphasis> from the menu bar and then selecting <emphasis>
+ <property>JBoss Tools > Web > Struts > Customization</property>
+ </emphasis> from the Preferences dialog box.</para>
+ <figure>
+ <title>Customization Panel</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/struts/struts_51.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
</chapter>
18 years