[jbosstools-commits] JBoss Tools SVN: r15752 - trunk/struts/docs/struts_tools_tutorial/en.

Author: ochikvina Date: 2009-06-05 11:27:56 -0400 (Fri, 05 Jun 2009) New Revision: 15752 Modified: trunk/struts/docs/struts_tools_tutorial/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-743 - updating the master_output.xml; Modified: trunk/struts/docs/struts_tools_tutorial/en/master_output.xml =================================================================== --- trunk/struts/docs/struts_tools_tutorial/en/master_output.xml 2009-06-05 15:27:40 UTC (rev 15751) +++ trunk/struts/docs/struts_tools_tutorial/en/master_output.xml 2009-06-05 15:27:56 UTC (rev 15752) @@ -26,7 +26,16 @@ <bookinfo> <title>Struts Tools Tutorial</title> - + <corpauthor diffmk:change="added"> + <inlinemediaobject diffmk:change="added"> + <imageobject diffmk:change="added" role="fo"> + <imagedata diffmk:change="added" fileref="images/jbosstools_logo.png" format="PNG"></imagedata> + </imageobject> + <imageobject diffmk:change="added" role="html"> + <imagedata diffmk:change="added"></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; @@ -37,9 +46,9 @@ <year>2009</year> <holder>JBoss, a division of Red Hat</holder> </copyright> - <releaseinfo> - Version: 3.0.0.GA - </releaseinfo> + <releaseinfo><diffmk:wrapper diffmk:change="changed"> + Version: 3.1.0.M1 + </diffmk:wrapper></releaseinfo> <abstract> <title></title> @@ -82,8 +91,8 @@ <section> <title>Other relevant resources on the topic</title> - <para><diffmk:wrapper diffmk:change="changed">All JBoss Developer Studio/JBoss Tools release documentation you can find at</diffmk:wrapper><ulink url="http://docs.jboss.org/tools/"><diffmk:wrapper diffmk:change="changed">http://docs.jboss.org/tools</diff... diffmk:change="changed"> in the corresponding release directory.</diffmk:wrapper></para> - <para><diffmk:wrapper diffmk:change="changed">The latest documentation builds are available at </diffmk:wrapper><ulink url="http://download.jboss.org/jbosstools/nightly-docs/"><... diffmk:change="changed">http://download.jboss.org/jbosstools... + <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/too... in the corresponding release directory.</para> + <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">htt... </section> @@ -102,8 +111,8 @@ <title>Creating a Simple Struts Application</title> - <para><diffmk:wrapper diffmk:change="added">Firstly, we assume that you have already launched Eclipse with </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> installed and - also that the </diffmk:wrapper><property moreinfo="none">Web Development perspective</property> is the current perspective. (If not, make it + <para>Firstly, we assume that you have already launched Eclipse with <property moreinfo="none">JBoss Tools</property> installed and + also that the <property moreinfo="none">Web Development perspective</property> is the current perspective. (If not, make it active by selecting <emphasis> <property moreinfo="none">Window &gt; Open Perspective &gt; Other &gt; Web Development</property> @@ -115,22 +124,22 @@ <itemizedlist> <listitem> <para>Go to the menu bar and select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">File &gt; New &gt; Struts Project</diffmk:wrapper></property> + <property moreinfo="none">File &gt; New &gt; Struts Project</property> </emphasis></para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Next enter "StrutsHello" as the project name</diffmk:wrapper></para> + <para>Next enter "StrutsHello" as the project name</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="changed">Leave everything else as it is, and click </diffmk:wrapper><emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Next</diffmk:wrapper></property> + <para>Leave everything else as it is, and click <emphasis> + <property moreinfo="none">Next</property> </emphasis></para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">If you have server runtime already defined, just pass to next point. Otherwise in the </diffmk:wrapper><emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Runtime</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> section click the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button and target at needed server runtime environment. Click </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + <para>If you have server runtime already defined, just pass to next point. Otherwise in the <emphasis> + <property moreinfo="none">Runtime</property></emphasis> section click the <emphasis> + <property moreinfo="none">New</property></emphasis> button and target at needed server runtime environment. Click <emphasis> + <property moreinfo="none">Finish</property>.</emphasis></para> </listitem> <listitem> <para>Click <emphasis> @@ -144,13 +153,13 @@ <property moreinfo="none">struts-html.tld</property> </emphasis>, and <emphasis> <property moreinfo="none">struts-logic.tld</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> are checked in the list of included tag libraries and then hit </diffmk:wrapper><emphasis> + </emphasis> are checked in the list of included tag libraries and then hit <emphasis> <property moreinfo="none">Finish</property> </emphasis></para> </listitem> </itemizedlist> - <para><diffmk:wrapper diffmk:change="added">A "StrutsHello" node should appear in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Package - Explorer view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + <para>A "StrutsHello" node should appear in the <property moreinfo="none">Package + Explorer view</property>.</para> <itemizedlist> <listitem> <para>Click the plus sign next to <emphasis> @@ -160,14 +169,14 @@ <listitem> <para>Click the plus sign next to <emphasis> <property moreinfo="none">WebContent</property> - </emphasis><diffmk:wrapper diffmk:change="added"> under </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">StrutsHello</diffmk:wrapper></property></emphasis></para> + </emphasis> under <emphasis> + <property moreinfo="none">StrutsHello</property></emphasis></para> </listitem> <listitem> <para>Click the plus sign next to <emphasis> <property moreinfo="none">WEB-INF</property> - </emphasis><diffmk:wrapper diffmk:change="added"> under </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WebContent</diffmk:wrapper></property></emphasis></para> + </emphasis> under <emphasis> + <property moreinfo="none">WebContent</property></emphasis></para> </listitem> <listitem> <para>Then, double-click on the <emphasis> @@ -182,9 +191,9 @@ <section id="CreatingtheApplicationComponents"> <?dbhtml filename="CreatingtheApplicationComponents.html"?> <title>Creating the Application Components</title> - <para><diffmk:wrapper diffmk:change="changed">Now, we will design the application by creating the individual components as + <para>Now, we will design the application by creating the individual components as placeholders first. (We don't have to complete all of the details inside the components - until afterwards.)</diffmk:wrapper></para> + until afterwards.)</para> <section id="CreatingJSPPagePlaceholders"> <title>Creating JSP Page Placeholders</title> <para>Next, let's create and place two JSP pages. We will not write any code @@ -194,15 +203,15 @@ <title>Creating the Page Placeholders</title> <itemizedlist> <listitem> - <para><diffmk:wrapper diffmk:change="added">Bring the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Projects view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to the front of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Package Explorer view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> - by selecting the </diffmk:wrapper><emphasis> + <para>Bring the <property moreinfo="none">Web Projects view</property> to the front of the <property moreinfo="none">Package Explorer view</property> + by selecting the <emphasis> <property moreinfo="none">Web Projects</property> </emphasis> tab next to that tab.</para> </listitem> <listitem> <para>Right-click the <emphasis> <property moreinfo="none">StrutsHello &gt; WEB-ROOT (WebContent)</property> - </emphasis><diffmk:wrapper diffmk:change="added"> folder in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Projects view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> and select </diffmk:wrapper><emphasis> + </emphasis> folder in the <property moreinfo="none">Web Projects view</property> and select <emphasis> <property moreinfo="none">New &gt; Folder...</property> </emphasis></para> </listitem> @@ -219,9 +228,9 @@ </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Right-click the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">pages</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> folder and select </diffmk:wrapper><emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; File &gt; JSP...</diffmk:wrapper></property> + <para>Right-click the <emphasis> + <property moreinfo="none">pages</property></emphasis> folder and select <emphasis> + <property moreinfo="none">New &gt; File &gt; JSP...</property> </emphasis> </para> </listitem> @@ -236,16 +245,16 @@ </emphasis> button</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Right-click the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">pages</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> folder again and select </diffmk:wrapper><emphasis> + <para>Right-click the <emphasis> + <property moreinfo="none">pages</property></emphasis> folder again and select <emphasis> <property moreinfo="none">New &gt; File &gt; JSP...</property> </emphasis></para> </listitem> <listitem> <para>For Name type in <emphasis> <property moreinfo="none">greeting</property> - </emphasis><diffmk:wrapper diffmk:change="added">, for Template leave as </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Blank</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="changed"> and then click on the </diffmk:wrapper><emphasis> + </emphasis>, for Template leave as <emphasis> + <property moreinfo="none">Blank</property>,</emphasis> and then click on the <emphasis> <property moreinfo="none">Finish</property> </emphasis> button</para> </listitem> @@ -259,19 +268,19 @@ <listitem> <para>Click on the <emphasis> <property moreinfo="none">struts-config.xml</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> tab in the editing area to bring the diagram to the - front</diffmk:wrapper></para> + </emphasis> tab in the editing area to bring the diagram to the + front</para> </listitem> <listitem> <para>Click on the <emphasis> <property moreinfo="none">inputname.jsp</property> - </emphasis><diffmk:wrapper diffmk:change="added"> page in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Projects view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, drag it onto the diagram, and - drop it</diffmk:wrapper></para> + </emphasis> page in the <property moreinfo="none">Web Projects view</property>, drag it onto the diagram, and + drop it</para> </listitem> <listitem><para>Click on the <emphasis> <property moreinfo="none">greeting.jsp</property> - </emphasis><diffmk:wrapper diffmk:change="added"> page in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Projects view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, drag it onto the diagram, and - drop it to the right of the </diffmk:wrapper><emphasis> + </emphasis> page in the <property moreinfo="none">Web Projects view</property>, drag it onto the diagram, and + drop it to the right of the <emphasis> <property moreinfo="none">/pages/inputname.jsp</property> </emphasis> icon with some extra space</para></listitem> </itemizedlist> @@ -285,7 +294,7 @@ <itemizedlist> <listitem> <para>Right-click between the two icons and select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; Action</diffmk:wrapper></property> + <property moreinfo="none">New &gt; Action</property> </emphasis></para> </listitem> <listitem> @@ -331,34 +340,30 @@ <para>The <emphasis> <property moreinfo="none">/greeting</property> - </emphasis><diffmk:wrapper diffmk:change="added"> action should appear in four places, in the diagram, under the - </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">action-mappings</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node, under the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">struts-config.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> node in Tree view, in </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Projects - view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> and in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Outline view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. Also, note the asterisk to the right of the name, - </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">struts-config.xml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Outline view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> showing that the file has been changed, but - not saved to disk.</diffmk:wrapper></para> + </emphasis> action should appear in four places, in the diagram, under the + <emphasis> + <property moreinfo="none">action-mappings</property></emphasis> node, under the <emphasis> + <property moreinfo="none">struts-config.xml</property></emphasis> node in Tree view, in <property moreinfo="none">Web Projects + view</property> and in the <property moreinfo="none">Outline view</property>. Also, note the asterisk to the right of the name, + <emphasis> + <property moreinfo="none">struts-config.xml</property>,</emphasis> in the <property moreinfo="none">Outline view</property> showing that the file has been changed, but + not saved to disk.</para> </section> <section id="CreatingaLink"> <title>Creating a Link</title> - <para><diffmk:wrapper diffmk:change="added">Let's now create a link from the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">inputname.jsp</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> page to the action.</diffmk:wrapper></para> + <para>Let's now create a link from the <emphasis> + <property moreinfo="none">inputname.jsp</property></emphasis> page to the action.</para> <itemizedlist> <listitem> - <para>On the left-hand side of the diagram in the column of icons, click on this - icon:</para> + <para><diffmk:wrapper diffmk:change="added">On the left-hand side of the diagram in the column of icons, click on the Create New Connection + icon( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject> + <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata> + </imageobject> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">).</diffmk:wrapper></para> </listitem> </itemizedlist> - <figure float="0"> - <title>Create New Connection Icon</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <itemizedlist> + <itemizedlist> <listitem> <para>In the connect-the-components mode you are in now, click on the <emphasis> <property moreinfo="none">/pages/inputname.jsp</property> @@ -374,18 +379,16 @@ <para>Next, we are going to create a forward for the action.</para> <itemizedlist> <listitem> - <para>On the left-hand side of the diagram in the column of icons, click on this - icon, again:</para> + <para><diffmk:wrapper diffmk:change="added">On the left-hand side of the diagram in the column of icons, click on + the Create New Connection + icon( </diffmk:wrapper><inlinemediaobject diffmk:change="added"> + <imageobject> + <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata> + </imageobject> + </inlinemediaobject><diffmk:wrapper diffmk:change="added">), again.</diffmk:wrapper></para> </listitem> </itemizedlist> - <figure float="0"> - <title>Create New Connection Icon</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/struts_application/struts_application_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> + <itemizedlist> <listitem> <para>Click on the <emphasis> @@ -395,11 +398,11 @@ </emphasis> icon</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">That's it. A link will be drawn from the actions new greeting - forward to the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">greeting.jsp</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> JSP page. Note that the forwards name will be + <para>That's it. A link will be drawn from the actions new greeting + forward to the <emphasis> + <property moreinfo="none">greeting.jsp</property></emphasis> JSP page. Note that the forwards name will be set based on the name of the target JSP file name. If you don't - like it, you can easily change it</diffmk:wrapper></para> + like it, you can easily change it</para> </listitem> <listitem> <para>Select the <emphasis> @@ -409,13 +412,13 @@ </listitem> <listitem> <para>Expand the <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">struts-config.xml/action-mappings/ /greeting</diffmk:wrapper></property> + <property moreinfo="none">struts-config.xml/action-mappings/ /greeting</property> </emphasis> node and then select the greeting forward</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">In the Properties Editor to the right, change the text to - "sayHello" in the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Name</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> field</diffmk:wrapper></para> + <para>In the Properties Editor to the right, change the text to + "sayHello" in the <emphasis> + <property moreinfo="none">Name</property></emphasis> field</para> </listitem> <listitem> <para>Select the <emphasis> @@ -431,14 +434,14 @@ <itemizedlist> <listitem> <para>Somewhere in the top-left corner of diagram, right-click and select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; Global Forward</diffmk:wrapper></property> + <property moreinfo="none">New &gt; Global Forward</property> </emphasis></para> </listitem> <listitem> <para>Enter <emphasis> <property moreinfo="none">getName</property> - </emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Name</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="changed"> field</diffmk:wrapper></para> + </emphasis> in the <emphasis> + <property moreinfo="none">Name</property></emphasis> field</para> </listitem> <listitem> <para>Select the <emphasis> @@ -488,9 +491,9 @@ <para>One last thing that we need to do is to create a form bean.</para> <itemizedlist> <listitem> - <para><diffmk:wrapper diffmk:change="added">Switch to the Tree viewer in the editor for the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">struts-config.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file, by - selecting the </diffmk:wrapper><emphasis> + <para>Switch to the Tree viewer in the editor for the <emphasis> + <property moreinfo="none">struts-config.xml</property></emphasis> file, by + selecting the <emphasis> <property moreinfo="none">Tree</property> </emphasis> tab at the bottom of the editor window</para> </listitem> @@ -517,8 +520,8 @@ </emphasis> from the menu bar</para> </listitem> </itemizedlist> - <para><diffmk:wrapper diffmk:change="added">Note the disappearance of the asterisk next to the name, </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">struts-config.xml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + <para>Note the disappearance of the asterisk next to the name, <emphasis> + <property moreinfo="none">struts-config.xml</property>.</emphasis></para> </section> </section> </chapter> @@ -569,9 +572,9 @@ </itemizedlist> <para>The Java files will be generated in a <emphasis> <property moreinfo="none">JavaSource &gt; sample</property> - </emphasis><diffmk:wrapper diffmk:change="added"> folder that you can see in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Package Explorer view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> under the + </emphasis> folder that you can see in the <property moreinfo="none">Package Explorer view</property> under the "StrutsHello" node. One Action stub and one FormBean stub will have - been generated.</diffmk:wrapper></para> + been generated.</para> </chapter> <chapter id="coding_files" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/struts/docs/struts_tools_tutorial/en/modules/coding_files.xml" xreflabel="coding_files"> @@ -608,8 +611,8 @@ </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="changed">You are looking at a Java stub class that was generated by JBoss - Tools. Now we are going to edit the file</diffmk:wrapper></para> + <para>You are looking at a Java stub class that was generated by JBoss + Tools. Now we are going to edit the file</para> </listitem> <listitem> @@ -641,19 +644,19 @@ <itemizedlist> <listitem> <para>Right-click and select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Source &gt; Generate Getters and Setters</diffmk:wrapper></property> + <property moreinfo="none">Source &gt; Generate Getters and Setters</property> </emphasis>from the context menu</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">In the dialog box, check the check box for </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">name</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> - select First method for Insertion point, and click on the </diffmk:wrapper><emphasis> + <para>In the dialog box, check the check box for <emphasis> + <property moreinfo="none">name</property>,</emphasis> + select First method for Insertion point, and click on the <emphasis> <property moreinfo="none">OK</property> </emphasis> button</para> </listitem> </itemizedlist> - <para><diffmk:wrapper diffmk:change="added">The final </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">GetNameForm.java</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file should look like this:</diffmk:wrapper></para> + <para>The final <emphasis> + <property moreinfo="none">GetNameForm.java</property></emphasis> file should look like this:</para> <programlisting format="linespecific" role="JAVA"><![CDATA[package sample; import javax.servlet.http.HttpServletRequest; import org.apache.struts.action.ActionErrors; @@ -701,8 +704,8 @@ <title>GreetingAction.java</title> <itemizedlist> <listitem> - <para><diffmk:wrapper diffmk:change="added">Open </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">GreetingAction.java</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> for editing</diffmk:wrapper></para> + <para>Open <emphasis> + <property moreinfo="none">GreetingAction.java</property></emphasis> for editing</para> </listitem> <listitem> <para>Inside the execute method, delete the TO DO lines and add the @@ -716,8 +719,8 @@ return mapping.findForward(FORWARD_sayHello); ]]></programlisting> - <para><diffmk:wrapper diffmk:change="added">The final version of </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">GreetingAction.java</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> should look like this:</diffmk:wrapper></para> + <para>The final version of <emphasis> + <property moreinfo="none">GreetingAction.java</property></emphasis> should look like this:</para> <programlisting format="linespecific" role="JAVA"><![CDATA[package sample; import javax.servlet.http.HttpServletRequest; @@ -784,9 +787,9 @@ <listitem> <para>Drag it and drop it between the quotes for the <emphasis role="italic"> <property moreinfo="none">"action"</property> - </emphasis> attribute to the <emphasis role="bold"> - <property moreinfo="none">&lt;html:form&gt;</property> - </emphasis> element in the Source pane of the editor</para> + </emphasis><diffmk:wrapper diffmk:change="added"> attribute to the + </diffmk:wrapper><code diffmk:change="added">&lt;html:form&gt;</code><diffmk:wrapper diffmk:change="added"> + element in the Source pane of the editor</diffmk:wrapper></para> </listitem> <listitem> <para>Then type this text on a new line just below this line:</para> @@ -831,7 +834,7 @@ </emphasis></para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">In the StrutsForm library in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, select </diffmk:wrapper><emphasis> + <para>In the StrutsForm library in the <property moreinfo="none">JBoss Tools Palette</property>, select <emphasis> <property moreinfo="none">submit</property> </emphasis>, and drag it to right after the text box in the Visual pane of the editor</para> @@ -839,9 +842,9 @@ <listitem> <para>Right-click the <emphasis> <property moreinfo="none">submit</property> - </emphasis> button and select <emphasis role="bold"> - <property moreinfo="none">&lt;html:submit&gt;</property> - </emphasis> Attributes from the context menu</para> + </emphasis><diffmk:wrapper diffmk:change="added"> button and select + </diffmk:wrapper><code diffmk:change="added">&lt;html:submit&gt;</code><diffmk:wrapper diffmk:change="added"> + Attributes from the context menu</diffmk:wrapper></para> </listitem> <listitem> <para>In the Attributes dialog box, select the <emphasis> @@ -885,21 +888,21 @@ </html> ]]></programlisting> - <para><diffmk:wrapper diffmk:change="added">To complete editing of this file, we will use macros from the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools - Palette</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. This palette is a view that should be available to the right of the - editing area.</diffmk:wrapper></para> + <para>To complete editing of this file, we will use macros from the <property moreinfo="none">JBoss Tools + Palette</property>. This palette is a view that should be available to the right of the + editing area.</para> <itemizedlist> <listitem> <para>Click on the <emphasis> <property moreinfo="none">Struts Common</property> - </emphasis><diffmk:wrapper diffmk:change="added"> folder in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to open it</diffmk:wrapper></para> + </emphasis> folder in the <property moreinfo="none">JBoss Tools Palette</property> to open it</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Position the cursor at the beginning of the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">greeting.jsp</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file in the - Source pane and then click on </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">bean taglib</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools - Palette</diffmk:wrapper></property></para> + <para>Position the cursor at the beginning of the <emphasis> + <property moreinfo="none">greeting.jsp</property></emphasis> file in the + Source pane and then click on <emphasis> + <property moreinfo="none">bean taglib</property></emphasis> in the <property moreinfo="none">JBoss Tools + Palette</property></para> </listitem> </itemizedlist> <para>This will insert the following line at the top of the file:</para> @@ -910,24 +913,24 @@ <listitem> <para>Click on the <emphasis> <property moreinfo="none">Struts Bean</property> - </emphasis><diffmk:wrapper diffmk:change="added"> folder in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> to open it</diffmk:wrapper></para> + </emphasis> folder in the <property moreinfo="none">JBoss Tools Palette</property> to open it</para> </listitem> <listitem> - <para>Position the cursor inside the <emphasis role="bold"> - <property moreinfo="none">&lt;p&gt;</property> - </emphasis> element</para> + <para><diffmk:wrapper diffmk:change="added">Position the cursor inside the + </diffmk:wrapper><code diffmk:change="added">&lt;p&gt;</code><diffmk:wrapper diffmk:change="added"> + element</diffmk:wrapper></para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Click on </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">write</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></property></para> + <para>Click on <emphasis> + <property moreinfo="none">write</property></emphasis> in the <property moreinfo="none">JBoss Tools Palette</property></para> </listitem> <listitem> <para>Type in "GetNameForm" for the <emphasis role="italic"> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">name</diffmk:wrapper></property> + <property moreinfo="none">name</property> </emphasis> attribute and add a <emphasis role="italic"> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">property</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="changed"> attribute with "name" as its - value</diffmk:wrapper></para> + <property moreinfo="none">property</property> + </emphasis> attribute with "name" as its + value</para> </listitem> </itemizedlist> <para>The editor should now look like this:</para> @@ -942,31 +945,31 @@ </section> <section id="index.jsp"> <title>index.jsp</title> - <para><diffmk:wrapper diffmk:change="added">Finally, we will need to create and edit an </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">index.jsp</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> page. This page will use - a Struts forward to simply redirect us to the getName global forward.</diffmk:wrapper></para> + <para>Finally, we will need to create and edit an <emphasis> + <property moreinfo="none">index.jsp</property></emphasis> page. This page will use + a Struts forward to simply redirect us to the getName global forward.</para> <itemizedlist> <listitem> <para>In the Web Projects view, right-click on <emphasis> <property moreinfo="none">StrutsHello &gt; WEB-ROOT(WebContent)</property> </emphasis> node and select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; File &gt; JSP</diffmk:wrapper></property> + <property moreinfo="none">New &gt; File &gt; JSP</property> </emphasis></para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Type </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">index</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> for Name and click on the </diffmk:wrapper><emphasis> + <para>Type <emphasis> + <property moreinfo="none">index</property></emphasis> for Name and click on the <emphasis> <property moreinfo="none">Finish</property> </emphasis> button</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">On the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools Palette</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, select the </diffmk:wrapper><emphasis> + <para>On the <property moreinfo="none">JBoss Tools Palette</property>, select the <emphasis> <property moreinfo="none">Struts Common</property> </emphasis> folder of macros by clicking on it in the palette</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Click on the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">logic taglib</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> icon</diffmk:wrapper></para> + <para>Click on the <emphasis> + <property moreinfo="none">logic taglib</property></emphasis> icon</para> </listitem> <listitem> <para>Press the <emphasis> @@ -979,8 +982,8 @@ </emphasis> folder of macros</para> </listitem> <listitem> - <para><diffmk:wrapper diffmk:change="added">Click on </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">redirect</diffmk:wrapper></property></emphasis></para> + <para>Click on <emphasis> + <property moreinfo="none">redirect</property></emphasis></para> </listitem> <listitem> <para>Delete the ending tag, put a forward slash in front of the closing @@ -1139,50 +1142,35 @@ <listitem><para>In the JBoss Tools Palette view to the right, open the Struts HTML folder and click on the javascript tag</para></listitem> <listitem><para>Back in the editor, just in front of the closing slash for this inserted tag, hit Ctrl+Space and select "formName" from the prompting menu</para></listitem> <listitem><para>Over in the Web Projects view, select GetNameForm under the <emphasis><property moreinfo="none">StrutsHello &gt; Configuration &gt; default &gt; struts-config.xml &gt; form-beans</property></emphasis> node, drag it, and drop it between the quotes in the editor</para></listitem> -<listitem><para>Modify the <emphasis role="bold"><property moreinfo="none">&lt;html:form&gt;</property></emphasis> tag by inserting this attribute:</para></listitem> +<listitem><para>Modify the <code diffmk:change="added">&lt;html:form&gt;</code> tag by inserting this attribute:</para></listitem> </itemizedlist> <programlisting format="linespecific" role="XML"><![CDATA[onsubmit="return validateGetNameForm(this)" ]]></programlisting> <para></para> <para>The file should now look like this:</para> <programlisting format="linespecific" role="XML"><![CDATA[ -<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %> -<html:html> -<head> - <title>Input name</title> - <html:javascript formName="GetNameForm"/> -</head> -<body> - <html:form action="/greeting.do" onsubmit="return - <para>validateGetNameForm(this)"></para> - <table border="0" cellspacing="0" cellpadding="0"> - <tr> - <td><b>Input name:</b></td> - </tr> - <tr> - <td> - <html:text property="name" /> - <html:submit value=" Say Hello! " /> - </td> - </tr> - </table> - </html:form> -</body> +<%@ taglib uri="/WEB-INF/struts-html" prefix="html" %> + +<html:html > + <head> + <html:javascript formName="GetNameForm"/> + <title></title> + </head> + <body> + <html:form action="/greeting.do" onsubmit="return validateGetNameForm(this)"> + Input name:<html:text property="name"/><html:submit value="Say Hello!"/> + </html:form> + </body> </html:html> ]]></programlisting> <itemizedlist> <listitem><para>Select<emphasis><property moreinfo="none"> File &gt; Save </property></emphasis>from the menu bar</para></listitem> <listitem><para>Start JBoss Application Server by clicking on its icon (a right-pointing arrow) in the toolbar</para></listitem> -<listitem><para>Click the Run icon or right click your project folder and select <emphasis><property moreinfo="none">Run As &gt; Run on Server</property></emphasis></para></listitem> + <listitem><para><diffmk:wrapper diffmk:change="added">Click the Run icon(</diffmk:wrapper><inlinemediaobject diffmk:change="added"> <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/struts_validation/struts_validation_1.png"></imagedata> + </imageobject></inlinemediaobject><diffmk:wrapper diffmk:change="added">) or right click your project folder and select </diffmk:wrapper><emphasis><property moreinfo="none">Run As &gt; Run on Server</property></emphasis></para></listitem> </itemizedlist> -<figure float="0"> - <title>Run Icon</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/struts_validation/struts_validation_1.png"></imagedata> - </imageobject> -</mediaobject> -</figure> + <itemizedlist><listitem><para>In the browser window, click on the "Say Hello!" button without having entered any name in the form</para></listitem></itemizedlist> <para>A JavaScript error message should be displayed in an alert box.</para> </section> @@ -1197,34 +1185,26 @@ <title>Editing the JSP File</title> <itemizedlist> <listitem><para>Reopen inputname.jsp for editing</para></listitem> -<listitem><para>Delete the <emphasis role="italic"><property moreinfo="none">"onsubmit"</property></emphasis> attribute in the <emphasis role="bold"><property moreinfo="none">&lt;html:form&gt;</property></emphasis> element that you put in for client-side validation</para></listitem> +<listitem><para>Delete the <emphasis role="italic"><property moreinfo="none">"onsubmit"</property></emphasis> attribute in the <code diffmk:change="added">&lt;html:form&gt;</code> element that you put in for client-side validation</para></listitem> -<listitem><para>Add an <emphasis role="bold"><property moreinfo="none">&lt;html:errors&gt;</property></emphasis> tag after the <emphasis role="bold"><property moreinfo="none">&lt;html:form&gt;</property></emphasis> tag</para></listitem> +<listitem><para>Add an <code diffmk:change="added"><diffmk:wrapper diffmk:change="added">&lt;html:errors/&gt;</diffmk:wrapper></code><diffmk:wrapper diffmk:change="added"> tag after the + </diffmk:wrapper><code diffmk:change="added">&lt;html:form&gt;</code><diffmk:wrapper diffmk:change="added"> + tag</diffmk:wrapper></para></listitem> </itemizedlist> <para>The JSP file should now look like this:</para> -<programlisting format="linespecific" role="XML"><![CDATA[<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %> -<html:html> + <programlisting format="linespecific" role="XML"><![CDATA[<%@ taglib uri="/WEB-INF/struts-html" prefix="html" %> +<html:html > <head> - <title>Input name</title> - <html:javascript formName="GetNameForm"/> -</head> -<body> - <html:form action="/greeting.do"> - <table border="0" cellspacing="0" cellpadding="0"> - <tr> - <td><b>Input name:</b></td> - </tr> - <tr> - <td> - <html:text property="name" /> - <html:submit value=" Say Hello! " /> - </td> - </tr> - </table> - </html:form> - <html:errors /> -</body> + <html:javascript formName="GetNameForm"/> + <title></title> + </head> + <body> + <html:form action="/greeting.do" >Input name:<html:text property="name"/> + <html:submit value="Say Hello!"/> + </html:form> + <html:errors/> + </body> </html:html> ]]></programlisting> @@ -1289,11 +1269,11 @@ } // public ActionErrors validate(ActionMapping actionMapping, - HttpServletRequest request) - { - // ActionErrors errors = new ActionErrors(); - // return errors; - // } + // HttpServletRequest request) + //{ + // ActionErrors errors = new ActionErrors(); + // return errors; + // } } ]]></programlisting> @@ -1338,7 +1318,7 @@ <para>To find out all the features of <property moreinfo="none">JBoss Tools</property> for working with Struts refer to our <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink>. If you - still have questions you are always welcome on <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... + still have questions you are always welcome on <ulink url="http://www.jboss.com/index.html?module=bb&apos;op=viewforum... Tools Forum</ulink>.</para> </chapter>