You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by st...@apache.org on 2005/08/31 00:42:33 UTC

svn commit: r264885 - /beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml

Author: steveh
Date: Tue Aug 30 15:42:25 2005
New Revision: 264885

URL: http://svn.apache.org/viewcvs?rev=264885&view=rev
Log:
Editing run through.
(1) Spelling fixed.
(2) Some <CDATA> tags removed to restore bold font.

Modified:
    beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml

Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml?rev=264885&r1=264884&r2=264885&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml Tue Aug 30 15:42:25 2005
@@ -140,7 +140,7 @@
                 <!--[tbd: more, explain]-->
                 </p>
                 <p>    
-                controller classs contain Action methods. An Action method may do something simple, such 
+                Controller classes contain Action methods. An Action method may do something simple, such 
                 as forward a user from one JSP to another; or it may do a complex set of tasks, such 
                 as receive user input from a JSP, calculate and/or retrieve other data based on the 
                 user input, and forward the user to a JSP where the results are displayed. 
@@ -300,27 +300,25 @@
                 <p>Open the file <code>pageflow_tutorial/index.jsp</code>.</p>
                 <p>Edit <code>index.jsp</code> so it appears as follows.  The code to add appears in bold type.</p>
         <p><strong><code>index.jsp</code></strong></p>
-        <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0" prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0" prefix="netui-template"%>
-<netui:html>
-  <head>
-    <title>Web Application Page</title>
-    <netui:base/>
-  </head>
-  <netui:body>
-    <p>
+        <source>
+&lt;%@ page language="java" contentType="text/html;charset=UTF-8"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0" prefix="netui-data"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0" prefix="netui-template"%>
+&lt;netui:html>
+  &lt;head>
+    &lt;title>Web Application Page&lt;/title>
+    &lt;netui:base/>
+  &lt;/head>
+  &lt;netui:body>
+    &lt;p>
       New Web Application Page
-    </p>
-    <strong><p>
-      <netui:anchor action="toPage2">Link to page2.jsp</netui:anchor>
-    </p></strong>
-  </netui:body>
-</netui:html>
-]]>
-                </source>
+    &lt;/p>
+    <strong>&lt;p>
+      &lt;netui:anchor action="toPage2">Link to page2.jsp&lt;/netui:anchor>
+    &lt;/p></strong>
+  &lt;/netui:body>
+&lt;/netui:html></source>
             <p>Save <code>index.jsp</code>.</p>            
             </section>
             <section id="navigate_add_action">
@@ -376,31 +374,29 @@
                     In a later step, the new Action will be added to the controller class to handle the data submission.</p>
                 <p>Edit the file <code>pageflow_tutorial/page2.jsp</code> so it appears as follows.</p>
                 <p><strong><code>page2.jsp</code></strong></p>                
-                <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
-<netui:html>
-  <head>
-    <title>page2.jsp</title>
-    <netui:base/>
-  </head>
-  <netui:body>
-    <p>
+                <source>
+&lt;%@ page language="java" contentType="text/html;charset=UTF-8"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
+&lt;netui:html>
+  &lt;head>
+    &lt;title>page2.jsp&lt;/title>
+    &lt;netui:base/>
+  &lt;/head>
+  &lt;netui:body>
+    &lt;p>
       Welcome to page2.jsp!
-    </p>
-    <strong><p>
-      <netui:form action="processData">
-        Name: <netui:textBox dataSource="actionForm.name"/>
-        <br/>
-        Age: <netui:textBox dataSource="actionForm.age"/>
-        <br/>
-        <netui:button type="submit" value="Submit"/>
-      </netui:form>
-    </p></strong>
-  </netui:body>
-</netui:html>
-]]>
-</source>
+    &lt;/p>
+    <strong>&lt;p>
+      &lt;netui:form action="processData">
+        Name: &lt;netui:textBox dataSource="actionForm.name"/>
+        &lt;br/>
+        Age: &lt;netui:textBox dataSource="actionForm.age"/>
+        &lt;br/>
+        &lt;netui:button type="submit" value="Submit"/>
+      &lt;/netui:form>
+    &lt;/p></strong>
+  &lt;/netui:body>
+&lt;/netui:html></source>
 <p>Save <code>page2.jsp</code>.</p>
             </section>
             <section id="forms_create_formbean">
@@ -631,32 +627,30 @@
                 <p>Add the <code>&lt;netui:error></code> tag to display validation error messages on the page.</p>
                 <p>Edit the file <code>pageflow_tutorial/page2.jsp</code> so it appears as follows.</p>
                 <p><strong><code>page2.jsp</code></strong></p>
-                <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
-<netui:html>
-  <head>
-    <title>page2.jsp</title>
-    <netui:base/>
-  </head>
-  <netui:body>
-    <p>
+                <source>&lt;%@ page language="java" contentType="text/html;charset=UTF-8"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
+&lt;netui:html>
+  &lt;head>
+    &lt;title>page2.jsp&lt;/title>
+    &lt;netui:base/>
+  &lt;/head>
+  &lt;netui:body>
+    &lt;p>
       Welcome to page2.jsp!
-    </p>
-    <p>
-      <netui:form action="processData">
-        Name: <netui:textBox dataSource="actionForm.name"/>
-        <strong><netui:error key="name"/></strong>
-        <br/>
-        Age: <netui:textBox dataSource="actionForm.age"/>
-        <strong><netui:error key="age"/></strong>
-        <br/>
-        <netui:button type="submit" value="Submit"/>
-      </netui:form>
-    </p>
-  </netui:body>
-</netui:html>
-]]></source>
+    &lt;/p>
+    &lt;p>
+      &lt;netui:form action="processData">
+        Name: &lt;netui:textBox dataSource="actionForm.name"/>
+        <strong>&lt;netui:error key="name"/></strong>
+        &lt;br/>
+        Age: &lt;netui:textBox dataSource="actionForm.age"/>
+        <strong>&lt;netui:error key="age"/></strong>
+        &lt;br/>
+        &lt;netui:button type="submit" value="Submit"/>
+      &lt;/netui:form>
+    &lt;/p>
+  &lt;/netui:body>
+&lt;/netui:html></source>
                 <p>Save and close <code>page2.jsp</code>.</p>
             </section>
             <section id="validation_build_deploy">
@@ -678,46 +672,45 @@
             <title>Step 7: Collect Data from a Nested Page Flow</title>
             <section id="nested_link">
                 <title>Link to the Nested Page Flow</title>
-                <p>Modify the HTML form tag to add a new data field and a button and link it to an
-                    Action in the nested page flow. In a later step, the new nested controller class
-                    will be created to handle the data collection.</p>
+                <p>In this task you will modify the HTML form tag to (1) add a new data field and (2) 
+                add a button linking to an
+                    Action in a nested page flow. (Later you will create the nested controller class
+                     to handle the data collection.)</p>
                 <p>Edit the file <code>pageflow_tutorial/page2.jsp</code> so it
                     appears as follows. Code to add appears in bold.</p>
                 <p><strong><code>page2.jsp</code></strong></p>
-                <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
-<netui:html>
-  <head>
-    <title>page2.jsp</title>
-    <netui:base/>
-  </head>
-  <netui:body>
-    <p>
+                <source>&lt;%@ page language="java" contentType="text/html;charset=UTF-8"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
+&lt;netui:html>
+  &lt;head>
+    &lt;title>page2.jsp&lt;/title>
+    &lt;netui:base/>
+  &lt;/head>
+  &lt;netui:body>
+    &lt;p>
       Welcome to page2.jsp!
-    </p>
-    <p>
-      <netui:form action="processData">
-        Name: <netui:textBox dataSource="actionForm.name"/>
-        <netui:error key="name"/>
-        <br/>
-        Age: <netui:textBox dataSource="actionForm.age"/>
-        <netui:error key="age"/>
-        <br/>
-        <strong>Sport: <netui:textBox dataSource="actionForm.sport"/>
-        <br/>
-        <netui:button type="submit" action="getSport" value="Select Sport"/></strong>
-        <netui:button type="submit" value="Submit"/>
-      </netui:form>
-    </p>
-  </netui:body>
-</netui:html>
-]]></source>
+    &lt;/p>
+    &lt;p>
+      &lt;netui:form action="processData">
+        Name: &lt;netui:textBox dataSource="actionForm.name"/>
+        &lt;netui:error key="name"/>
+        &lt;br/>
+        Age: &lt;netui:textBox dataSource="actionForm.age"/>
+        &lt;netui:error key="age"/>
+        &lt;br/>
+        <strong>Sport: &lt;netui:textBox dataSource="actionForm.sport"/>
+        &lt;br/>
+        &lt;netui:button type="submit" action="getSport" value="Select Sport"/></strong>
+        &lt;netui:button type="submit" value="Submit"/>
+      &lt;/netui:form>
+    &lt;/p>
+  &lt;/netui:body>
+&lt;/netui:html></source>
                 <p>Save <code>page2.jsp</code>.</p>
             </section>
             <section id="validation_update_formbean">
                 <title>Update the Form Bean</title>
-                <p>In this step you will update the Java class that represents the submission form with the
+                <p>In this task you will update the Java class that represents the submission form with the
                     additional data field created in the previous task.  When the nested page flow returns,
                     the new member of the Form Bean class instance can be loaded with the value collected.</p>
                 <p>Edit <code>pageflow_tutorial/WEB-INF/src/forms/ProfileForm.java</code>
@@ -742,7 +735,7 @@
             </section>
             <section id="validation_update_controller">
                 <title>To Launch and Return from the Nested Page Flow</title>
-                <p>Add Action methods to handle forwarding to the nested page flow and another to
+                <p>In this task you will add Action methods: one to handle forwarding to the nested page flow and another to
                     implement the return Action when the nested page flow completes.</p>
                 <p>Open the file <code>pageflow_tutorial/Controller.java</code></p>
                 <p>Edit <code>Controller.java</code> so it appears as follows.  Code to add appears
@@ -844,7 +837,7 @@
             </section>
             <section id="validation_create_nested">
                 <title>Create a Nested Page Flow</title>
-                <p>In this step you will create a nested page flow with actions to select and confirm
+                <p>In this task you will create a nested page flow with actions to select and confirm
                     the data to return to the main ("nesting") page flow. The new nested controller class
                     contains an inner Form Bean classs for the data collection. It has only a single
                     field for the user's choice of sport activity. The options to be displayed are
@@ -927,7 +920,7 @@
             </section>
             <section id="validation_collect_data">
                 <title>To Present and Collect Data using a Form</title>
-                <p>This step illustrates the use of custom tags to render a radio button group in an HTML form and 
+                <p>This task illustrates the use of custom tags to render a radio button group in an HTML form and 
                    link it to the nested page flow <code>selectSport</code> Action method.</p>
                 <p>In the directory <code>pageflow_tutorial/sports</code>, create a file named <code>index.jsp</code>.</p>
                 <p>Edit index.jsp so it appears as follows.</p>
@@ -1039,8 +1032,8 @@
             </section>
             <section id="sharedflow_action">
                 <title>To Make an Action available to multiple Page Flows</title>
-                <p>In this step you will add a Simple Action to the existing Shared Flow.  The Action forwards to the 
-                    help page created in the previous step and will be available to multiple page flows in the application.</p>
+                <p>In this task you will add a Simple Action to the existing Shared Flow.  The Action forwards to the 
+                    help page created in the previous task and will be available to multiple page flows in the application.</p>
                 <p>Open the existing Shared Flow file <code>pageflow_tutorial/WEB-INF/src/shared/SharedFlow.java</code></p>
                 <p>
                     Edit the
@@ -1070,36 +1063,33 @@
             </section>
             <section id="sharedflow_link">
                 <title>To Link a Page to the Shared Flow Action</title>
-                <p>In this step you will create a link from the JSP, <code>index.jsp</code> to the
+                <p>In this task you will create a link from the JSP, <code>index.jsp</code> to the
                     Shared Flow Action.</p>
                 <p>Open the file <code>pageflow_tutorial/index.jsp</code>.</p>
                 <p>Edit <code>index.jsp</code> so it appears as follows.  The code to add appears in bold type.</p>
                 <p><strong><code>index.jsp</code></strong></p>
-                <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0" prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0" prefix="netui-template"%>
-<netui:html>
-  <head>
-    <title>Web Application Page</title>
-    <netui:base/>
-  </head>
-  <netui:body>
-    <p>
+                <source>&lt;%@ page language="java" contentType="text/html;charset=UTF-8"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0" prefix="netui-data"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%>
+&lt;%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0" prefix="netui-template"%>
+&lt;netui:html>
+  &lt;head>
+    &lt;title>Web Application Page&lt;/title>
+    &lt;netui:base/>
+  &lt;/head>
+  &lt;netui:body>
+    &lt;p>
       New Web Application Page
-    </p>
-    <p>
-      <netui:anchor action="toPage2">Link to page2.jsp</netui:anchor>
-    </p>
-    <strong><netui:anchor action="shared.showHelp" popup="true">Help
-      <netui:configurePopup location="false" width="550" height="150">
-      </netui:configurePopup>
-    </netui:anchor></strong>
-  </netui:body>
-</netui:html>
-]]>
-                </source>
+    &lt;/p>
+    &lt;p>
+      &lt;netui:anchor action="toPage2">Link to page2.jsp&lt;/netui:anchor>
+    &lt;/p>
+    <strong>&lt;netui:anchor action="shared.showHelp" popup="true">Help
+      &lt;netui:configurePopup location="false" width="550" height="150">
+      &lt;/netui:configurePopup>
+    &lt;/netui:anchor></strong>
+  &lt;/netui:body>
+&lt;/netui:html></source>
                 <p>Save <code>index.jsp</code>.</p>
             </section>
             <section id="sharedflow_build_deploy">