Author: ykryvinchanka
Date: 2008-04-01 14:21:35 -0400 (Tue, 01 Apr 2008)
New Revision: 7258
Modified:
trunk/struts/docs/struts_tools_ref_guide/en/modules/struts_tools.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-226 Struts guide. Scale parameter has been
redefined in xml file
Modified: trunk/struts/docs/struts_tools_ref_guide/en/modules/struts_tools.xml
===================================================================
--- trunk/struts/docs/struts_tools_ref_guide/en/modules/struts_tools.xml 2008-04-01
18:08:34 UTC (rev 7257)
+++ trunk/struts/docs/struts_tools_ref_guide/en/modules/struts_tools.xml 2008-04-01
18:21:35 UTC (rev 7258)
@@ -1,1039 +1,944 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="struts_tools">
- <?dbhtml filename="struts_tools.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>Struts Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Struts support</title>
+ <?dbhtml filename="struts_tools.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>Struts Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
- <section id="WorkingWithStrutsProjects866">
+ <title>Struts support</title>
- <title>Working with Projects</title>
+ <section id="WorkingWithStrutsProjects866">
- <para>JBoss Developer Studio provides the following
functionality when
- working with Struts:</para>
+ <title>Working with Projects</title>
+ <para>JBoss Developer Studio provides the following functionality
when working with
+ Struts:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Create new <property>Struts
projects</property></para>
+ </listitem>
+ <listitem>
+ <para>Import (open) existing Struts projects. 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>
+
+
+ <section id="CreatingANewStrutsProjec745t">
+
+ <title>Creating a New Struts Project</title>
+
+
+ <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
steps:</para>
<itemizedlist>
<listitem>
- <para>Create new <property>Struts
projects</property></para>
+ <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>
+ </itemizedlist>
+ <figure>
+ <title>Selecting Struts Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
<listitem>
- <para>Import (open) existing Struts
projects. You can import
- any project structure</para>
+ <para>On this form, provide the
<property>Project
+ Name</property>. You can also
select where to create
+ the project or use the default
path.</para>
+ <para>Next to <property>Struts
Environment</property> set
+ which Struts version to
use.</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>
+ <figure>
+ <title>Creating Struts Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <section id="CreatingANewStrutsProjec745t">
+ <tip>
+ <title>Tip:</title>
+ <para>Don't put spaces in project names
since some OS could
+ experience problems with their processing and
searching
+ these files.</para>
+ </tip>
- <title>Creating a New Struts Project</title>
+ <para>You can select the KickStart template, then the
project created will
+ include a simple Hello World type application that is
ready to run.</para>
+ <figure>
+ <title>Choosing Struts Template </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_3_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <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
- steps:</para>
- <itemizedlist>
- <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>
- </itemizedlist>
- <figure>
- <title>Selecting Struts
Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_2.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>On this form, provide the
<property>Project
- Name</property>. You can also
select
- where to create the project or use the
- default path.</para>
- <para>Next to
<property>Struts
- Environment</property> set which
Struts
- version to use.</para>
- </listitem>
- </itemizedlist>
-
- <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 since some
- OS could experience problems with their
processing
- and searching these files.</para>
- </tip>
-
- <para>You can select the KickStart template, then
the project
- created will include a simple Hello World type
application
- that is ready to run.</para>
-
- <figure>
- <title>Choosing Struts Template
</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_3_1.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>Next, you 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">
+ <itemizedlist>
+ <listitem>
+ <para>Next, you 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>
- </itemizedlist>
- <figure>
- <title>Registering The Project at
Server</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_4.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>On the next form, you can
select the TLD files
- to include in this
project:</para>
- </listitem>
- </itemizedlist>
- <figure>
- <title>Selecting Tag
Libraries</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_5.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ </emphasis> check box if for some
reason you
+ don't want to register your
application at
+ this point.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Registering The Project at
Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>On the next form, you can select the
TLD files to
+ include in this project:</para>
+ </listitem>
+ </itemizedlist>
+ <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>
+ <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>
+ <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">
+ <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">
- <title>Importing an Existing Struts Project with
Any Structure</title>
+ <title>Importing an Existing Struts Project with Any
Structure</title>
- <para>For detailed information on migration
projects to JBoss
- Developer Studio see <ulink
-
url="../../../Exadel-migration/en/html_single/index.html"
- >Migration
Guide</ulink>.</para>
+ <para>For detailed information on migration projects to
JBoss Developer
+ Studio see <ulink
+
url="../../../Exadel-migration/en/html_single/index.html"
+ >Migration Guide</ulink>.</para>
- </section>
- <section
id="AddingStrutsCapabilityToAnExistingWebApplication532">
+ </section>
+ <section
id="AddingStrutsCapabilityToAnExistingWebApplication532">
- <title>Adding Struts Capability to an Existing Web
Application</title>
+ <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 to your 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>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 to your 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>
+ <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 the
project.</para>
+ <para>In the wizard you should point to location of your
deployment
+ descriptor file web.xml and name of the
project.</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>
+ <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
<property>Version</property>,
- <property>Servlet
Class</property>, <property>URL
- Pattern</property> and
<property>TLD</property>s to
- add to this project.</para>
+ <para>Here you can select what Struts
<property>Version</property>,
+ <property>Servlet Class</property>,
<property>URL
+ Pattern</property> and
<property>TLD</property>s 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>
+ <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>
+ <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>
+ <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. If you want the libraries (.jar files)
will be
- automatically added to your project, click on the
checkbox <emphasis>
- <property>Add
Libraries</property>.</emphasis></para>
+ <para>On the last screen you can set the different folders
for your project
+ as well as register this application with a servlet
container. If
+ you want the libraries (.jar files) will be automatically
added to
+ your project, click on the checkbox <emphasis>
+ <property>Add
Libraries</property>.</emphasis></para>
- <figure>
- <title>Registering the Project at
Server</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_12.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <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 end 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>When done, you can open end 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"
+ <figure>
+ <title>Struts-config.xml File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_13.png"
scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
+ </imageobject>
+ </mediaobject>
+ </figure>
</section>
- <section
id="GraphicalEditorForStrutsConfigurationFiles564">
+ </section>
+ <section id="GraphicalEditorForStrutsConfigurationFiles564">
- <title>Graphical Editor for Struts Configuration
Files</title>
+ <title>Graphical Editor for Struts Configuration
Files</title>
- <para>The Struts configuration file editor has three modes
with different
- representation 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>The Struts configuration file editor has three modes with
different
+ representation 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>
+ <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">
+
+ <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>The Diagram mode allows to edit navigation in your
Struts application.
+ 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>Content Assist</para>
+ <para>Actions</para>
</listitem>
<listitem>
- <para>Open On Selection</para>
+ <para>Global forwards</para>
</listitem>
<listitem>
- <para>File Folding</para>
+ <para>Global exceptions</para>
</listitem>
+ <listitem>
+ <para>JSP Pages</para>
+ </listitem>
</itemizedlist>
- <section id="StrutsDiagramMode453">
- <title>Diagram Mode</title>
+ <figure>
+ <title>Diagram Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_15.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>The Diagram mode graphically displays the Web
flow of the
- application defined in the Struts configuration
file.</para>
+ <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.
</para>
- <figure>
- <title>Diagram Mode</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_14.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Editor Icons</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_16.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>The Diagram mode allows to edit navigation in
your Struts
- application. 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 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>
- <figure>
- <title>Diagram Context Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_15.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <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>
- <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. </para>
- <figure>
- <title>Editor Icons</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_16.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ </section>
+ <section id="StrutsTreeMode42">
- <para>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>
+ <title>Tree Mode</title>
- <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>
+ <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>
-
- </section>
- <section id="StrutsTreeMode42">
-
+ <figure>
<title>Tree Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_17.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <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>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 Mode</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_17.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Tree Context Menu</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_18.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="StrutsSourceMode9655">
- <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>
+ <title>Source Mode</title>
- <figure>
- <title>Tree Context Menu</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_18.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="StrutsSourceMode9655">
+ <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>In the Source mode, you have complete editing
control of the
- underlying XML coding.</para>
+ <para>You can take advantage of <link
+
linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"
+ >code assist</link>.</para>
- <figure>
- <title>Source Mode</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_19.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Code Assist</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_20.png"
+ scale="85"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>You can take advantage of <link
-
linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"
- >code
assist</link>.</para>
+ <para>The editor will also immediately flag any
errors.</para>
- <figure>
- <title>Code Assist</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_20.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Errors in Source Mode</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_21.png"
+ scale="85"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>The editor will also immediately flag any
errors.</para>
+ <para>Finally, you can use the Outline view with the editor
to easily
+ navigate through the file.</para>
- <figure>
- <title>Errors in Source Mode</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_21.png"
- scale="83"/>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_22.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
- <para>Finally, you can use the Outline view with
the editor to
- easily navigate through the file.</para>
+ <para>Find more information about editor features <link
linkend="editors_features"
+ >here</link>.</para>
- <figure>
- <title>Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_22.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
+ </section>
- <para>Find more information about editor features <link
-
linkend="editors_features">here</link>.</para>
+ <section id="GraphicalEditorForTilesFiles132">
- </section>
+ <title>Graphical Editor for Tiles Files</title>
- <section id="GraphicalEditorForTilesFiles132">
+ <para>The Tiles configuration file editor has three main modes:
Tree, 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>
- <title>Graphical Editor for Tiles Files</title>
+ <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">
- <para>The Tiles configuration file editor has three main
modes: Tree,
- 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>
+ <title>Create New Tiles File</title>
- <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">
+ <para>To create 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">
- <title>Create New Tiles File</title>
+ <title>Tree Mode</title>
- <para>To create 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">
-
+ <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>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">
-
- <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">
-
- <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><link
-
linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"
- >Code assist</link> is available
in the Source mode.</para>
- <figure>
- <title>Code Assist</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_30.png"
- scale="85"/>
- </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"
- scale="75"/>
- </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"
- scale="85"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
+ <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="GraphicalEditorForStrutsValidationFiles86">
+ <section id="StrutsDiagramView4643">
- <title>Graphical Editor for Struts Validation
Files</title>
+ <title>Diagram Mode</title>
- <para>Providing full support for development Struts
applications JBoss
- Developer Studio comes with a visual validation editor.
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>
+ <para>The Diagram mode allows you to create complex Tiles
files in the form
+ of a diagram.</para>
<figure>
- <title>Creating New Validation File</title>
+ <title>Diagram Mode</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_33.png"/>
+ <imagedata
fileref="images/struts/struts_26.png"/>
</imageobject>
</mediaobject>
</figure>
- <para>The validation editor works with five modes:
Formsets, Validators,
- Constants and standard Tree and Source that you can
easily switch
- over 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>
+ <para>To create new definitions, simply right click
anywhere in the diagram.</para>
<figure>
- <title>Formsets Mode</title>
+ <title>Creating New Definition</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_34.png"/>
+ <imagedata
fileref="images/struts/struts_27.png"/>
</imageobject>
</mediaobject>
</figure>
- <para>The Constants mode let you set constant values for
your validation
- rules.</para>
+ <para>You can also use the Diagram toolbar to make editing
easier.</para>
<figure>
- <title>Constansts Mode</title>
+ <title>Diagram Toolbar</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_35.png"/>
+ <imagedata
fileref="images/struts/struts_28.png"/>
</imageobject>
</mediaobject>
</figure>
- <para>The validation file can also be viewed in a Tree
mode.</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 to
+ the content.</para>
+ </section>
+ <section id="StrutsSource75">
+
+ <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>Tree Mode</title>
+ <title>Source Mode</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_36.png"/>
+ <imagedata
fileref="images/struts/struts_29.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>
+ <para><link
linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"
+ >Code assist</link> is available in the
Source mode.</para>
<figure>
- <title>Source Mode</title>
+ <title>Code Assist</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_37.png"
+ <imagedata
fileref="images/struts/struts_30.png"
scale="85"/>
</imageobject>
</mediaobject>
</figure>
-
- <para>You can also open your own custom or Struts-standard
<emphasis>
-
<property>validation-rules.xml</property>
- </emphasis> file.</para>
- <para>The Validators mode shows the validation rules for a
selected
- validator. You can of course add your own
rules.</para>
+ <para>Any errors are immediately reported as shown
below:</para>
<figure>
- <title>Validators Mode</title>
+ <title>Errors Reporting</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_38.png"
+ <imagedata
fileref="images/struts/struts_31.png"
scale="75"/>
</imageobject>
</mediaobject>
</figure>
- <para>Here are the validation rules shown in the Source
mode.</para>
+
+ <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>Validation Rules</title>
+ <title>Outline View</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_39.png"
- scale="75"/>
+ <imagedata
fileref="images/struts/struts_32.png"
+ scale="85"/>
</imageobject>
</mediaobject>
</figure>
</section>
- <section id="SupportForMultipleStrutsModules75">
+ </section>
+ <section id="GraphicalEditorForStrutsValidationFiles86">
- <title>Support for Multiple Struts Modules</title>
+ <title>Graphical Editor for Struts Validation Files</title>
- <para>JBoss Developer Studio supports working with Struts
projects that have
- multiple modules. 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>
+ <para>Providing full support for development Struts applications
JBoss Developer
+ Studio comes with a visual validation editor. 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>
- <section id="WhenImportingAStrutsProject432">
+ <para>The validation editor works with five modes: Formsets,
Validators, Constants
+ and standard Tree and Source that you can easily switch over
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>
- <title>When Importing a Struts
Project</title>
+ <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>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 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>
- <figure>
- <title>Configuring Project
Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata
-
fileref="images/struts/struts_40.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section
id="EditingModulesInAnExistingProject1">
+ <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" scale="85"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
- <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">
+ <para>You can also open your own custom or Struts-standard
<emphasis>
+ <property>validation-rules.xml</property>
+ </emphasis> 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" scale="75"
+ />
+ </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">
- <title>Adding New Modules</title>
+ <title>Support for Multiple Struts 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">
+ <para>JBoss Developer Studio supports working with Struts projects
that have
+ multiple modules. 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>
- <title>Code Generation for Action, FormBean, Forward and
Exception Classes</title>
+ <section id="WhenImportingAStrutsProject432">
- <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>
+ <title>When Importing a Struts Project</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>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>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>
+ <title>Configuring Project Modules</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_45.png"/>
+ <imagedata
fileref="images/struts/struts_40.png"/>
</imageobject>
</mediaobject>
</figure>
+ </section>
+ <section id="EditingModulesInAnExistingProject1">
- <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>
-
+ <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>Generate - Step 1</title>
+ <title>Choosing Modules
Configuration</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_46.png"/>
+ <imagedata
fileref="images/struts/struts_41.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>
-
+ <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>Generation Finished</title>
+ <title>Modules Configuration</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_47.png"/>
+ <imagedata
fileref="images/struts/struts_42.png"/>
</imageobject>
</mediaobject>
</figure>
+ </section>
+ <section id="AddingNewModules1">
- <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>
+ <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>Generation For Individual Struts
Artifact</title>
+ <title>Adding New Modules</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_48.png"/>
+ <imagedata
fileref="images/struts/struts_43.png"/>
</imageobject>
</mediaobject>
</figure>
-
- <para>The same can be done from within the Tree viewer for
the editor of the
- Struts configuration file.</para>
-
+ <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>Generation in Struts Config
Editor</title>
+ <title>Adding New Modules</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/struts/struts_49.png"/>
+ <imagedata
fileref="images/struts/struts_44.png"/>
</imageobject>
</mediaobject>
</figure>
</section>
- <section id="StrutsConfigurationFileDebugger097">
+ </section>
+ <section
id="CodeGenerationForActionFormBeanForwardAndExceptionClasses1">
- <title>Struts Configuration File Debugger</title>
+ <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">
+ <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>
- <title>Customizable Page Links Recognizer</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><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>
+ <figure>
+ <title>Selecting Generate Java Code</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/struts/struts_45.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <section>
- <title>Relevant Resources Links</title>
- <para>Find out necessary information on <ulink
-
url="http://struts.apache.org/">Struts technology</ulink> if
- you don't know enough.</para>
- </section>
- </chapter>
\ No newline at end of file
+ <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">
+
+ <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">
+
+ <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>
+
+ <section>
+ <title>Relevant Resources Links</title>
+ <para>Find out necessary information on <ulink
url="http://struts.apache.org/"
+ >Struts technology</ulink> if you don't
know enough.</para>
+ </section>
+</chapter>