Author: steveh
Date: Thu Oct 14 10:00:30 2004
New Revision: 54789
Modified:
incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
Log:
Control tutorial posting.
Modified:
incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
(original)
+++ incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
Thu Oct 14 10:00:30 2004
@@ -133,9 +133,6 @@
<a href="../pageflow/tutorial_pageflow.html">Page Flow Tutorial</a>
</li>
-<li>
-<a href="../pageflow/guide.html">Page Flow Programming</a>
-</li>
</ul>
</li>
@@ -159,9 +156,6 @@
<font color="#CFDCED">Web Services</font>
<ul>
-<li>
-<a href="../wsm/tutorial_wsm.html">Web Services Tutorial</a>
-</li>
<li>
<a href="../webservices.html">Web Services (JSR 181)</a>
@@ -170,16 +164,6 @@
</ul>
</li>
-<li>
-<font color="#CFDCED">Samples</font>
-<ul>
-
-<li>
-<a href="../jpetstore.html">JPetStore Samples</a>
-</li>
-
-</ul>
-</li>
<li>
<a href="../reference.html">Reference Docs</a>
@@ -255,7 +239,9 @@
<li>
<a href="#step1">Step 1: Begin the Controls Tutorial</a>
<ul class="minitoc">
-<li></li>
+<li>
+<a href="#Note+on+the+current+state+of+the+Controls+tutorial">Note on the
current state of the Controls tutorial</a>
+</li>
<li>
<a href="#Download+and+Install+JDK5">Download and Install JDK5</a>
</li>
@@ -266,11 +252,14 @@
<a href="#Download+and+Install+Beehive">Download and Install Beehive</a>
</li>
<li>
-<a href="#Install+ANT">Install ANT</a>
+<a href="#Install+ANT+">Install ANT</a>
</li>
<li>
<a href="#Run+the+">Run the bootstrap Target</a>
</li>
+<li>
+<a href="#Compile+Beehive">Compile Beehive</a>
+</li>
</ul>
</li>
<li>
@@ -289,10 +278,10 @@
<a href="#To+Create+the+WEB-INF+directory">To Create the WEB-INF directory</a>
</li>
<li>
-<a href="#Compile+the+Control">Compile the Control</a>
+<a href="#Edit+a+JSP+Page+to+Test+the+Control">Edit a JSP Page to Test the
Control</a>
</li>
<li>
-<a href="#Create+a+JSP+Page+to+Test+the+Control">Create a JSP Page to Test the
Control</a>
+<a href="#Compile+the+Control">Compile the Control</a>
</li>
<li>
<a href="#To+Start+the+Tomcat+Server">To Start the Tomcat Server</a>
@@ -302,81 +291,6 @@
</li>
</ul>
</li>
-<li>
-<a href="#step_3">Step 3: Navigation</a>
-<ul class="minitoc">
-<li>
-<a href="#Create+a+Destination+JSP+Page">Create a Destination JSP Page</a>
-</li>
-<li>
-<a href="#Create+a+Link+to+the+Destination+Page">Create a Link to the
Destination Page</a>
-</li>
-<li>
-<a href="#Add+an+Action+Method+to+Handle+the+Link">Add an Action Method to
Handle the Link</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N1020F">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application">To Test the Page Flow Web
Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server">Shutdown Tomcat Server</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_4">Step 4: Submitting Data</a>
-<ul class="minitoc">
-<li>
-<a href="#To+Create+a+Submission+Form">To Create a Submission Form</a>
-</li>
-<li>
-<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="#Compile+the+Page+Flow-N10274">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N1029C">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N102B2">To Test the Page Flow
Web Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server-N102C8">Shutdown Tomcat Server</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_5">Step 5: Processing and Displaying Data</a>
-<ul class="minitoc">
-<li>
-<a href="#To+Process+the+Submitted+Data">To Process the Submitted Data</a>
-</li>
-<li>
-<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="#Compile+the+Page+Flow-N102F8">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N10320">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N10336">To Test the Page Flow
Web Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server-N1034C">Shutdown Tomcat Server</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#summary">Summary: Page Flow Tutorial</a>
-</li>
</ul>
<a name="N1000C"></a><a name="intro"></a>
@@ -407,21 +321,25 @@
<a name="N10032"></a><a name="step1"></a>
<h3>Step 1: Begin the Controls Tutorial</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10038"></a>
-<h4></h4>
-<div style="margin-left: 0 ; border: 2px"></div>
-<a name="N1003E"></a><a name="Download+and+Install+JDK5"></a>
+<a name="N10038"></a><a
name="Note+on+the+current+state+of+the+Controls+tutorial"></a>
+<h4>Note on the current state of the Controls tutorial</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The Control Tutorial is a work in progress. Please email comments to Steve
Hanson at <span class="codefrag">steveh at bea.com</span>.</p>
+</div>
+<a name="N10045"></a><a name="Download+and+Install+JDK5"></a>
<h4>Download and Install JDK5</h4>
<div style="margin-left: 0 ; border: 2px">
<p>If you do not have JDK5 installed on your machine, visit <a target="_blank"
href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>
and download the latest version of JDK5.</p>
-<p>[tbd]</p>
+<p>
+<!--[tbd: better instructions]-->
+</p>
</div>
-<a name="N1004F"></a><a
name="Download+and+Install+SVN+%28Subversion+Source+Control%29"></a>
+<a name="N10056"></a><a
name="Download+and+Install+SVN+%28Subversion+Source+Control%29"></a>
<h4>Download and Install SVN (Subversion Source Control)</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>Visit <a target="_blank"
href="http://subversion.tigris.org";>http://subversion.tigris.org</a> and
install the SVN source control system.[tbd]</p>
+<p>Visit <a target="_blank"
href="http://subversion.tigris.org";>http://subversion.tigris.org</a> and
install the SVN source control system.<!--[tbd]--></p>
</div>
-<a name="N1005D"></a><a name="Download+and+Install+Beehive"></a>
+<a name="N10065"></a><a name="Download+and+Install+Beehive"></a>
<h4>Download and Install Beehive</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -438,14 +356,14 @@
</p>
</div>
-<a name="N10085"></a><a name="Install+ANT"></a>
-<h4>Install ANT</h4>
+<a name="N1008D"></a><a name="Install+ANT+"></a>
+<h4>Install ANT </h4>
<div style="margin-left: 0 ; border: 2px">
<p>Create a directory named <span class="codefrag">installed</span>at <span
class="codefrag">C:/beehive-src/trunk/installed</span>.</p>
<p>Unzip the file <span
class="codefrag">C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip</span>
into <span class="codefrag">C:/beehive-src/Beehive/installed</span>.</p>
<p>After the file has unzipped, confirm that the following directory structure
exists: <span
class="codefrag">C:/beehive-src/trunk/installed/apache-ant-1.6.2</span>.</p>
</div>
-<a name="N100A4"></a><a name="Run+the+"></a>
+<a name="N100AC"></a><a name="Run+the+"></a>
<h4>Run the bootstrap Target</h4>
<div style="margin-left: 0 ; border: 2px">
<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
@@ -463,23 +381,26 @@
<p>At the command prompt, enter: <span class="codefrag">ant bootstrap</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">exit</span>
+</div>
+<a name="N100D4"></a><a name="Compile+Beehive"></a>
+<h4>Compile Beehive</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>At the command prompt, enter: <span class="codefrag">ant deploy</span>
</p>
+<p>Leave this command shell open so you can use it throughout the tutorial.</p>
</div>
</div>
-<a name="N100D3"></a><a name="step_2"></a>
+<a name="N100E5"></a><a name="step_2"></a>
<h3>Step 2: Create Control Implementation and Interface Files</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100D9"></a><a name="Introduction"></a>
+<a name="N100EB"></a><a name="Introduction"></a>
<h4>Introduction</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
- [tbd]
- </p>
+<p>[tbd]</p>
</div>
-<a name="N100E3"></a><a name="To+Create+a+Control%27s+Implementation+File"></a>
+<a name="N100F5"></a><a name="To+Create+a+Control%27s+Implementation+File"></a>
<h4>To Create a Control's Implementation File</h4>
<div style="margin-left: 0 ; border: 2px">
<p>In this step you will create the implementation file for your Beehive
Control. This is a JAVA file, that contains the bulk of your Control's working
code.</p>
@@ -503,10 +424,10 @@
}
</pre>
</div>
-<a name="N10113"></a><a name="To+Create+the+Control%27s+Interface+File"></a>
+<a name="N10125"></a><a name="To+Create+the+Control%27s+Interface+File"></a>
<h4>To Create the Control's Interface File</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>The interface file is a JAVA file, that defines the public face of your
control. [tbd]</p>
+<p>The interface file is a JAVA file, that defines the public face of your
control. <!--[tbd]--></p>
<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</span>,
create a file named <span class="codefrag">Hello.java</span>.</p>
<p>Edit index.jsp so it looks like the following.</p>
<pre class="code">
@@ -521,45 +442,22 @@
}
</pre>
</div>
-<a name="N1012E"></a><a name="To+Create+the+WEB-INF+directory"></a>
+<a name="N10141"></a><a name="To+Create+the+WEB-INF+directory"></a>
<h4>To Create the WEB-INF directory</h4>
<div style="margin-left: 0 ; border: 2px">
-<p> Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\netui\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f
webappTemplate.xml
-Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
-
-</p>
-</div>
-<a name="N10156"></a><a name="Compile+the+Control"></a>
-<h4>Compile the Control</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
+<p>At the command prompt, enter: <span class="codefrag">ant -f
C:\beehive-src\trunk\netui\ant\webappTemplate.xml
-Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
</p>
</div>
-<a name="N10169"></a><a name="Create+a+JSP+Page+to+Test+the+Control"></a>
-<h4>Create a JSP Page to Test the Control</h4>
+<a name="N1014E"></a><a name="Edit+a+JSP+Page+to+Test+the+Control"></a>
+<h4>Edit a JSP Page to Test the Control</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To test your Beehive Control, you need to call the control from some other
resource, such as a JAVA application, JSP page, or Page Flow web application.
In this step you will call the
control from a JSP page.
</p>
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</span>,
create a file named <span class="codefrag">HelloPage.jsp</span>.
+<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</span>,
edit the file named <span class="codefrag">index.jsp</span>.
</p>
-<p>HelloPage.jsp so it appears as follows.</p>
+<p>Edit index.jsp so it appears as follows.</p>
<pre class="code">
<%@ page language="java" contentType="text/html;charset=UTF-8"%>
<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
@@ -572,61 +470,59 @@
</head>
<netui:body>
<p>
- <jsp:useBean class="hellocontrol.Hello" id="helloBean"
scope="session"/>
- <jsp:getProperty name="helloBean" property="hello"/>
+ <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
+ <%= helloBean.hello() %>
</p>
</netui:body>
</netui:html>
- </pre>
+ </pre>
</div>
-<a name="N10184"></a><a name="To+Start+the+Tomcat+Server"></a>
-<h4>To Start the Tomcat Server</h4>
+<a name="N10169"></a><a name="Compile+the+Control"></a>
+<h4>Compile the Control</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
+<p>At the command prompt, enter: <span class="codefrag">ant -f
C:\beehive-src\trunk\test\ant\buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
+</div>
+<a name="N10176"></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: <span
class="codefrag">C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</span>
</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
</div>
-<a name="N1019A"></a><a name="To+Test+the+Control"></a>
+<a name="N10183"></a><a name="To+Test+the+Control"></a>
<h4>To Test the Control</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/control_tutorial</span>
+<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/control_tutorial/index.jsp</span>
</p>
<p>You will be directed to the index.jsp page.</p>
+<p>Note the message on the page: "Hello, World!"</p>
+<p>This message is provided by the Hello control.</p>
</div>
</div>
-
-<a name="N101AB"></a><a name="step_3"></a>
-<h3>Step 3: Navigation</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N101B1"></a><a name="Create+a+Destination+JSP+Page"></a>
-<h4>Create a Destination JSP Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</span>,
create a file named <span class="codefrag">page2.jsp</span>.</p>
-<p>Edit page2.jsp so it looks like the following.</p>
-<pre class="code">
-
-</pre>
-</div>
-<a name="N101C9"></a><a name="Create+a+Link+to+the+Destination+Page"></a>
-<h4>Create a Link to the Destination Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/index.jsp.</p>
-<p>Edit index.jsp so it appears as follows.</p>
-<pre class="code">
-
-</pre>
-</div>
-<a name="N101DB"></a><a name="Add+an+Action+Method+to+Handle+the+Link"></a>
-<h4>Add an Action Method to Handle the Link</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf.</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
+ <!--<section id="step_3">
+ <title>Step 3: Navigation</title>
+ <section>
+ <title>Create a Destination JSP Page</title>
+ <p>In the directory
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>,
create a file named <code>page2.jsp</code>.</p>
+ <p>Edit page2.jsp so it looks like the following.</p>
+ <source><![CDATA[
+ ]]></source>
+ </section>
+ <section>
+ <title>Create a Link to the Destination Page</title>
+ <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/index.jsp.</p>
+ <p>Edit index.jsp so it appears as follows.</p>
+ <source><![CDATA[
+ ]]></source>
+ </section>
+ <section>
+ <title>Add an Action Method to Handle the Link</title>
+ <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf.</p>
+ <p>Edit Controller.jpf so it appears as follows.</p>
+ <source><![CDATA[
import org.apache.beehive.netui.pageflow.Forward;
import org.apache.beehive.netui.pageflow.PageFlowController;
import org.apache.beehive.netui.pageflow.annotations.Jpf;
@@ -654,98 +550,80 @@
return new Forward("success");
}
}
- </pre>
-</div>
-<a name="N101ED"></a><a name="Compile+the+Page+Flow"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
-
-</p>
-</div>
-<a name="N10215"></a><a name="To+Start+the+Tomcat+Server-N1020F"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N1022B"></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: <span
class="codefrag">http://localhost:8080/control_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N10241"></a><a name="Shutdown+Tomcat+Server"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N1024F"></a><a name="step_4"></a>
-<h3>Step 4: Submitting Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10255"></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">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/page2.jsp</span>
so it appears as follows.</p>
-<pre class="code">
-<%@ 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>page2.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
+ ]]></source>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Open a command shell.</p>
+ <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
+ </p>
+ <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
+ </p>
+ <p>At the command prompt, enter: <code>startup.bat</code>
+ </p>
+ <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
+ </section>
+ <section>
+ <title>To Test the Page Flow Web Application</title>
+ <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
+ </p>
+ <p>You will be directed to the index.jsp page.</p>
+ <p>Click the link.</p>
+ <p>You will be directed to page2.jsp.</p>
+ </section>
+ <section>
+ <title>Shutdown Tomcat Server</title>
+ <p>At the command prompt, enter: <code>shutdown.bat</code>
+ </p>
+ </section>
+ </section>
+ <section id="step_4">
+ <title>Step 4: Submitting Data</title>
+ <section>
+ <title>To Create a Submission Form</title>
+ <p>Edit the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/page2.jsp</code>
so it appears as follows.</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>page2.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
Welcome to page2.jsp!
- </p>
- <p>
- <netui:form action="processData">
- <p>Name:<netui:textBox dataSource="actionForm.name"/>
- <p>Age:<netui:textBox dataSource="actionForm.age"/>
- <p><netui:button type="submit">Submit</netui:button>
- </netui:form>
- </p>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N10267"></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">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf</span>
-
-</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
+ </p>
+ <p>
+ <netui:form action="processData">
+ <p>Name:<netui:textBox dataSource="actionForm.name"/>
+ <p>Age:<netui:textBox dataSource="actionForm.age"/>
+ <p><netui:button type="submit">Submit</netui:button>
+ </netui:form>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></source>
+ </section>
+ <section>
+ <title>To Edit the Controller File to Handle the Submitted
Data</title>
+ <p>Open the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf</code>
+ </p>
+ <p>Edit Controller.jpf so it appears as follows.</p>
+ <source><![CDATA[
import org.apache.beehive.netui.pageflow.Forward;
import org.apache.beehive.netui.pageflow.PageFlowController;
import org.apache.beehive.netui.pageflow.annotations.Jpf;
@@ -812,66 +690,50 @@
}
}
}
- </pre>
-</div>
-<a name="N1027C"></a><a name="Compile+the+Page+Flow-N10274"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
-
-</p>
-</div>
-<a name="N102A4"></a><a name="To+Start+the+Tomcat+Server-N1029C"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N102BA"></a><a
name="To+Test+the+Page+Flow+Web+Application-N102B2"></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: <span
class="codefrag">http://localhost:8080/control_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N102D0"></a><a name="Shutdown+Tomcat+Server-N102C8"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N102DE"></a><a name="step_5"></a>
-<h3>Step 5: Processing and Displaying Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N102E4"></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>
-<pre class="code">
+ ]]></source>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Open a command shell.</p>
+ <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
+ </p>
+ <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
+ </p>
+ <p>At the command prompt, enter: <code>startup.bat</code>
+ </p>
+ <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
+ </section>
+ <section>
+ <title>To Test the Page Flow Web Application</title>
+ <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
+ </p>
+ <p>You will be directed to the index.jsp page.</p>
+ <p>Click the link.</p>
+ <p>You will be directed to page2.jsp.</p>
+ </section>
+ <section>
+ <title>Shutdown Tomcat Server</title>
+ <p>At the command prompt, enter: <code>shutdown.bat</code>
+ </p>
+ </section>
+ </section>
+ <section id="step_5">
+ <title>Step 5: Processing and Displaying Data</title>
+ <section>
+ <title>To Process the Submitted Data</title>
+ <p>Edit the processData method in the Controller.jpf file so
it appears as follows. Code to add appears in red.</p>
+ <source><![CDATA[
@Jpf.Action(
forwards = {
@Jpf.Forward( name = "success", path = "showData.jsp" )
@@ -884,96 +746,75 @@
getRequest().setAttribute("data", form);
return new Forward("success");
}
- </pre>
-</div>
-<a name="N102F3"></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 displayData.jsp in the directory
[TOMCAT_HOME]/directory/control_tutorial. Edit showData.jsp so it appears as
follows.</p>
-<pre class="code">
-<%@ 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>showData.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>Name:<netui:span value="${requestScope.data.name}"/>
- <p>Age:<netui:span value="${requestScope.data.age}"/>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N10302"></a><a name="Compile+the+Page+Flow-N102F8"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</span>
-
-</p>
-</div>
-<a name="N1032A"></a><a name="To+Start+the+Tomcat+Server-N10320"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N10340"></a><a
name="To+Test+the+Page+Flow+Web+Application-N10336"></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: <span
class="codefrag">http://localhost:8080/control_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N10356"></a><a name="Shutdown+Tomcat+Server-N1034C"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N10364"></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>
-<p>Concepts and Tasks Introduced in This Tutorial</p>
-<ul>
-
-<li>JSP files make up the presentation layer of a web application</li>
-
-<li>JPF files contain the code, individual Action methods, that determines the
major features of a Workshop web application: how users navigate from page to
page, and how data moves around the application.</li>
-
-<li>User input data is data bound to Form Beans before the data is submitted
to an Action method.</li>
-
-<li>You can use the <netui...> tag library to data bind to Java objects
and render them as HTML</li>
-
-</ul>
-</div>
+ ]]></source>
+ </section>
+ <section>
+ <title>To Create a JSP Page to Display Submitted Data</title>
+ <p>Create a file named displayData.jsp in the directory
[TOMCAT_HOME]/directory/control_tutorial. Edit showData.jsp so it appears as
follows.</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>showData.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>Name:<netui:span value="${requestScope.data.name}"/>
+ <p>Age:<netui:span value="${requestScope.data.age}"/>
+ </netui:body>
+</netui:html>
+ ]]></source>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Open a command shell.</p>
+ <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
+ </p>
+ <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
+ </p>
+ <p>At the command prompt, enter: <code>startup.bat</code>
+ </p>
+ <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
+ </section>
+ <section>
+ <title>To Test the Page Flow Web Application</title>
+ <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
+ </p>
+ <p>You will be directed to the index.jsp page.</p>
+ <p>Click the link.</p>
+ <p>You will be directed to page2.jsp.</p>
+ </section>
+ <section>
+ <title>Shutdown Tomcat Server</title>
+ <p>At the command prompt, enter: <code>shutdown.bat</code>
+ </p>
+ </section>
+ </section>
+ <section id="summary">
+ <title>Summary: Page Flow Tutorial</title>
+ <p>This tutorial introduced you to the basics of building web
applications with Beehive Page Flows.</p>
+ <p>Concepts and Tasks Introduced in This Tutorial</p>
+ <ul>
+ <li>JSP files make up the presentation layer of a web
application</li>
+ <li>JPF files contain the code, individual Action methods,
that determines the major features of a Workshop web application: how users
navigate from page to page, and how data moves around the application.</li>
+ <li>User input data is data bound to Form Beans before the
data is submitted to an Action method.</li>
+ <li>You can use the <netui...> tag library to data bind to
Java objects and render them as HTML</li>
+ </ul>
+ </section>-->
<div class="attribution"></div>
</div>
