Author: steveh Date: Tue Oct 12 11:51:28 2004 New Revision: 54686 Modified: incubator/beehive/trunk/site/src/documentation/content/xdocs/controls/tutorial_controls.xml incubator/beehive/trunk/site/src/documentation/content/xdocs/reference.xml incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml Log: Fixing broken links.
Modified: incubator/beehive/trunk/site/src/documentation/content/xdocs/controls/tutorial_controls.xml ============================================================================== --- incubator/beehive/trunk/site/src/documentation/content/xdocs/controls/tutorial_controls.xml (original) +++ incubator/beehive/trunk/site/src/documentation/content/xdocs/controls/tutorial_controls.xml Tue Oct 12 11:51:28 2004 @@ -1,90 +1,91 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "http://forrest.apache.org/dtd/document-v13.dtd";> <document> - <header> - <title>Beehive Controls Tutorial</title> - </header> - <body> - <section id="intro"> - <title>Introduction</title> - <section> - <title>Tutorial Goals</title> - <p>In this tutorial, you will learn:</p> - <ul> - <li>What Beehive Controls are for and what they do</li> - <li>How to create a Beehive Control interface and implementation</li> - <li>How to compile a Beehive Control</li> - <li>How to use a Beehive Control as a component in a larger application</li> - <li>How to use metadata annotations in Beehive Controls</li> - <li>How to create custom metadata annotations</li> - </ul> - </section> - </section> - <section id="step1"> - <title>Step 1: Begin the Controls Tutorial</title> - <section> - <title/> - </section> - <section> - <title>Download and Install JDK5</title> - <p>If you do not have JDK5 installed on your machine, visit <fork href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</fork> and download the latest version of JDK5.</p> - <p>[tbd]</p> - </section> - <section> - <title>Download and Install SVN (Subversion Source Control)</title> - <p>Visit <fork href="http://subversion.tigris.org";>http://subversion.tigris.org</fork> and install the SVN source control system.[tbd]</p> - </section> - <section> - <title>Download and Install Beehive</title> - <p> + <header> + <title>Beehive Controls Tutorial</title> + </header> + <body> + <section id="intro"> + <title>Introduction</title> + <section> + <title>Tutorial Goals</title> + <p>In this tutorial, you will learn:</p> + <ul> + <li>What Beehive Controls are for and what they do</li> + <li>How to create a Beehive Control interface and implementation</li> + <li>How to compile a Beehive Control</li> + <li>How to use a Beehive Control as a component in a larger application</li> + <li>How to use metadata annotations in Beehive Controls</li> + <li>How to create custom metadata annotations</li> + </ul> + </section> + </section> + <section id="step1"> + <title>Step 1: Begin the Controls Tutorial</title> + <section> + <title/> + </section> + <section> + <title>Download and Install JDK5</title> + <p>If you do not have JDK5 installed on your machine, visit <fork href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</fork> and download the latest version of JDK5.</p> + <p>[tbd]</p> + </section> + <section> + <title>Download and Install SVN (Subversion Source Control)</title> + <p>Visit <fork href="http://subversion.tigris.org";>http://subversion.tigris.org</fork> and install the SVN source control system.[tbd]</p> + </section> + <section> + <title>Download and Install Beehive</title> + <p> Create a directory called <code>beehive-src</code> on your C: drive. Confirm that the the following directory structure exists: <code>C:/beehive-src</code>. This directory will store the Beehive source and all of your Beehive projects. </p> - <p>Open a command shell.</p> - <p>At the command prompt, enter: <code>cd beehive-src</code> - </p> - <p>At the command prompt, enter: <code>svn checkout http://svn.apache.org/repos/asf/incubator/beehive/trunk/</code> - </p> - <p>Wait a few minutes while the Beehive source is downloaded to your local machine.</p> - <p>At the command prompt, enter: <code>exit</code> - </p> - </section> - <section> - <title>Install ANT</title> - <p>Create a directory named <code>installed</code>at <code>C:/beehive-src/trunk/installed</code>.</p> - <p>Unzip the file <code>C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip</code> into <code>C:/beehive-src/Beehive/installed</code>.</p> - <p>After the file has unzipped, confirm that the following directory structure exists: <code>C:/beehive-src/trunk/installed/apache-ant-1.6.2</code>.</p> - </section> - <section> - <title>Run the <code>bootstrap</code> Target</title> - <p>At the command prompt, enter: <code>set JAVA_HOME=C:\jdk1.5.0</code> - </p> - <p>At the command prompt, enter: <code>set BEEHIVE_HOME=C:\beehive-src\trunk</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>ant bootstrap</code> - </p> - <p>At the command prompt, enter: <code>exit</code> - </p> - </section> - </section> - <section id="step_2"> - <title>Step 2: Create Control Implementation and Interface Files</title> - <section> - <title>Introduction</title> - <p> + <p>Open a command shell.</p> + <p>At the command prompt, enter: <code>cd beehive-src</code> + </p> + <p>At the command prompt, enter: <code>svn checkout http://svn.apache.org/repos/asf/incubator/beehive/trunk/</code> + </p> + <p>Wait a few minutes while the Beehive source is downloaded to your local machine.</p> + <p>At the command prompt, enter: <code>exit</code> + </p> + </section> + <section> + <title>Install ANT</title> + <p>Create a directory named <code>installed</code>at <code>C:/beehive-src/trunk/installed</code>.</p> + <p>Unzip the file <code>C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip</code> into <code>C:/beehive-src/Beehive/installed</code>.</p> + <p>After the file has unzipped, confirm that the following directory structure exists: <code>C:/beehive-src/trunk/installed/apache-ant-1.6.2</code>.</p> + </section> + <section> + <title>Run the <code>bootstrap</code> Target</title> + <p>At the command prompt, enter: <code>set JAVA_HOME=C:\jdk1.5.0</code> + </p> + <p>At the command prompt, enter: <code>set BEEHIVE_HOME=C:\beehive-src\trunk</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>ant bootstrap</code> + </p> + <p>At the command prompt, enter: <code>exit</code> + </p> + </section> + </section> + <section id="step_2"> + <title>Step 2: Create Control Implementation and Interface Files</title> + <section> + <title>Introduction</title> + <p> [tbd] </p> - </section> - <section> - <title>To Create a Control's Implementation File</title> - <p>In this step you will create the implementation file for your Beehive Control. This file is a JAVA file, that contains the bulk of your Control's working code.</p> - <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>control_tutorial</code>.</p> - <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a file called <code>HelloImpl.jcs</code>.</p> - <p>In a text editor (or your IDE of choice), open the file HelloImpl.jcs.</p> - <p>Edit HelloImpl.jcs so it appears as follows.</p> - <source><![CDATA[ + </section> + <section> + <title>To Create a Control's Implementation File</title> + <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> + <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>control_tutorial</code>.</p> + <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a directory called <code>hellocontrol</code>.</p> + <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/hellocontrol</code>, create a file called <code>HelloImpl.jcs</code>.</p> + <p>In a text editor (or your IDE of choice), open the file HelloImpl.jcs.</p> + <p>Edit HelloImpl.jcs so it appears as follows.</p> + <source><![CDATA[ package hellocontrol; import org.apache.beehive.controls.api.bean.*; @@ -98,13 +99,13 @@ } } ]]></source> - </section> - <section> - <title>To Create the Control's Interface File</title> - <p>The interface file is a JAVA file, that defines the public face of your control. [tbd]</p> - <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a file named <code>Hello.java</code>.</p> - <p>Edit index.jsp so it looks like the following.</p> - <source><![CDATA[ + </section> + <section> + <title>To Create the Control's Interface File</title> + <p>The interface file is a JAVA file, that defines the public face of your control. [tbd]</p> + <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a file named <code>Hello.java</code>.</p> + <p>Edit index.jsp so it looks like the following.</p> + <source><![CDATA[ package hellocontrol; import org.apache.beehive.controls.api.bean.ControlInterface; @@ -115,35 +116,37 @@ public String hello(); } ]]></source> - </section> - <section> - <title>To Create the WEB-INF directory</title> - <p> Open a command shell.</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\netui\ant</code> - </p> - <p>At the command prompt, enter: <code>ant -f webappTemplate.xml -Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code> - </p> - </section> - <section> - <title>Compile the Control</title> - <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>Create a JSP Page to Test the Control</title> - <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 + </section> + <section> + <title>To Create the WEB-INF directory</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\netui\ant</code> + </p> + <p>At the command prompt, enter: <code>ant -f webappTemplate.xml -Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code> + </p> + </section> + <section> + <title>Compile the Control</title> + <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>Create a JSP Page to Test the Control</title> + <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 <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a file named <code>HelloPage.jsp</code>. + <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>, create a file named <code>HelloPage.jsp</code>. </p> - <p>HelloPage.jsp so it appears as follows.</p> - <source><![CDATA[ + <p>HelloPage.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"%> @@ -161,43 +164,43 @@ </netui:body> </netui:html> ]]></source> - </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 Control</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> - </section> - </section> - <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[ + </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 Control</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> + </section> + </section> + <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[ + </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[ + </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; @@ -226,49 +229,49 @@ } } ]]></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[ + </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"%> @@ -292,13 +295,13 @@ </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[ + </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; @@ -366,49 +369,49 @@ } } ]]></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[ + </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" ) @@ -422,11 +425,11 @@ return new Forward("success"); } ]]></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[ + </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"%> @@ -442,58 +445,58 @@ </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> - </body> - <footer> - <legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.<br/> + </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> + </body> + <footer> + <legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.<br/> © 2004, Apache Software Foundation </legal> - </footer> + </footer> </document> Modified: incubator/beehive/trunk/site/src/documentation/content/xdocs/reference.xml ============================================================================== --- incubator/beehive/trunk/site/src/documentation/content/xdocs/reference.xml (original) +++ incubator/beehive/trunk/site/src/documentation/content/xdocs/reference.xml Tue Oct 12 11:51:28 2004 @@ -9,17 +9,14 @@ <li> <fork href="reference/taglib/index.html">Page Flow <netui> Tag Reference</fork> </li> - <!--<li><fork href="reference/taglib/index.html">Page Flow Annotations Reference</fork></li>--> <li> - <fork href="/reference/classref_pageflows/index.html">Page Flow API Reference</fork> + <fork href="reference/classref_pageflows/index.html">Page Flow API Reference</fork> </li> - <!--<li><fork href="/reference/classref_controls/index.html">Controls Annotations Reference</fork></li>--> <li> - <fork href="/reference/classref_controls/index.html">Controls API Reference</fork> + <fork href="reference/classref_controls/index.html">Controls API Reference</fork> </li> - <!--<li><fork href="/reference/classref_wsm/index.html">Web Services Metadata Annotations Reference</fork></li>--> <li> - <fork href="/reference/classref_wsm/index.html">Web Services Metadata API Reference</fork> + <fork href="reference/classref_wsm/index.html">Web Services Metadata API Reference</fork> </li> </ul> </body> Modified: incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml ============================================================================== --- incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml (original) +++ incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml Tue Oct 12 11:51:28 2004 @@ -7,8 +7,8 @@ <faq label="FAQ" href="faq.html"/> </about> <documentation label="Documentation"> - <pageflow label="Page Flows" href="/pageflow"> - <tutorial_pageflow label="Page Flow Tutorial" href="/tutorial_pageflow.html"/> + <pageflow label="Page Flows"> + <tutorial_pageflow label="Page Flow Tutorial" href="pageflow/tutorial_pageflow.html"/> </pageflow> <controls label="Controls"> <!--<tutorial_control label="Control Tutorial" href="/controls/tutorial_controls.html"/>-->
