Author: steveh Date: Thu Nov 4 15:12:18 2004 New Revision: 56630 Modified: incubator/beehive/site/build/site/index.html incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html incubator/beehive/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml Log: JIRA bug 61: Page Flow Tutorial Needs to be Updated Regarding Deploying Netui Runtime
Modified: incubator/beehive/site/build/site/index.html ============================================================================== --- incubator/beehive/site/build/site/index.html (original) +++ incubator/beehive/site/build/site/index.html Thu Nov 4 15:12:18 2004 @@ -264,20 +264,20 @@ <a href="#Get+Involved">Get Involved</a> </li> </ul> - <!-- - Beehive - Welcome<should link to the HTML page created from Welcome.doc> - License<should link to http://www.apache.org/licenses/LICENSE-2.0> - - Documentation - FAQ<should link to the HTML page created from FAQ.doc> - Controls Overview<should link to Kyle's control Overview> - Controls Programming<should link to Kyle's Controls programming pdf> - Web Services (JSR 181)<should link to http://jcp.org/en/jsr/detail?id=181> - - Contributing - Mailing Lists<should link to HTML Page created from MailingLists.doc> - Contributers<should link to HTML Page created from Contributers.doc> + <!-- + Beehive + Welcome<should link to the HTML page created from Welcome.doc> + License<should link to http://www.apache.org/licenses/LICENSE-2.0> + + Documentation + FAQ<should link to the HTML page created from FAQ.doc> + Controls Overview<should link to Kyle's control Overview> + Controls Programming<should link to Kyle's Controls programming pdf> + Web Services (JSR 181)<should link to http://jcp.org/en/jsr/detail?id=181> + + Contributing + Mailing Lists<should link to HTML Page created from MailingLists.doc> + Contributers<should link to HTML Page created from Contributers.doc> --> Modified: incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html ============================================================================== --- incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html (original) +++ incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html Thu Nov 4 15:12:18 2004 @@ -289,13 +289,13 @@ <a href="#Introduction">Introduction</a> </li> <li> -<a href="#To+Create+a+Controller+File">To Create a Controller File</a> +<a href="#To+Copy+the+Page+Flow+Application+Template.">To Copy the Page Flow Application Template.</a> </li> <li> -<a href="#To+Create+a+JSP+File">To Create a JSP File</a> +<a href="#To+Create+a+Controller+File">To Create a Controller File</a> </li> <li> -<a href="#To+Add+Beehive+Runtime+JARs+to+Your+Web+Application.">To Add Beehive Runtime JARs to Your Web Application.</a> +<a href="#To+Create+a+JSP+File">To Create a JSP File</a> </li> <li> <a href="#To+Compile+the+Page+Flow">To Compile the Page Flow</a> @@ -324,16 +324,16 @@ <a href="#To+Add+an+Action+Method+to+Handle+the+Link">To Add an Action Method to Handle the Link</a> </li> <li> -<a href="#To+Compile+the+Page+Flow-N101C7">To Compile the Page Flow</a> +<a href="#To+Compile+the+Page+Flow-N101DE">To Compile the Page Flow</a> </li> <li> -<a href="#To+Start+the+Tomcat+Server-N101D5">To Start the Tomcat Server</a> +<a href="#To+Start+the+Tomcat+Server-N101EC">To Start the Tomcat Server</a> </li> <li> -<a href="#To+Test+the+Page+Flow+Web+Application-N101E3">To Test the Page Flow Web Application</a> +<a href="#To+Test+the+Page+Flow+Web+Application-N101FA">To Test the Page Flow Web Application</a> </li> <li> -<a href="#To+Shutdown+the+Tomcat+Server-N101FA">To Shutdown the Tomcat Server</a> +<a href="#To+Shutdown+the+Tomcat+Server-N10211">To Shutdown the Tomcat Server</a> </li> </ul> </li> @@ -347,16 +347,16 @@ <a href="#To+Edit+the+Controller+File+to+Handle+the+Submitted+Data">To Edit the Controller File to Handle the Submitted Data</a> </li> <li> -<a href="#To+Compile+the+Page+Flow-N10243">To Compile the Page Flow</a> +<a href="#To+Compile+the+Page+Flow-N1025A">To Compile the Page Flow</a> </li> <li> -<a href="#To+Start+the+Tomcat+Server-N10251">To Start the Tomcat Server</a> +<a href="#To+Start+the+Tomcat+Server-N10268">To Start the Tomcat Server</a> </li> <li> -<a href="#To+Test+the+Page+Flow+Web+Application-N1025F">To Test the Page Flow Web Application</a> +<a href="#To+Test+the+Page+Flow+Web+Application-N10276">To Test the Page Flow Web Application</a> </li> <li> -<a href="#To+Shutdown+the+Tomcat+Server-N1027C">To Shutdown the Tomcat Server</a> +<a href="#To+Shutdown+the+Tomcat+Server-N10293">To Shutdown the Tomcat Server</a> </li> </ul> </li> @@ -370,16 +370,16 @@ <a href="#To+Create+a+JSP+Page+to+Display+Submitted+Data">To Create a JSP Page to Display Submitted Data</a> </li> <li> -<a href="#To+Compile+the+Page+Flow-N102B3">To Compile the Page Flow</a> +<a href="#To+Compile+the+Page+Flow-N102CA">To Compile the Page Flow</a> </li> <li> -<a href="#To+Start+the+Tomcat+Server-N102C1">To Start the Tomcat Server</a> +<a href="#To+Start+the+Tomcat+Server-N102D8">To Start the Tomcat Server</a> </li> <li> -<a href="#To+Test+the+Page+Flow+Web+Application-N102CF">To Test the Page Flow Web Application</a> +<a href="#To+Test+the+Page+Flow+Web+Application-N102E6">To Test the Page Flow Web Application</a> </li> <li> -<a href="#To+Shutdown+the+Tomcat+Server-N102EC">To Shutdown the Tomcat Server</a> +<a href="#To+Shutdown+the+Tomcat+Server-N10303">To Shutdown the Tomcat Server</a> </li> </ul> </li> @@ -487,11 +487,28 @@ The Controller file you create in this step contains one simple Action method. This simple navigational Action method forwards users to the index.jsp page. In the next step, you will create a more complex Action method. </p> </div> -<a name="N100D5"></a><a name="To+Create+a+Controller+File"></a> +<a name="N100D5"></a><a name="To+Copy+the+Page+Flow+Application+Template."></a> +<h4>To Copy the Page Flow Application Template.</h4> +<div style="margin-left: 0 ; border: 2px"> +<p>In this step you will assemble the runtime resources for your Page Flow application. These resourses consist of runtime JARs, the <netui> tag library, and Struts configuration files. All of these resources are contained in the Page Flow application template located at<span class="codefrag">BEEHIVE_HOME/samples/netui-blank</span>.</p> +<p>In the directory <span class="codefrag">CATALINA_HOME/webapps</span>, create a directory named <span class="codefrag">pageflow_tutorial</span>.</p> +<p>Copy the folders</p> +<pre class="code">BEEHIVE_HOME/samples/netui-blank/resources</pre> +<pre class="code">BEEHIVE_HOME/samples/netui-blank/WEB-INF</pre> +<p>into</p> +<pre class="code">CATALINA_HOME/webapps/pageflow_tutorial</pre> +<p>You should *not* copy Controller.jpf, index.jsp, and error.jsp. For the sake of instruction, you will create these files by hand.</p> +<p>Before proceeding, confirm that the following directory structure exists:</p> +<pre class="code">CATALINA_HOME + webapps + pageflow_tutorial + resources + WEB-INF</pre> +</div> +<a name="N1010B"></a><a name="To+Create+a+Controller+File"></a> <h4>To Create a Controller File</h4> <div style="margin-left: 0 ; border: 2px"> <p>In this step you will create the Controller file in place in the Tomcat deployment directory.</p> -<p>In the directory <span class="codefrag">CATALINA_HOME/webapps</span>, create a directory named <span class="codefrag">pageflow_tutorial</span>.</p> <p>In the directory <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial</span>, create a file named <span class="codefrag">Controller.jpf</span>.</p> <p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p> <p>Edit <span class="codefrag">Controller.jpf</span> so it appears as follows.</p> @@ -514,7 +531,7 @@ }</pre> <p>Save and close the file Controller.jpf.</p> </div> -<a name="N10102"></a><a name="To+Create+a+JSP+File"></a> +<a name="N1012F"></a><a name="To+Create+a+JSP+File"></a> <h4>To Create a JSP File</h4> <div style="margin-left: 0 ; border: 2px"> <p>In the directory <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial</span>, create a file named <span class="codefrag">index.jsp</span>.</p> @@ -533,14 +550,7 @@ </netui:body> </netui:html></pre> </div> -<a name="N1011D"></a><a name="To+Add+Beehive+Runtime+JARs+to+Your+Web+Application."></a> -<h4>To Add Beehive Runtime JARs to Your Web Application.</h4> -<div style="margin-left: 0 ; border: 2px"> -<p>In this step you will assemble the runtime resources for your Page Flow application. Most of these files are included in the WEB-INF directory. It includes JAR files with the JSP tag handler classes, Struts config files, etc. <!--[tbd: for a complete list see...]--></p> -<p>Using the command shell opened in the previous step, at the command prompt, enter: </p> -<pre class="code">ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml deploy.beehive.webapp.runtime -Dwebapp.dir=%CATALINA_HOME%\webapps\pageflow_tutorial</pre> -</div> -<a name="N10130"></a><a name="To+Compile+the+Page+Flow"></a> +<a name="N1014A"></a><a name="To+Compile+the+Page+Flow"></a> <h4>To Compile the Page Flow</h4> <div style="margin-left: 0 ; border: 2px"> <p>You are now ready to compile the Page Flow.</p> @@ -552,20 +562,20 @@ </p> <p>WORKAROUND: create the directory CATALINA_HOME/webapps/pageflowtutorial/WEB-INF/src and recompile.</p> </div> -<a name="N1014A"></a><a name="To+Start+the+Tomcat+Server"></a> +<a name="N10164"></a><a name="To+Start+the+Tomcat+Server"></a> <h4>To Start the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter:</p> <pre class="code">%CATALINA_HOME%\bin\startup.bat</pre> </div> -<a name="N10159"></a><a name="To+Test+the+Page+Flow+Web+Application"></a> +<a name="N10173"></a><a name="To+Test+the+Page+Flow+Web+Application"></a> <h4>To Test the Page Flow Web Application</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open a web browser and enter the following in the address bar:</p> <pre class="code">http://localhost:8080/pageflow_tutorial</pre> <p>You will be directed to the <span class="codefrag">index.jsp</span> page.</p> </div> -<a name="N1016E"></a><a name="To+Shutdown+the+Tomcat+Server"></a> +<a name="N10188"></a><a name="To+Shutdown+the+Tomcat+Server"></a> <h4>To Shutdown the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: @@ -574,10 +584,10 @@ </div> </div> -<a name="N1017E"></a><a name="step_3"></a> +<a name="N10198"></a><a name="step_3"></a> <h3>Step 3: Navigation</h3> <div style="margin-left: 0 ; border: 2px"> -<a name="N10184"></a><a name="To+Create+a+Destination+JSP+Page"></a> +<a name="N1019E"></a><a name="To+Create+a+Destination+JSP+Page"></a> <h4>To Create a Destination JSP Page</h4> <div style="margin-left: 0 ; border: 2px"> <p>In the directory <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial</span>, create a file named <span class="codefrag">page2.jsp</span>.</p> @@ -597,7 +607,7 @@ </netui:html></pre> <p>Save and close <span class="codefrag">page2.jsp</span>.</p> </div> -<a name="N101A2"></a><a name="To+Create+a+Link+to+the+Destination+Page"></a> +<a name="N101BC"></a><a name="To+Create+a+Link+to+the+Destination+Page"></a> <h4>To Create a Link to the Destination Page</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open the file <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial/index.jsp</span>.</p> @@ -621,7 +631,7 @@ </netui:html> </pre> </div> -<a name="N101BA"></a><a name="To+Add+an+Action+Method+to+Handle+the+Link"></a> +<a name="N101D4"></a><a name="To+Add+an+Action+Method+to+Handle+the+Link"></a> <h4>To Add an Action Method to Handle the Link</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open the file <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial/Controller.jpf</span>.</p> @@ -655,19 +665,19 @@ } }</pre> </div> -<a name="N101D2"></a><a name="To+Compile+the+Page+Flow-N101C7"></a> +<a name="N101EC"></a><a name="To+Compile+the+Page+Flow-N101DE"></a> <h4>To Compile the Page Flow</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter:</p> <pre class="code">ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml build.webapp -Dwebapp.dir=%CATALINA_HOME%\webapps\pageflow_tutorial</pre> </div> -<a name="N101E1"></a><a name="To+Start+the+Tomcat+Server-N101D5"></a> +<a name="N101FB"></a><a name="To+Start+the+Tomcat+Server-N101EC"></a> <h4>To Start the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: </p> <pre class="code">%CATALINA_HOME%\bin\startup.bat</pre> </div> -<a name="N101F0"></a><a name="To+Test+the+Page+Flow+Web+Application-N101E3"></a> +<a name="N1020A"></a><a name="To+Test+the+Page+Flow+Web+Application-N101FA"></a> <h4>To Test the Page Flow Web Application</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open a web browser and enter the following in the address bar: @@ -677,7 +687,7 @@ <p>Click the link.</p> <p>You will be directed to page2.jsp.</p> </div> -<a name="N10208"></a><a name="To+Shutdown+the+Tomcat+Server-N101FA"></a> +<a name="N10222"></a><a name="To+Shutdown+the+Tomcat+Server-N10211"></a> <h4>To Shutdown the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: @@ -686,10 +696,10 @@ </div> </div> -<a name="N10218"></a><a name="step_4"></a> +<a name="N10232"></a><a name="step_4"></a> <h3>Step 4: Submitting Data</h3> <div style="margin-left: 0 ; border: 2px"> -<a name="N1021E"></a><a name="To+Create+a+Submission+Form"></a> +<a name="N10238"></a><a name="To+Create+a+Submission+Form"></a> <h4>To Create a Submission Form</h4> <div style="margin-left: 0 ; border: 2px"> <p>Edit the file <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial/page2.jsp</span> so it appears as follows.</p> @@ -715,7 +725,7 @@ </netui:html></pre> <p>Save and close <span class="codefrag">page2.jsp</span>.</p> </div> -<a name="N10236"></a><a name="To+Edit+the+Controller+File+to+Handle+the+Submitted+Data"></a> +<a name="N10250"></a><a name="To+Edit+the+Controller+File+to+Handle+the+Submitted+Data"></a> <h4>To Edit the Controller File to Handle the Submitted Data</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open the file <span class="codefrag">CATALINA_HOME/webapps/pageflow_tutorial/Controller.jpf</span> @@ -792,19 +802,19 @@ </pre> <p>Save and close <span class="codefrag">Controller.jpf</span>.</p> </div> -<a name="N10254"></a><a name="To+Compile+the+Page+Flow-N10243"></a> +<a name="N1026E"></a><a name="To+Compile+the+Page+Flow-N1025A"></a> <h4>To Compile the Page Flow</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter:</p> <pre class="code">ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml build.webapp -Dwebapp.dir=%CATALINA_HOME%\webapps\pageflow_tutorial</pre> </div> -<a name="N10263"></a><a name="To+Start+the+Tomcat+Server-N10251"></a> +<a name="N1027D"></a><a name="To+Start+the+Tomcat+Server-N10268"></a> <h4>To Start the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: </p> <pre class="code">%CATALINA_HOME%\bin\startup.bat</pre> </div> -<a name="N10272"></a><a name="To+Test+the+Page+Flow+Web+Application-N1025F"></a> +<a name="N1028C"></a><a name="To+Test+the+Page+Flow+Web+Application-N10276"></a> <h4>To Test the Page Flow Web Application</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open a web browser and enter the following in the address bar: @@ -816,7 +826,7 @@ <p>Enter values in the Name and Age fields, and click Submit.</p> <p>Notice the name and age values you entered are displayed in the Tomcat console shell.</p> </div> -<a name="N10290"></a><a name="To+Shutdown+the+Tomcat+Server-N1027C"></a> +<a name="N102AA"></a><a name="To+Shutdown+the+Tomcat+Server-N10293"></a> <h4>To Shutdown the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: @@ -825,10 +835,10 @@ </div> </div> -<a name="N102A0"></a><a name="step_5"></a> +<a name="N102BA"></a><a name="step_5"></a> <h3>Step 5: Processing and Displaying Data</h3> <div style="margin-left: 0 ; border: 2px"> -<a name="N102A6"></a><a name="To+Process+the+Submitted+Data"></a> +<a name="N102C0"></a><a name="To+Process+the+Submitted+Data"></a> <h4>To Process the Submitted Data</h4> <div style="margin-left: 0 ; border: 2px"> <p>Edit the processData method in the Controller.jpf file so it appears as follows. Code to add appears in red.</p> @@ -845,7 +855,7 @@ return new Forward("success"); }</pre> </div> -<a name="N102B5"></a><a name="To+Create+a+JSP+Page+to+Display+Submitted+Data"></a> +<a name="N102CF"></a><a name="To+Create+a+JSP+Page+to+Display+Submitted+Data"></a> <h4>To Create a JSP Page to Display Submitted Data</h4> <div style="margin-left: 0 ; border: 2px"> <p>Create a file named <span class="codefrag">displayData.jsp</span> in the directory CATALINA_HOME/pageflow_tutorial. Edit <span class="codefrag">displayData.jsp</span> so it appears as follows.</p> @@ -862,19 +872,19 @@ </netui:body> </netui:html></pre> </div> -<a name="N102CA"></a><a name="To+Compile+the+Page+Flow-N102B3"></a> +<a name="N102E4"></a><a name="To+Compile+the+Page+Flow-N102CA"></a> <h4>To Compile the Page Flow</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter:</p> <pre class="code">ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml build.webapp -Dwebapp.dir=%CATALINA_HOME%\webapps\pageflow_tutorial</pre> </div> -<a name="N102D9"></a><a name="To+Start+the+Tomcat+Server-N102C1"></a> +<a name="N102F3"></a><a name="To+Start+the+Tomcat+Server-N102D8"></a> <h4>To Start the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: </p> <pre class="code">%CATALINA_HOME%\bin\startup.bat</pre> </div> -<a name="N102E8"></a><a name="To+Test+the+Page+Flow+Web+Application-N102CF"></a> +<a name="N10302"></a><a name="To+Test+the+Page+Flow+Web+Application-N102E6"></a> <h4>To Test the Page Flow Web Application</h4> <div style="margin-left: 0 ; border: 2px"> <p>Open a web browser and enter the following in the address bar: @@ -886,7 +896,7 @@ <p>Enter values in the Name and Age fields. Click the Submit button.</p> <p>You will be forwarded to the showData.jsp page. Notice the values you entered are displayed.</p> </div> -<a name="N10306"></a><a name="To+Shutdown+the+Tomcat+Server-N102EC"></a> +<a name="N10320"></a><a name="To+Shutdown+the+Tomcat+Server-N10303"></a> <h4>To Shutdown the Tomcat Server</h4> <div style="margin-left: 0 ; border: 2px"> <p>At the command prompt, enter: @@ -895,7 +905,7 @@ </div> </div> -<a name="N10316"></a><a name="summary"></a> +<a name="N10330"></a><a name="summary"></a> <h3>Summary: Page Flow Tutorial</h3> <div style="margin-left: 0 ; border: 2px"> <p>This tutorial introduced you to the basics of building web applications with Beehive Page Flows.</p> Modified: incubator/beehive/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml ============================================================================== --- incubator/beehive/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml (original) +++ incubator/beehive/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml Thu Nov 4 15:12:18 2004 @@ -84,9 +84,25 @@ </p> </section> <section> + <title>To Copy the Page Flow Application Template</title> + <p>In this step you will assemble the runtime resources for your Page Flow application. These resourses consist of runtime JARs, the <netui> tag library, and deployment configuration files. All of these resources are contained in the Page Flow application template located at<code>BEEHIVE_HOME/samples/netui-blank</code>.</p> + <p>In the directory <code>CATALINA_HOME/webapps</code>, create a directory named <code>pageflow_tutorial</code>.</p> + <p>Copy the folders</p> + <source>BEEHIVE_HOME/samples/netui-blank/resources</source> + <source>BEEHIVE_HOME/samples/netui-blank/WEB-INF</source> + <p>into</p> + <source>CATALINA_HOME/webapps/pageflow_tutorial</source> + <p>You should *not* copy Controller.jpf, index.jsp, and error.jsp. For the sake of instruction, you will create these files by hand.</p> + <p>Before proceeding, confirm that the following directory structure exists:</p> +<source>CATALINA_HOME + webapps + pageflow_tutorial + resources + WEB-INF</source> + </section> + <section> <title>To Create a Controller File</title> <p>In this step you will create the Controller file in place in the Tomcat deployment directory.</p> - <p>In the directory <code>CATALINA_HOME/webapps</code>, create a directory named <code>pageflow_tutorial</code>.</p> <p>In the directory <code>CATALINA_HOME/webapps/pageflow_tutorial</code>, create a file named <code>Controller.jpf</code>.</p> <p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p> <p>Edit <code>Controller.jpf</code> so it appears as follows.</p> @@ -126,12 +142,6 @@ </p> </netui:body> </netui:html>]]></source> - </section> - <section> - <title>To Add Beehive Runtime JARs to Your Web Application.</title> - <p>In this step you will assemble the runtime resources for your Page Flow application. Most of these files are included in the WEB-INF directory. It includes JAR files with the JSP tag handler classes, Struts config files, etc. <!--[tbd: for a complete list see...]--></p> - <p>Using the command shell opened in the previous step, at the command prompt, enter: </p> - <source>ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml deploy.beehive.webapp.runtime -Dwebapp.dir=%CATALINA_HOME%\webapps\pageflow_tutorial</source> </section> <section> <title>To Compile the Page Flow</title>
