Author: irooskov(a)redhat.com Date: 2010-03-08 19:42:21 -0500 (Mon, 08 Mar 2010) New Revision: 20699 Added: trunk/struts/docs/struts_tools_ref_guide/en-US/ trunk/struts/docs/struts_tools_ref_guide/en-US/Author_Group.xml trunk/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml trunk/struts/docs/struts_tools_ref_guide/en-US/Preface.xml trunk/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml trunk/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml trunk/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml trunk/struts/docs/struts_tools_ref_guide/en-US/editors.xml trunk/struts/docs/struts_tools_ref_guide/en-US/images/ trunk/struts/docs/struts_tools_ref_guide/en-US/images/favicon.ico trunk/struts/docs/struts_tools_ref_guide/en-US/images/jbosstools_logo.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/ trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/Thumbs.db trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_10.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_11.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_12.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_13.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_14.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_15.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_16.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_17.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_18.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_19.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_2.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_20.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_21.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_22.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_23.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_24.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_25.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_26.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_27.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_28.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_29.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_30.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_31.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_32.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_33.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_34.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_35.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_36.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_37.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_38.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_39.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3_1.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_4.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_40.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_41.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_42.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_43.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_44.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_45.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_46.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_47.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_48.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_49.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_5.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_50.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_51.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_6.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_7.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_8.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_9.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/ trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_10.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_11.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_12.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_13.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_14.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_8.png trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_9.png trunk/struts/docs/struts_tools_ref_guide/en-US/introduction.xml trunk/struts/docs/struts_tools_ref_guide/en-US/master.xml trunk/struts/docs/struts_tools_ref_guide/en-US/master_output.xml trunk/struts/docs/struts_tools_ref_guide/en-US/modules.xml trunk/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml trunk/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml trunk/struts/docs/struts_tools_ref_guide/en-US/projects.xml trunk/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml trunk/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml trunk/struts/docs/struts_tools_ref_guide/publican.cfg Removed: trunk/struts/docs/struts_tools_ref_guide/en/ Modified: trunk/struts/docs/struts_tools_ref_guide/pom.xml Log: modified book to build with publican and maven Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Author_Group.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Author_Group.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Author_Group.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,6 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<authorgroup><author><firstname>Anatoly</firstname><surname>Fedosik</surname></author> + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + <author&gt;&lt;firstname&gt;Svetlana&lt;/firstname&gt;&lt;surname&gt;Mukhina&lt;/surname&gt;&lt;email&gt;smukhina(a)exadel.com&lt;/email&gt;&lt;/author&gt;&lt;/authorgroup&gt; Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Book_Info.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,4 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<bookinfo><title>Struts Tools Reference Guide</title><subtitle>Provides information relating to the BPMN Convert module.</subtitle><productname>JBoss Developer Studio</productname><productnumber>3.0</productnumber><edition>1.0</edition><pubsnumber>0</pubsnumber><abstract><para>The Struts Tools Reference Guide explains how to use the Struts Tools to create high-quality web applications.</para></abstract><corpauthor><inlinemediaobject><imageobject><imagedata fileref="Common_Content/images/title_logo.svg" format="SVG"></imagedata></imageobject></inlinemediaobject></corpauthor><xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g... href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g... Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Preface.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Preface.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Preface.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,4 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<preface><title>Preface</title><xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g... href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g... Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Revision_History.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,4 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<appendix><title>Revision History</title><simpara><revhistory><revision><revnumber>0</revnumber><date>Fri Nov 20 2009</date><author><firstname>Isaac</firstname><surname>Rooskov</surname><email>irooskov@redhat.com</email></author><revdescription><simplelist><member>Initial creation of book by publican</member></simplelist></revdescription></revision></revhistory></simpara></appendix> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.ent 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,4 @@ +<!ENTITY PRODUCT "JBoss"> +<!ENTITY BOOKID "Struts_Tools_Reference_Guide"> +<!ENTITY YEAR "2010"> +<!ENTITY HOLDER "Red Hat"> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/Struts_Tools_Reference_Guide.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,18 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +]> +<book> +<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="projects.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="editors.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="modules.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="code_generation.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="config_file_debugger.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="page_links_recognizer.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="project_verification.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="rel_resources_links.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> +<index></index> +</book> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/code_generation.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="code_generation"> + <?dbhtml filename="code_generation.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Code Generation</title> + + <para>JBoss Tools 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 that JBoss tooling provides is based on Velocity templates + which can be modified for your use. The templates are located at <emphasis> + <property> {JBossStudioHome} > 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&apos;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> +</chapter> \ No newline at end of file Added: trunk/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/config_file_debugger.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,30 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="config_file_debugger"> + <?dbhtml filename="config_file_debugger.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 Configuration File Debugger</title> + + <para>JBoss Tools come 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> +</chapter> \ No newline at end of file Added: trunk/struts/docs/struts_tools_ref_guide/en-US/editors.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/editors.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/editors.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,479 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="editors"> + <?dbhtml filename="editors.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Editors</title> + <para>In this chapter we&apos;ll introduce you to featured graphical editors for specific + Struts files such as Struts Configuration files, Tiles files, Struts Validation files and web.xml.</para> + + <section id="webxml_editor"> + <title>Web.xml Editor</title> + + <para>The <emphasis> + <property>web.xml</property></emphasis> file inside the <emphasis> + <property>WEB-INF</property></emphasis> folder is a deployment descriptor file for a Web Application. It + describes the servlets and other components and deployment properties that make up your application.</para> + + <para><property>JBoss Tools</property> add the <emphasis> + <property>web.xml</property></emphasis> file to created Struts project automatically and provides a special editor for its editing. + See the Visual Web Tools guide that gives a descriptive information on the <filename>web.xml</filename> editor.</para> + </section> + + <section id="struts_config_editor"> + + <title>Graphical Editor for Struts Configuration Files</title> + <para>First, let&apos;s dwell on the Struts Configuration file editor.</para> + <para>This editor has three views with different representation of <emphasis> + <property>struts-config.xml</property>: </emphasis>Diagram, Tree and Source. The + views can be selected via the tabs at the bottom of the editor. Any changes made in one + view are immediately visible when you switch to any other view.</para> + + <para>Now, we&apos;ll consider every view in more detail.</para> + <section id="StrutsDiagramMode453"> + + <title>Diagram View</title> + + <para>The Diagram view graphically displays the Web flow of the application defined in + the Struts configuration file.</para> + + <figure> + <title>Diagram View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_14.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The Diagram view 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> + + <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. </para> + + <figure> + <title>Editor Icons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_16.png"/> + </imageobject> + </mediaobject> + </figure> + + <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> + + <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&apos;s just + more efficient to use this cursor if you&apos;re adding more than one action at + once.</para> + + + </section> + <section id="StrutsTreeMode42"> + + <title>Tree View</title> + + <para>The Tree view 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 View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_17.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>You can 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> + + <para>Let&apos;s consider the tree on the left more closely.</para> + + <itemizedlist> + <listitem><para>Under the <emphasis> + <property>data-sources</property></emphasis> node you can create a Data Source object that will be configured + and made available as a servlet context attribute.</para></listitem> + + <listitem><para>The <emphasis> + <property>form-beans</property></emphasis> node is meant for creating a set of form bean descriptors for this module. + Every created element under this node is a JavaBean that implements the org.apache.struts.action.ActionForm class. + Use the Properties editor on the right to adjust properties specific to every created form-bean.</para></listitem> + + <listitem><para>The <emphasis> + <property>global-exceptions</property></emphasis> node is intended for registering the handlers for the exceptions + that might be thrown by an Action object.</para></listitem> + + <listitem><para>Use the <emphasis> + <property>global-forwards</property></emphasis> node to add, edit or delete a global forwards that represent + ActionForward objects available to all Action objects as a return value.</para></listitem> + + <listitem><para>The <emphasis> + <property>controller</property></emphasis> node allows you to configure the controller properties.</para></listitem> + + <listitem><para>Under the <emphasis> + <property>resources</property></emphasis> node you can add, delete, or edit message resources.</para></listitem> + + <listitem><para>Under the <emphasis> + <property>plug-ins</property></emphasis> node you can define a Struts plug-in. Right-click the node, select <emphasis> + <property>Create Plug-in</property></emphasis> + and specify the plug-ib <emphasis> + <property>Id</property></emphasis> and <emphasis> + <property>ClassName</property></emphasis> by pointing to the Java class which implements the org.apache.struts.action.PlugIn interface. </para></listitem> + + </itemizedlist> + </section> + <section id="StrutsSourceMode9655"> + + <title>Source View</title> + + <para>In the Source view, you have complete editing control of the underlying XML + coding.</para> + + <figure> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_19.png"/> + </imageobject> + </mediaobject> + </figure> + + <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> + <para>You can take advantage of code assist.</para> + <figure> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_20.png" scale="85"/> + </imageobject> + </mediaobject> + </figure> + + <para>The editor will also immediately flag any errors.</para> + + <figure> + <title>Errors in Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_21.png" scale="85"/> + </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> + + <para>Find more information about editor features in the editor features chapter.</para> + </section> + </section> + + <section id="GraphicalEditorForTilesFiles132"> + + <title>Graphical Editor for Tiles Files</title> + <para>Here, you&apos;ll know how to make use of the special graphical editor for Tiles configuration files.</para> + <para>The editor has three main views: Tree, Diagram and Source. + The views can be selected via the tabs at the bottom of the editor. Any changes made in + one view are immediately visible when you switch to any other view.</para> + + <para>Before we consider each view of the editor, let&apos;s look at the way of creating new Tiles files.</para> + <section id="CreateNewTilesFile1422"> + + <title>Create New Tiles File</title> + + <para>To create new Tiles files, right click any folder and select <emphasis> + <property>New &gt; 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>Tree View</title> + + <para>The Tree view 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 View</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 View</title> + + <para>The Diagram view 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 view of the <property>Tiles editor</property> is the Source view that + gives you full control over the source. Any changes here will immediately appear in + other modes when you switch to them.</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> + + <figure> + <title>Source View</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" 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&apos;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> + </section> + + <section id="GraphicalEditorForStrutsValidationFiles86"> + + <title>Graphical Editor for Struts Validation Files</title> + + <para>Providing full support for development Struts applications JBoss Tools comes with a + visual validation editor. To open the editor double-click on the validation file or if you don&apos;t have it create a new one.</para> + + <para>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 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 view 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 View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_34.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The Constants view let you set constant values for your validation rules.</para> + <figure> + <title>Constansts View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_35.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The validation file can also be viewed in a Tree view.</para> + <figure> + <title>Tree View</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 view. + Any editing in this view will immediately be available in other views of the editor.</para> + <figure> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_37.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 view shows the validation rules for a selected validator. You can of + course add your own rules.</para> + <figure> + <title>Validators View</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> +</chapter> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/favicon.ico =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/favicon.ico ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/jbosstools_logo.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/jbosstools_logo.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/Thumbs.db =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/Thumbs.db ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_10.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_10.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_11.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_11.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_12.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_12.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_13.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_13.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_14.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_14.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_15.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_15.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_16.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_16.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_17.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_17.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_18.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_18.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_19.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_19.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_2.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_20.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_20.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_21.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_21.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_22.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_22.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_23.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_23.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_24.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_24.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_25.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_25.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_26.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_26.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_27.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_27.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_28.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_28.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_29.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_29.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_30.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_30.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_31.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_31.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_32.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_32.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_33.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_33.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_34.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_34.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_35.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_35.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_36.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_36.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_37.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_37.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_38.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_38.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_39.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_39.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3_1.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_3_1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_4.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_4.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_40.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_40.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_41.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_41.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_42.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_42.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_43.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_43.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_44.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_44.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_45.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_45.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_46.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_46.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_47.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_47.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_48.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_48.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_49.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_49.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_5.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_5.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_50.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_50.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_51.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_51.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_6.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_6.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_7.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_7.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_8.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_8.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_9.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/struts/struts_9.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_10.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_10.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_11.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_11.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_12.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_12.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_13.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_13.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_14.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_14.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_8.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_8.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_9.png =================================================================== (Binary files differ) Property changes on: trunk/struts/docs/struts_tools_ref_guide/en-US/images/verif_valid/verif_valid_9.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/struts/docs/struts_tools_ref_guide/en-US/introduction.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/introduction.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/introduction.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="intoduction"> + <?dbhtml filename="introduction.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Introduction</title> + + <para>If you prefer to develop web applications using Struts technology JBoss Tools also meet + your needs. The professional developer toolset provides all necessary editors and wizards + for creating Struts resources that enhances the process of building high-quality web + applications.</para> + <note> + <title>Note:</title> + <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para> + </note> + + <para>In this guide you will learn how to take advantage of Struts support that <property>JBoss Tools</property> + provide.</para> + + <section id="struts_key_features"> + <title>Key Features of Struts Tools</title> + + <para>For a start, we propose you to look through the table of main features of Struts + Tools:</para> + + <table> + + <title>Key Functionality for Struts Tools</title> + <tgroup cols="3"> + + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <colspec colnum="3" align="left" colwidth="2*"/> + + <thead> + <row> + <entry>Feature</entry> + <entry>Benefit</entry> + <entry>Chapter</entry> + </row> + </thead> + <tbody> + <row> + <entry><para>Struts Support</para></entry> + <entry><para>Step-by-step wizards for creating a new struts project with a number + of predefined templates, importing existing ones and adding struts + capabilities to non-struts web projects.</para></entry> + <entry> + <link linkend="projects">struts support</link> + </entry> + </row> + + <row> + <entry><para>Support for Struts Configuration File</para></entry> + <entry><para>Working on file using three modes: diagram, tree and source. + Synchronization between the modes and full control over the code. Easy + moving around the diagram using the Diagram Navigator. Working with + struts projects that have multiple modules. Possibility to use Struts + configuration file debugger allowing to set break points on struts + diagram and then launch the server in debug mode.</para></entry> + <entry> + <link linkend="struts_config_editor">graphical editor for struts</link> + <link linkend="config_file_debugger">configuration file debugger</link> + </entry> + </row> + + <row> + <entry><para>Support for Struts modules</para></entry> + <entry><para>A Struts module (struts-config.xml) is automatically created while + creating a new project. There is also possibility to add new ones or edit + already existing modules in your existing project or while importing Struts project.</para></entry> + <entry> + <link linkend="modules">modules</link> + </entry> + </row> + + <row> + <entry><para>Verification and Validation</para></entry> + <entry><para>All occurring errors will be immediately reported by verification + feature, no matter in what view you are working. Constant validation and + errors checking allows to catch many of the errors during development + process that significantly reduces development time.</para></entry> + <entry> + <link linkend="project_verification">verification and validation</link> + </entry> + + </row> + </tbody> + </tgroup> + </table> + + </section> + + <section> + <title>Other relevant resources on the topic</title> + + <para>All JBoss Developer Studio/JBoss Tools documentation you can find on<ulink url="http://docs.jboss.org/tools/">JBoss Tools project page </ulink>.</para> + <para>The latest documentation builds are available on<ulink url="http://download.jboss.org/jbosstools/nightly-docs/">nig... docs page</ulink>.</para> + + </section> + +</chapter> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/master.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/master.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/master.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" + +[ +<!ENTITY introduction SYSTEM "introduction.xml"> +<!ENTITY projects SYSTEM "projects.xml"> +<!ENTITY editors SYSTEM "editors.xml"> +<!ENTITY modules SYSTEM "modules.xml"> +<!ENTITY code_generation SYSTEM "code_generation.xml"> +<!ENTITY config_file_debugger SYSTEM "config_file_debugger.xml"> +<!ENTITY page_links_recognizer SYSTEM "page_links_recognizer.xml"> +<!ENTITY project_verification SYSTEM "project_verification.xml"> +<!ENTITY rel_resources_links SYSTEM "rel_resources_links.xml"> + +<!ENTITY seamlink "../../seam/html_single/index.html"> +<!ENTITY aslink "../../as/html_single/index.html"> +<!ENTITY esblink "../../esb_ref_guide/html_single/index.html"> +<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html"> +<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html"> +<!ENTITY jbpmlink "../../jbpm/html_single/index.html"> +<!ENTITY jsflink "../../jsf/html_single/index.html"> +<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html"> +<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html"> +<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html"> +<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html"> +<!ENTITY migrationlink "../../Exadel-migration/html_single/index.html"> + +]> +<book> + <bookinfo> + <title>Struts Tools Reference Guide</title> + + <corpauthor> + <inlinemediaobject> + <imageobject role="fo"> + <imagedata format="PNG" fileref="images/jbosstools_logo.png" /> + </imageobject> + <imageobject role="html"> + <imagedata/> + </imageobject> + </inlinemediaobject> + </corpauthor> + <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author> + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + <author&gt;&lt;firstname&gt;Svetlana&lt;/firstname&gt;&lt;surname&gt;Mukhina&lt;/surname&gt;&lt;email&gt;smukhina(a)exadel.com&lt;/email&gt;&lt;/author&gt; + + <copyright> + <year>2007</year> + <year>2008</year> + <year>2009</year> + <year>2010</year> + <holder>JBoss by Red Hat</holder> + </copyright> + <releaseinfo> + Version: 3.1.0.GA + </releaseinfo> + +<abstract> + <title/> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_too... version</ulink> + </para> +</abstract> + + + </bookinfo> + + <toc/> + + &introduction; + &projects; + &editors; + &modules; + &code_generation; + &config_file_debugger; + &page_links_recognizer; + &project_verification; + &rel_resources_links; +</book> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/master_output.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/master_output.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/master_output.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,1331 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" + +[ +<!ENTITY introduction SYSTEM "modules/introduction.xml"> +<!ENTITY projects SYSTEM "modules/projects.xml"> +<!ENTITY editors SYSTEM "modules/editors.xml"> +<!ENTITY modules SYSTEM "modules/modules.xml"> +<!ENTITY code_generation SYSTEM "modules/code_generation.xml"> +<!ENTITY config_file_debugger SYSTEM "modules/config_file_debugger.xml"> +<!ENTITY page_links_recognizer SYSTEM "modules/page_links_recognizer.xml"> +<!ENTITY project_verification SYSTEM "modules/project_verification.xml"> +<!ENTITY rel_resources_links SYSTEM "modules/rel_resources_links.xml"> + +<!ENTITY seamlink "../../seam/html_single/index.html"> +<!ENTITY aslink "../../as/html_single/index.html"> +<!ENTITY esblink "../../esb_ref_guide/html_single/index.html"> +<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html"> +<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html"> +<!ENTITY jbpmlink "../../jbpm/html_single/index.html"> +<!ENTITY jsflink "../../jsf/html_single/index.html"> +<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html"> +<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html"> +<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html"> +<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html"> +<!ENTITY migrationlink "../../Exadel-migration/html_single/index.html"> + +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + <bookinfo> + <title>Struts Tools Reference Guide</title> + + <corpauthor> + <inlinemediaobject> + <imageobject role="fo"> + <imagedata fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + </imageobject> + <imageobject role="html"> + <imagedata></imagedata> + </imageobject> + </inlinemediaobject> + </corpauthor> + <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author> + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + <author&gt;&lt;firstname&gt;Svetlana&lt;/firstname&gt;&lt;surname&gt;Mukhina&lt;/surname&gt;&lt;email&gt;smukhina(a)exadel.com&lt;/email&gt;&lt;/author&gt; + + <copyright> + <year>2007</year> + <year><diffmk:wrapper diffmk:change="added">2008</diffmk:wrapper></year> + <year diffmk:change="added">2009</year> + <year diffmk:change="added"><diffmk:wrapper diffmk:change="added">2010</diffmk:wrapper></year> + <holder>JBoss by Red Hat</holder> + </copyright> + <releaseinfo><diffmk:wrapper diffmk:change="changed"> + Version: 3.1.0.CR2 + </diffmk:wrapper></releaseinfo> + +<abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/struts_too... version</ulink> + </para> +</abstract> + + + </bookinfo> + + <toc></toc> + + +<chapter id="intoduction" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/introduction.xml"> + <?dbhtml filename="introduction.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Introduction</title> + + <para>If you prefer to develop web applications using Struts technology JBoss Tools also meet + your needs. The professional developer toolset provides all necessary editors and wizards + for creating Struts resources that enhances the process of building high-quality web + applications.</para> + <note> + <title>Note:</title> + <para>Note that JBoss Tools support the Struts 1.1, 1.2.x versions.</para> + </note> + + <para>In this guide you will learn how to take advantage of Struts support that <property moreinfo="none">JBoss Tools</property> + provide.</para> + + <section id="struts_key_features"> + <title>Key Features of Struts Tools</title> + + <para>For a start, we propose you to look through the table of main features of Struts + Tools:</para> + + <table> + + <title>Key Functionality for Struts Tools</title> + <tgroup cols="3"> + + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <colspec align="left" colnum="3" colwidth="2*"></colspec> + + <thead> + <row> + <entry>Feature</entry> + <entry>Benefit</entry> + <entry>Chapter</entry> + </row> + </thead> + <tbody> + <row> + <entry><para>Struts Support</para></entry> + <entry><para>Step-by-step wizards for creating a new struts project with a number + of predefined templates, importing existing ones and adding struts + capabilities to non-struts web projects.</para></entry> + <entry> + <link linkend="projects">struts support</link> + </entry> + </row> + + <row> + <entry><para>Support for Struts Configuration File</para></entry> + <entry><para>Working on file using three modes: diagram, tree and source. + Synchronization between the modes and full control over the code. Easy + moving around the diagram using the Diagram Navigator. Working with + struts projects that have multiple modules. Possibility to use Struts + configuration file debugger allowing to set break points on struts + diagram and then launch the server in debug mode.</para></entry> + <entry> + <link linkend="struts_config_editor">graphical editor for struts</link> + <link linkend="config_file_debugger">configuration file debugger</link> + </entry> + </row> + + <row> + <entry><para>Support for Struts modules</para></entry> + <entry><para>A Struts module (struts-config.xml) is automatically created while + creating a new project. There is also possibility to add new ones or edit + already existing modules in your existing project or while importing Struts project.</para></entry> + <entry> + <link linkend="modules">modules</link> + </entry> + </row> + + <row> + <entry><para>Verification and Validation</para></entry> + <entry><para>All occurring errors will be immediately reported by verification + feature, no matter in what view you are working. Constant validation and + errors checking allows to catch many of the errors during development + process that significantly reduces development time.</para></entry> + <entry> + <link linkend="project_verification">verification and validation</link> + </entry> + + </row> + </tbody> + </tgroup> + </table> + + </section> + + <section> + <title>Other relevant resources on the topic</title> + + <para>All JBoss Developer Studio/JBoss Tools documentation you can find on<ulink url="http://docs.jboss.org/tools/">JBoss Tools project page </ulink>.</para> + <para>The latest documentation builds are available on<ulink url="http://download.jboss.org/jbosstools/nightly-docs/">nig... docs page</ulink>.</para> + + </section> + +</chapter> + + +<chapter id="projects" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/projects.xml"> + <?dbhtml filename="projects.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Projects</title> + + <para>JBoss Tools provide the following functionality when working with Struts:</para> + + <itemizedlist> + <listitem> + <para>Create new <property moreinfo="none">Struts projects</property></para> + </listitem> + <listitem> + <para>Import (open) existing Struts projects. You can import any project + structure</para> + </listitem> + <listitem> + <para>Add <property moreinfo="none">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>Now, we'll focus on all these points more fully.</para> + + <section id="CreatingANewStrutsProjec745t"> + + <title>Creating a New Struts Project</title> + + + <para>JBoss Tools provides 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 moreinfo="none">File &gt; New &gt; Project...</property> + </emphasis> from the menu bar. Then, select <emphasis> + <property moreinfo="none">JBoss Tools Web &gt; Struts &gt; Struts Project</property> + </emphasis> in this dialog box. Click <emphasis> + <property moreinfo="none">Next</property>: </emphasis></para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>Selecting Struts Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>On this form, provide the <property moreinfo="none">Project Name</property>. You can also + select where to create the project or use the default path.</para> + <para>Next to <property moreinfo="none">Struts Environment</property> set which Struts version to + use.</para> + </listitem> + </itemizedlist> + + <figure float="0"> + <title>Creating Struts Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_3.png"></imagedata> + </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 float="0"> + <title>Choosing Struts Template </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_3_1.png"></imagedata> + </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"> + <property moreinfo="none">"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 float="0"> + <title>Registering The Project at Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_4.png"></imagedata> + </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 float="0"> + <title>Selecting Tag Libraries</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>After the project is created, you should have the following project structure (if you + used the KickStart template):</para> + + <figure float="0"> + <title>Project Structure</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_6.png"></imagedata> + </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"> + + <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/html_single/index.html">Migration Guide</ulink>.</para> + + </section> + <section id="AddingStrutsCapabilityToAnExistingWebApplication532"> + + <title>Adding Struts Capability to an Existing Web Application</title> + + <para>Here, we'll consider how to add Struts functionality (Struts libraries, tag + libraries and a Struts configuration file) to any existing Web application project in + your Eclipse workspace.</para> + + <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools + editors, such as the <link linkend="struts_config_editor">Struts configuration + editor</link> and the JBoss Tools JSP editor. To take advantage of this just right-click + the project and select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Add Struts Capabilities</property> + </emphasis> from the context menu. This will start the process of adding all necessary + libraries and files to make a Web Struts project from your one.</para> + + <figure float="0"> + <title>Adding Struts Capabilities</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_7.png"></imagedata> + </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> + + <figure float="0"> + <title>Choosing Project Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>After hitting <emphasis> + <property moreinfo="none">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 moreinfo="none">Add Struts Support</property> + </emphasis> button.</para> + <figure float="0"> + <title>Project Modules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here you can select what Struts <property moreinfo="none">Version</property>, <property moreinfo="none">Servlet + Class</property>, <property moreinfo="none">URL Pattern</property> and <property moreinfo="none">TLD</property>s to add + to this project.</para> + + <figure float="0"> + <title>Selecting Struts Support Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>When done, you will see the default Struts module configuration information. See how + to Edit <link linkend="modules">Struts modules</link>.</para> + + <figure float="0"> + <title>Project Configuration Information</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_11.png"></imagedata> + </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 moreinfo="none">Add Libraries</property>.</emphasis></para> + + <figure float="0"> + <title>Registering the Project at Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>When done, you can open end edit the struts-config.xml file using useful Struts + configuration file editor provided by JBDS. (The Struts configuration is shown below in + the Tree viewer).</para> + + <figure float="0"> + <title>Struts-config.xml File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_13.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section> + <title>Relevant Resources Links</title> + + <para>You can find more in-depth explanation on how to work with special wizards, editors and views that can + be used in various scenarios while developing Struts applications in our <ulink url="../../jsf/html_single/index.html">Visual Web Tools guide</ulink>.</para> + </section> +</chapter> + + +<chapter id="editors" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/editors.xml"> + <?dbhtml filename="editors.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Editors</title> + <para>In this chapter we'll introduce you to featured graphical editors for specific + Struts files such as Struts Configuration files, Tiles files, Struts Validation files and web.xml.</para> + + <section id="webxml_editor"> + <title>Web.xml Editor</title> + + <para>The <emphasis> + <property moreinfo="none">web.xml</property></emphasis> file inside the <emphasis> + <property moreinfo="none">WEB-INF</property></emphasis> folder is a deployment descriptor file for a Web Application. It + describes the servlets and other components and deployment properties that make up your application.</para> + + <para><property moreinfo="none">JBoss Tools</property> add the <emphasis> + <property moreinfo="none">web.xml</property></emphasis> file to created Struts project automatically and provides a special editor for its editing. + See the Visual Web Tools guide that gives a descriptive information on the <ulink url="../../jsf/html_single/index.html#GraphicalWebApplicationFileEditor">web.xml editor</ulink>.</para> + </section> + + <section id="struts_config_editor"> + + <title>Graphical Editor for Struts Configuration Files</title> + <para>First, let's dwell on the Struts Configuration file editor.</para> + <para>This editor has three views with different representation of <emphasis> + <property moreinfo="none">struts-config.xml</property>: </emphasis>Diagram, Tree and Source. The + views can be selected via the tabs at the bottom of the editor. Any changes made in one + view are immediately visible when you switch to any other view.</para> + + <para>Now, we'll consider every view in more detail.</para> + <section id="StrutsDiagramMode453"> + + <title>Diagram View</title> + + <para>The Diagram view graphically displays the Web flow of the application defined in + the Struts configuration file.</para> + + <figure float="0"> + <title>Diagram View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The Diagram view 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> + + <figure float="0"> + <title>Diagram Context Menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_15.png"></imagedata> + </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. </para> + + <figure float="0"> + <title>Editor Icons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_16.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <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> + + <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 moreinfo="none">Add &gt; 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> + + + </section> + <section id="StrutsTreeMode42"> + + <title>Tree View</title> + + <para>The Tree view 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 float="0"> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can 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 float="0"> + <title>Tree Context Menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Let's consider the tree on the left more closely.</para> + + <itemizedlist> + <listitem><para>Under the <emphasis> + <property moreinfo="none">data-sources</property></emphasis> node you can create a Data Source object that will be configured + and made available as a servlet context attribute.</para></listitem> + + <listitem><para>The <emphasis> + <property moreinfo="none">form-beans</property></emphasis> node is meant for creating a set of form bean descriptors for this module. + Every created element under this node is a JavaBean that implements the org.apache.struts.action.ActionForm class. + Use the Properties editor on the right to adjust properties specific to every created form-bean.</para></listitem> + + <listitem><para>The <emphasis> + <property moreinfo="none">global-exceptions</property></emphasis> node is intended for registering the handlers for the exceptions + that might be thrown by an Action object.</para></listitem> + + <listitem><para>Use the <emphasis> + <property moreinfo="none">global-forwards</property></emphasis> node to add, edit or delete a global forwards that represent + ActionForward objects available to all Action objects as a return value.</para></listitem> + + <listitem><para>The <emphasis> + <property moreinfo="none">controller</property></emphasis> node allows you to configure the controller properties.</para></listitem> + + <listitem><para>Under the <emphasis> + <property moreinfo="none">resources</property></emphasis> node you can add, delete, or edit message resources.</para></listitem> + + <listitem><para>Under the <emphasis> + <property moreinfo="none">plug-ins</property></emphasis> node you can define a Struts plug-in. Right-click the node, select <emphasis> + <property moreinfo="none">Create Plug-in</property></emphasis> + and specify the plug-ib <emphasis> + <property moreinfo="none">Id</property></emphasis> and <emphasis> + <property moreinfo="none">ClassName</property></emphasis> by pointing to the Java class which implements the org.apache.struts.action.PlugIn interface. </para></listitem> + + </itemizedlist> + </section> + <section id="StrutsSourceMode9655"> + + <title>Source View</title> + + <para>In the Source view, you have complete editing control of the underlying XML + coding.</para> + + <figure float="0"> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <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> + <para>You can take advantage of <ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">code assist</ulink>.</para> + <figure float="0"> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_20.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The editor will also immediately flag any errors.</para> + + <figure float="0"> + <title>Errors in Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_21.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Finally, you can use the Outline view with the editor to easily navigate through + the file.</para> + + <figure float="0"> + <title>Outline View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Find more information about editor features <ulink url="../../jsf/html_single/index.html#editors_features">in the editor features chapter</ulink>.</para> + </section> + </section> + + <section id="GraphicalEditorForTilesFiles132"> + + <title>Graphical Editor for Tiles Files</title> + <para>Here, you'll know how to make use of the special graphical editor for Tiles configuration files.</para> + <para>The editor has three main views: Tree, Diagram and Source. + The views can be selected via the tabs at the bottom of the editor. Any changes made in + one view are immediately visible when you switch to any other view.</para> + + <para>Before we consider each view of the editor, let's look at the way of creating new Tiles files.</para> + <section id="CreateNewTilesFile1422"> + + <title>Create New Tiles File</title> + + <para>To create new Tiles files, right click any folder and select <emphasis> + <property moreinfo="none">New &gt; Tiles File</property>. </emphasis></para> + <figure float="0"> + <title>Creating a New Tiles File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_23.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="StrutsTreeView896"> + + <title>Tree View</title> + + <para>The Tree view 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 float="0"> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_24.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To edit the file, simply right click any node and select among the available + actions.</para> + <figure float="0"> + <title>Editing in Tiles Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_25.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="StrutsDiagramView4643"> + + <title>Diagram View</title> + + <para>The Diagram view allows you to create complex Tiles files in the form of a + diagram.</para> + <figure float="0"> + <title>Diagram Mode</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_26.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To create new definitions, simply right click anywhere in the diagram.</para> + <figure float="0"> + <title>Creating New Definition</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_27.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also use the Diagram toolbar to make editing easier.</para> + <figure float="0"> + <title>Diagram Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_28.png"></imagedata> + </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 view of the <property moreinfo="none">Tiles editor</property> is the Source view that + gives you full control over the source. Any changes here will immediately appear in + other modes when you switch to them.</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> + + <figure float="0"> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_29.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><ulink url="../../jsf/html_single/index.html#CodeAssistAndDynamicCodeAssist42BasedOnProjectData">Code + assist</ulink> is available in the Source mode.</para> + <figure float="0"> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_30.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Any errors are immediately reported as shown below:</para> + <figure float="0"> + <title>Errors Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_31.png" scale="75"></imagedata> + </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 float="0"> + <title>Outline View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_32.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + <section id="GraphicalEditorForStrutsValidationFiles86"> + + <title>Graphical Editor for Struts Validation Files</title> + + <para>Providing full support for development Struts applications JBoss Tools comes with a + visual validation editor. To open the editor double-click on the validation file or if you don't have it create a new one.</para> + + <para>To create a new validation file, right click any folder in + Project Explorer and select <emphasis> + <property moreinfo="none">File &gt; New &gt; Other...</property> + </emphasis>from the context menu and then <emphasis> + <property moreinfo="none">JBoss Tools Web &gt; Struts &gt; Validation File</property>. </emphasis></para> + <figure float="0"> + <title>Creating New Validation File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_33.png"></imagedata> + </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 view shows forms and their elements on the left side and the dialogue for + defining their validation rules on the right side.</para> + <figure float="0"> + <title>Formsets View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_34.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The Constants view let you set constant values for your validation rules.</para> + <figure float="0"> + <title>Constansts View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_35.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The validation file can also be viewed in a Tree view.</para> + <figure float="0"> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_36.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>At any point you have full control over the source by switching to the Source view. + Any editing in this view will immediately be available in other views of the editor.</para> + <figure float="0"> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_37.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also open your own custom or Struts-standard <emphasis> + <property moreinfo="none">validation-rules.xml</property> + </emphasis> file.</para> + <para>The Validators view shows the validation rules for a selected validator. You can of + course add your own rules.</para> + <figure float="0"> + <title>Validators View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_38.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Here are the validation rules shown in the Source mode.</para> + <figure float="0"> + <title>Validation Rules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_39.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> +</chapter> + + +<chapter id="modules" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/modules.xml"> + <?dbhtml filename="modules.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Modules</title> + + <para>JBoss Tools support 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>Now, let's discuss this functionality in more detail.</para> + <section id="WhenImportingAStrutsProject432"> + + <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 float="0"> + <title>Configuring Project Modules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_40.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="EditingModulesInAnExistingProject1"> + + <title>Editing Modules in an Existing Project</title> + <para>To edit modules in an existing project, right click the project and + select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Modules Configuration</property>. + </emphasis></para> + <figure float="0"> + <title>Choosing Modules Configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_41.png"></imagedata> + </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 float="0"> + <title>Modules Configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_42.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="AddingNewModules1"> + + <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 moreinfo="none">New &gt; Struts Config</property>. </emphasis></para> + <figure float="0"> + <title>Adding New Modules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_43.png"></imagedata> + </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 float="0"> + <title>Adding New Modules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_44.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> +</chapter> + + +<chapter id="code_generation" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/code_generation.xml"> + <?dbhtml filename="code_generation.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Code Generation</title> + + <para>JBoss Tools comes with a <property moreinfo="none">code generation</property> + feature. You can generate stub code for Struts Actions, FormBeans, Forwards + and Exceptions.</para> + + <para>The code generation that JBoss tooling provides is based on Velocity templates + which can be modified for your use. The templates are located at <emphasis> + <property moreinfo="none"> {JBossStudioHome} &gt; templates &gt; + 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 moreinfo="none">Generate Java Code....</property> + </emphasis></para> + + <figure float="0"> + <title>Selecting Generate Java Code</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_45.png"></imagedata> + </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 float="0"> + <title>Generate - Step 1</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_46.png"></imagedata> + </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 float="0"> + <title>Generation Finished</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_47.png"></imagedata> + </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 moreinfo="none">Generate Java Code...</property> + </emphasis> from the context menu.</para> + + <figure float="0"> + <title>Generation For Individual Struts Artifact</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_48.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The same can be done from within the Tree viewer for the editor of the Struts + configuration file.</para> + + <figure float="0"> + <title>Generation in Struts Config Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_49.png"></imagedata> + </imageobject> + </mediaobject> + </figure> +</chapter> + +<chapter id="config_file_debugger" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/config_file_debugger.xml"> + <?dbhtml filename="config_file_debugger.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 Configuration File Debugger</title> + + <para>JBoss Tools come with <property moreinfo="none">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 moreinfo="none">Breakpoint</property>. </emphasis></para> + <figure float="0"> + <title>Adding Breakpoint</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_50.png"></imagedata> + </imageobject> + </mediaobject> + </figure> +</chapter> + +<chapter id="page_links_recognizer" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/page_links_recognizer.xml"> + <?dbhtml filename="page_links_recognizer.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Customizable Page Links Recognizer</title> + + <para><property moreinfo="none">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 moreinfo="none">Window &gt; Preferences</property> + </emphasis> from the menu bar and then selecting <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Struts &gt; Customization</property> + </emphasis> from the Preferences dialog box.</para> + <figure float="0"> + <title>Customization Panel</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/struts/struts_51.png"></imagedata> + </imageobject> + </mediaobject> + </figure> +</chapter> + +<chapter id="project_verification" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/project_verification.xml"> + <?dbhtml filename="project_verification.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 Project Verification</title> + + <para>In this section we'll consider one more functionality that JBoss Tools provide for Struts + projects, namely adjusting projects verification.</para> + + <para>To configure Struts project verification select <emphasis> + <property moreinfo="none">Window &gt; Preferences</property> + </emphasis> from the menu bar, select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Verification</property> + </emphasis> from the Preferences dialog box and then expand the + Struts Rules node.</para> + <figure float="0"> + <title>Struts Rules</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Suppose you are working in the Source viewer for a Struts + configuration file as shown below:</para> + <figure float="0"> + <title>Struts Configuration File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>While typing a class name or entering it from the graphical editor, + you might make a minor typo (like <emphasis role="italic"> + <property moreinfo="none">"sample.GreetingAction1"</property> + </emphasis> instead of <emphasis role="italic"> + <property moreinfo="none">"sample.GreetingAction"</property> + </emphasis>). After saving the file, + <property moreinfo="none">verification</property> checks to make sure everything is + correct and finds the error below:</para> + <figure float="0"> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_10.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Notice that the Package Explorer View shows a marked folder and a + marked file where the error is.</para> + <para>You can place the cursor over the line with the error to view a + detailed error message:</para> + <figure float="0"> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The verification also checks to make sure you have specified the + correct JSP page for the forward:</para> + <figure float="0"> + <title>JSP Page Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_12.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Once you place the cursor over the line, you can see the error + message:</para> + <figure float="0"> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>You can always invoke the verification by switching to the Diagram + viewer, right-clicking and selecting <emphasis> + <property moreinfo="none">Verify</property> + </emphasis> from the context menu:</para> + <figure float="0"> + <title>Verify Command</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/verif_valid/verif_valid_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> +</chapter> + +<chapter id="rel_resources_links" xml:base="file:///home/vchukhutsina/repos/ochik_jboss/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml"> + <?dbhtml filename="rel_resources_links.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <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> + + <para>In summary, this reference should help you to get familiar with those parts of + <property moreinfo="none">JBoss Tools</property> which are meant for development with Struts + technology. If you've carefully gone through the document, you should know + now how to create/import Struts project or enable Struts capabilities for an + existing web project as well as organize and edit all necessary staff for your + Struts application using a set of views and editors provided by <property moreinfo="none">JBoss + Tools</property>.</para> + + <para>If you&apos;d like to contribute your feedback is always appreciated. You can + leave your questions and suggestions on our <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... + >Forum</ulink>.</para> + <para>We hope, this guide helped you to get started with the JBoss Struts Tools. Besides, for additional information you are welcome on <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forum</ulink>.</para> +</chapter> + +</book> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/modules.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/modules.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/modules.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,99 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="modules"> + <?dbhtml filename="modules.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Modules</title> + + <para>JBoss Tools support 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>Now, let&apos;s discuss this functionality in more detail.</para> + <section id="WhenImportingAStrutsProject432"> + + <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"> + + <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"> + + <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> +</chapter> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/page_links_recognizer.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="page_links_recognizer"> + <?dbhtml filename="page_links_recognizer.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <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> +</chapter> \ No newline at end of file Added: trunk/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/project_verification.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,117 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="project_verification"> + <?dbhtml filename="project_verification.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 Project Verification</title> + + <para>In this section we&apos;ll consider one more functionality that JBoss Tools provide for Struts + projects, namely adjusting projects verification.</para> + + <para>To configure Struts project verification select <emphasis> + <property>Window > Preferences</property> + </emphasis> from the menu bar, select <emphasis> + <property>JBoss Tools > Web > Verification</property> + </emphasis> from the Preferences dialog box and then expand the + Struts Rules node.</para> + <figure> + <title>Struts Rules</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_8.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>Suppose you are working in the Source viewer for a Struts + configuration file as shown below:</para> + <figure> + <title>Struts Configuration File</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_9.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>While typing a class name or entering it from the graphical editor, + you might make a minor typo (like <emphasis role="italic"> + <property>&quot;sample.GreetingAction1&quot;</property> + </emphasis> instead of <emphasis role="italic"> + <property>&quot;sample.GreetingAction&quot;</property> + </emphasis>). After saving the file, + <property>verification</property> checks to make sure everything is + correct and finds the error below:</para> + <figure> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_10.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Notice that the Package Explorer View shows a marked folder and a + marked file where the error is.</para> + <para>You can place the cursor over the line with the error to view a + detailed error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_11.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>The verification also checks to make sure you have specified the + correct JSP page for the forward:</para> + <figure> + <title>JSP Page Verification</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_12.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Once you place the cursor over the line, you can see the error + message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_13.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>You can always invoke the verification by switching to the Diagram + viewer, right-clicking and selecting <emphasis> + <property>Verify</property> + </emphasis> from the context menu:</para> + <figure> + <title>Verify Command</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_14.png" + /> + </imageobject> + </mediaobject> + </figure> +</chapter> \ No newline at end of file Added: trunk/struts/docs/struts_tools_ref_guide/en-US/projects.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/projects.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/projects.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,275 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="projects"> + <?dbhtml filename="projects.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Projects</title> + + <para>JBoss Tools provide 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> + <para>Now, we&apos;ll focus on all these points more fully.</para> + + <section id="CreatingANewStrutsProjec745t"> + + <title>Creating a New Struts Project</title> + + + <para>JBoss Tools provides 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&apos;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"> + <property>&quot;Target Server&quot;</property> + </emphasis> check box if for some reason you don&apos;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> + + <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"> + + <title>Importing an Existing Struts Project with Any Structure</title> + + <para>For detailed information on migration projects to JBoss Developer Studio see the Migration Guide.</para> + + </section> + <section id="AddingStrutsCapabilityToAnExistingWebApplication532"> + + <title>Adding Struts Capability to an Existing Web Application</title> + + <para>Here, we&apos;ll consider how to add Struts functionality (Struts libraries, tag + libraries and a Struts configuration file) to any existing Web application project in + your Eclipse workspace.</para> + + <para>By adding a Struts Nature to your project, you can now edit files using JBoss Tools + editors, such as the <link linkend="struts_config_editor">Struts configuration + editor</link> and the JBoss Tools JSP editor. To take advantage of this just 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 a Web Struts project from your one.</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 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> + + <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> + + <para>When done, you will see the default Struts module configuration information. See how + to Edit <link linkend="modules">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. 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> + + <para>When done, you can open end edit the struts-config.xml file using useful 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" scale="75"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section> + <title>Relevant Resources Links</title> + + <para>You can find more in-depth explanation on how to work with special wizards, editors and views that can + be used in various scenarios while developing Struts applications in our Visual Web Tools Guide.</para> + </section> +</chapter> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/rel_resources_links.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="rel_resources_links"> + <?dbhtml filename="rel_resources_links.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Struts Tools</keyword> + <keyword>Java</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>Relevant Resources Links</title> + + <para>Find out necessary information on <ulink url="http://struts.apache.org/">Struts + technology</ulink> if you don&apos;t know enough.</para> + + <para>In summary, this reference should help you to get familiar with those parts of + <property>JBoss Tools</property> which are meant for development with Struts + technology. If you&apos;ve carefully gone through the document, you should know + now how to create/import Struts project or enable Struts capabilities for an + existing web project as well as organize and edit all necessary staff for your + Struts application using a set of views and editors provided by <property>JBoss + Tools</property>.</para> + + <para>If you&apos;d like to contribute your feedback is always appreciated. You can + leave your questions and suggestions on our <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... + >Forum</ulink>.</para> + <para>We hope, this guide helped you to get started with the JBoss Struts Tools. Besides, for additional information you are welcome on <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... forum</ulink>.</para> +</chapter> Added: trunk/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/en-US/struts_project_verification.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,115 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="struts_project_verification"> + <?dbhtml filename="struts_project_verification.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 Project Verification</title> + + <para>JBoss Developer Studio provides the same functionality for Struts + projects. To configure Struts project verification select <emphasis> + <property>Window > Preferences</property> + </emphasis> from the menu bar, select <emphasis> + <property>JBoss Tools > Web > Verification</property> + </emphasis> from the Preferences dialog box and then expand the + Struts Rules node.</para> + <figure> + <title>Struts Rules</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_8.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>Suppose you are working in the Source viewer for a Struts + configuration file as shown below:</para> + <figure> + <title>Struts Configuration File</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_9.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>While typing a class name or entering it from the graphical editor, + you might make a minor typo (like <emphasis role="italic"> + <property>&quot;sample.GreetingAction1&quot;</property> + </emphasis> instead of <emphasis role="italic"> + <property>&quot;sample.GreetingAction&quot;</property> + </emphasis>). After saving the file, + <property>verification</property> checks to make sure everything is + correct and finds the error below:</para> + <figure> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_10.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Notice that the Package Explorer View shows a marked folder and a + marked file where the error is.</para> + <para>You can place the cursor over the line with the error to view a + detailed error message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_11.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>The verification also checks to make sure you have specified the + correct JSP page for the forward:</para> + <figure> + <title>JSP Page Verification</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_12.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + <para>Once you place the cursor over the line, you can see the error + message:</para> + <figure> + <title>Error Message</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_13.png" + /> + </imageobject> + </mediaobject> + </figure> + <para>You can always invoke the verification by switching to the Diagram + viewer, right-clicking and selecting <emphasis> + <property>Verify</property> + </emphasis> from the context menu:</para> + <figure> + <title>Verify Command</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/verif_valid/verif_valid_14.png" + /> + </imageobject> + </mediaobject> + </figure> +</chapter> \ No newline at end of file Modified: trunk/struts/docs/struts_tools_ref_guide/pom.xml =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/pom.xml 2010-03-08 20:56:54 UTC (rev 20698) +++ trunk/struts/docs/struts_tools_ref_guide/pom.xml 2010-03-09 00:42:21 UTC (rev 20699) @@ -85,9 +85,9 @@ <configuration> <sourceDocumentName>${master}</sourceDocumentName> - <sourceDirectory>${pom.basedir}/en</sourceDirectory> + <sourceDirectory>${pom.basedir}/en-US</sourceDirectory> <imageResource> - <directory>${pom.basedir}/en</directory> + <directory>${pom.basedir}/en-US</directory> <includes> <include>images/**/*</include> </includes> Added: trunk/struts/docs/struts_tools_ref_guide/publican.cfg =================================================================== --- trunk/struts/docs/struts_tools_ref_guide/publican.cfg (rev 0) +++ trunk/struts/docs/struts_tools_ref_guide/publican.cfg 2010-03-09 00:42:21 UTC (rev 20699) @@ -0,0 +1,7 @@ +# Config::Simple 4.59 +# Fri Nov 20 13:19:45 2009 + +xml_lang: en-US +type: Book +brand: JBoss +