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 2004/10/14 00:05:17 UTC
svn commit: rev 54754 - in incubator/beehive/trunk/site/src/documentation: content/xdocs content/xdocs/pageflow content/xdocs/wsm resources/images
Author: steveh
Date: Wed Oct 13 15:05:17 2004
New Revision: 54754
Added:
incubator/beehive/trunk/site/src/documentation/content/xdocs/building.xml (contents, props changed)
incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml (contents, props changed)
incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml (contents, props changed)
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml (contents, props changed)
incubator/beehive/trunk/site/src/documentation/resources/images/Thumbs.db (contents, props changed)
Modified:
incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml
incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml
Log:
Latest content for forrest site.
Added: incubator/beehive/trunk/site/src/documentation/content/xdocs/building.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/building.xml Wed Oct 13 15:05:17 2004
@@ -0,0 +1,522 @@
+<?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 Page Flow Tutorial</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction To the Page Flow Tutorial</title>
+ <section>
+ <title>Tutorial Goals</title>
+ <p>In this tutorial, you will learn:</p>
+ <ul>
+ <li>How to create a basic Page Flow web application</li>
+ <li>How to coordinate user navigation with Forward methods</li>
+ <li>How to handle data submission and processing with data binding and Form Beans</li>
+ <li>How to create a user interface with the <neuti> JSP tag library</li>
+ <li>How Page Flows help to separate data processing and data presentation</li>
+ </ul>
+ </section>
+ <section>
+ <title>Note on the Current State of the Page Flow Tutorial</title>
+ <p>This tutorial is currently a work in progress. Unfinished portions of the tutorial are marked [tbd], standing for "to be done". Also the tutorial assumes that you are using a Windows machine, however, with a little common sense it is very easy to run through the tutorial on a Linux machine. For example, where the tutorial tells you to run FOO.cmd, instead run FOO.sh.</p>
+ <p>Please send any comments to Steve Hanson, at <code>steveh@bea.com</code>.</p>
+ </section>
+ </section>
+ <section id="step1">
+ <title>Step 1: Begin the Page Flow 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>Throughout this tutorial, it is assumed that you have JDK 5 installed at <code>C:\jdk1.5.0</code></p>
+ <p>[tbd: more detailed installation instructions]</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.</p>
+ <p>[tbd: more detailed installation instructions]</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 a New Page Flow Application</title>
+ <section>
+ <title>Introduction</title>
+ <p>
+ In this step you will create a Controller file and a JSP page. A Controller file is a Java class (with the JPF file extension) that controls how your web application functions and what it does. The methods in the Controller file determines all of the major features of a web application: how users navigate from page to page, how user requests are handled, and how the web application accesses back-end resources.
+ </p>
+ <p>
+ Controller files control the features of a web application through the use of Action methods. An Action method may do something simple, such as forward a user from one JSP page to another; or it may do something complex, such as receive user input from a JSP page, calculate and/or retrieve other data based on the user input, and forward the user to a JSP page where the results are displayed.
+ </p>
+ <p>
+ 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>
+ </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>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>pageflow_tutorial</code>.</p>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file called <code>Controller.jpf</code>.</p>
+ <p>In a text editor (or your IDE of choice), open the file 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;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></source>
+ </section>
+ <section>
+ <title>To Create a JSP File</title>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file named <code>index.jsp</code>.</p>
+ <p>Edit index.jsp so it looks like the following.</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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>Compile the Page Flow</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\pageflow_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/pageflow_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/pageflow_tutorial</code>, create a file named <code>page2.jsp</code>.</p>
+ <p>Edit page2.jsp so it looks like the following.</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>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_tutorial/index.jsp.</p>
+ <p>Edit index.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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ <p>
+ <netui:anchor action="toPage2">Link to page2.jsp</netui:anchor>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_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;
+
+public class Controller
+ extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></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\pageflow_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/pageflow_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/pageflow_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>
+ ]]></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/pageflow_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;
+import org.apache.beehive.netui.pageflow.FormData;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ public Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards = {
+ @Jpf.Forward(name = "success", path = "showData.jsp")
+ }
+ )
+ public Forward processData(ProcessDataForm form)
+ {
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ return new Forward("success");
+ }
+
+ public static class ProcessDataForm extends FormData
+ {
+ private int age;
+ private String name;
+
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getName()
+ {
+ return this.name;
+ }
+
+ public void setAge(int age)
+ {
+ this.age = age;
+ }
+
+ public int getAge()
+ {
+ return this.age;
+ }
+ }
+}
+ ]]></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\pageflow_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/pageflow_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" )
+ }
+)
+public Forward processData( ProcessDataForm form )
+{
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ getRequest().setAttribute("data", form);
+ 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/pageflow_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\pageflow_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/pageflow_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>
+ <p>[tbd: more detailed summary]</p>
+ </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>
+</document>
Added: incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml Wed Oct 13 15:05:17 2004
@@ -0,0 +1,25 @@
+<?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>Apache Beehive Web Services</title>
+</header>
+
+<body>
+
+<p>
+See the <fork href="http://wiki.apache.org/beehive/Web_20Services">WSM on the Beehive wiki</fork> and the
+<fork href="http://jcp.org/en/jsr/detail?id=181">JSR 181 Spec</fork> for more information.
+</p>
+
+</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>
+
+</document>
\ No newline at end of file
Added: incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml Wed Oct 13 15:05:17 2004
@@ -0,0 +1,522 @@
+<?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 Page Flow Tutorial</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction To the Page Flow Tutorial</title>
+ <section>
+ <title>Tutorial Goals</title>
+ <p>In this tutorial, you will learn:</p>
+ <ul>
+ <li>How to create a basic Page Flow web application</li>
+ <li>How to coordinate user navigation with Forward methods</li>
+ <li>How to handle data submission and processing with data binding and Form Beans</li>
+ <li>How to create a user interface with the <neuti> JSP tag library</li>
+ <li>How Page Flows help to separate data processing and data presentation</li>
+ </ul>
+ </section>
+ <section>
+ <title>Note on the Current State of the Page Flow Tutorial</title>
+ <p>This tutorial is currently a work in progress. Unfinished portions of the tutorial are marked [tbd], standing for "to be done". Also the tutorial assumes that you are using a Windows machine, however, with a little common sense it is very easy to run through the tutorial on a Linux machine. For example, where the tutorial tells you to run FOO.cmd, instead run FOO.sh.</p>
+ <p>Please send any comments to Steve Hanson, at <code>steveh@bea.com</code>.</p>
+ </section>
+ </section>
+ <section id="step1">
+ <title>Step 1: Begin the Page Flow 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>Throughout this tutorial, it is assumed that you have JDK 5 installed at <code>C:\jdk1.5.0</code></p>
+ <p>[tbd: more detailed installation instructions]</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.</p>
+ <p>[tbd: more detailed installation instructions]</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 a New Page Flow Application</title>
+ <section>
+ <title>Introduction</title>
+ <p>
+ In this step you will create a Controller file and a JSP page. A Controller file is a Java class (with the JPF file extension) that controls how your web application functions and what it does. The methods in the Controller file determines all of the major features of a web application: how users navigate from page to page, how user requests are handled, and how the web application accesses back-end resources.
+ </p>
+ <p>
+ Controller files control the features of a web application through the use of Action methods. An Action method may do something simple, such as forward a user from one JSP page to another; or it may do something complex, such as receive user input from a JSP page, calculate and/or retrieve other data based on the user input, and forward the user to a JSP page where the results are displayed.
+ </p>
+ <p>
+ 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>
+ </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>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>pageflow_tutorial</code>.</p>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file called <code>Controller.jpf</code>.</p>
+ <p>In a text editor (or your IDE of choice), open the file 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;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></source>
+ </section>
+ <section>
+ <title>To Create a JSP File</title>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file named <code>index.jsp</code>.</p>
+ <p>Edit index.jsp so it looks like the following.</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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>Compile the Page Flow</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\pageflow_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/pageflow_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/pageflow_tutorial</code>, create a file named <code>page2.jsp</code>.</p>
+ <p>Edit page2.jsp so it looks like the following.</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>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_tutorial/index.jsp.</p>
+ <p>Edit index.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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ <p>
+ <netui:anchor action="toPage2">Link to page2.jsp</netui:anchor>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_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;
+
+public class Controller
+ extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></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\pageflow_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/pageflow_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/pageflow_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>
+ ]]></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/pageflow_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;
+import org.apache.beehive.netui.pageflow.FormData;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ public Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards = {
+ @Jpf.Forward(name = "success", path = "showData.jsp")
+ }
+ )
+ public Forward processData(ProcessDataForm form)
+ {
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ return new Forward("success");
+ }
+
+ public static class ProcessDataForm extends FormData
+ {
+ private int age;
+ private String name;
+
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getName()
+ {
+ return this.name;
+ }
+
+ public void setAge(int age)
+ {
+ this.age = age;
+ }
+
+ public int getAge()
+ {
+ return this.age;
+ }
+ }
+}
+ ]]></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\pageflow_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/pageflow_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" )
+ }
+)
+public Forward processData( ProcessDataForm form )
+{
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ getRequest().setAttribute("data", form);
+ 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/pageflow_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\pageflow_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/pageflow_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>
+ <p>[tbd: more detailed summary]</p>
+ </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>
+</document>
Modified: incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml
==============================================================================
--- incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml (original)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/tutorial_pageflow.xml Wed Oct 13 15:05:17 2004
@@ -1,104 +1,108 @@
<?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 Page Flow Tutorial</title>
- </header>
- <body>
- <section id="intro">
- <title>Introduction To the Page Flow Tutorial</title>
- <section>
- <title>Tutorial Goals</title>
- <p>In this tutorial, you will learn:</p>
- <ul>
- <li>How to create a basic Page Flow web application</li>
- <li>How to coordinate user navigation with Forward methods</li>
- <li>How to handle data submission and processing with data binding and Form Beans</li>
- <li>How to create a user interface with the <neuti> JSP tag library</li>
- <li>How Page Flows help to separate data processing and data presentation</li>
- </ul>
- </section>
- <section>
- <title>Note on the Current State of the Page Flow Tutorial</title>
- <p>This tutorial is currently a work in progress. Unfinished portions of the tutorial are marked [tbd], standing for "to be done". Also the tutorial assumes that you are using a Windows machine, however, with a little common sense it is very easy to run through the tutorial on a Linux machine. For example, where the tutorial tells you to run FOO.cmd, instead run FOO.sh.</p>
- <p>Please send any comments to Steve Hanson, at <code>steveh@bea.com</code>.</p>
- </section>
- </section>
- <section id="step1">
- <title>Step 1: Begin the Page Flow 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>Throughout this tutorial, it is assumed that you have JDK 5 installed at <code>C:\jdk1.5.0</code></p>
- <p>[tbd: more detailed installation instructions]</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.</p>
- <p>[tbd: more detailed installation instructions]</p>
- </section>
- <section>
- <title>Download and Install Beehive</title>
- <p>
+ <header>
+ <title>Beehive Page Flow Tutorial</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction To the Page Flow Tutorial</title>
+ <section>
+ <title>Tutorial Goals</title>
+ <p>In this tutorial, you will learn:</p>
+ <ul>
+ <li>How to create a basic Page Flow web application</li>
+ <li>How to coordinate user navigation with Forward methods</li>
+ <li>How to handle data submission and processing with data binding and Form Beans</li>
+ <li>How to create a user interface with the <neuti> JSP tag library</li>
+ <li>How Page Flows help to separate data processing and data presentation</li>
+ </ul>
+ </section>
+ <section>
+ <title>Note on the Current State of the Page Flow Tutorial</title>
+ <p>This tutorial is currently a work in progress. Please send any comments to Steve Hanson, at <code>steveh@bea.com</code>. Also the tutorial assumes that you are using a Windows machine, however, with a little common sense it is very easy to run through the tutorial on a Linux machine. For example, where the tutorial tells you to run FOO.cmd, instead run FOO.sh.</p>
+ </section>
+ </section>
+ <section id="step1">
+ <title>Step 1: Begin the Page Flow 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>Throughout this tutorial, it is assumed that you have JDK 5 installed at <code>C:\jdk1.5.0</code>
+ </p>
+ <p><!--[tbd: more detailed installation instructions]--></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.</p>
+ <p><!--[tbd: more detailed installation instructions]--></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>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>
+ </section>
+ <section>
+ <title>Compile Beehive</title>
+ <p>At the command prompt, enter: <code>ant deploy</code>
+ </p>
+ <p>Leave this command shell open so you can use it in the next step of the tutorial.</p>
+ </section>
+ </section>
+ <section id="step_2">
+ <title>Step 2: Create a New Page Flow Application</title>
+ <section>
+ <title>Introduction</title>
+ <p>
+ In this step you will create a Controller file and a JSP page. These are the basic files in a Page Flow web application. Each Page Flow contains one Controller file and any number of JSP pages. A Controller file is a Java class (with the JPF file extension) that controls how your web application functions and what it does. The methods in the Controller file determines all of the major features of a web application: how users navigate from page to page, how user requests are handled, and how the web application accesses back-end resources. The JSP pages determine what a visitor to the web sees in the browser. (In terms of the Model-View-Controller paradigm for web applications: the Controller file is the Controller (naturally), and the JSP pages are the View. The web application we are buildng in this tutorial does not contain a Model. <!--[tbd: more, explain]-->)
</p>
- <p>At the command prompt, enter: <code>svn checkout http://svn.apache.org/repos/asf/incubator/beehive/trunk/</code>
+ <p>
+ Controller files contain Action methods. An Action method may do something simple, such as forward a user from one JSP page to another; or it may do something complex, such as receive user input from a JSP page, calculate and/or retrieve other data based on the user input, and forward the user to a JSP page where the results are displayed. <!--[tbd: diagram, etc.]-->
</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 a New Page Flow Application</title>
- <section>
- <title>Introduction</title>
- <p>
- In this step you will create a Controller file and a JSP page. A Controller file is a Java class (with the JPF file extension) that controls how your web application functions and what it does. The methods in the Controller file determines all of the major features of a web application: how users navigate from page to page, how user requests are handled, and how the web application accesses back-end resources.
- </p>
- <p>
- Controller files control the features of a web application through the use of Action methods. An Action method may do something simple, such as forward a user from one JSP page to another; or it may do something complex, such as receive user input from a JSP page, calculate and/or retrieve other data based on the user input, and forward the user to a JSP page where the results are displayed.
- </p>
- <p>
+ <p>
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>
- </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>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>pageflow_tutorial</code>.</p>
- <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file called <code>Controller.jpf</code>.</p>
- <p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p>
- <p>Edit Controller.jpf so it appears as follows.</p>
- <source><![CDATA[
-import org.apache.beehive.netui.pageflow.Forward;
+ </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>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>pageflow_tutorial</code>.</p>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file called <code>Controller.jpf</code>.</p>
+ <p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p>
+ <p>Edit Controller.jpf so it appears as follows.</p>
+ <source><![CDATA[
import org.apache.beehive.netui.pageflow.PageFlowController;
+import org.apache.beehive.netui.pageflow.Forward;
import org.apache.beehive.netui.pageflow.annotations.Jpf;
@Jpf.Controller
@@ -115,16 +119,14 @@
}
}
]]></source>
- </section>
- <section>
- <title>To Create a JSP File</title>
- <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file named <code>index.jsp</code>.</p>
- <p>Edit index.jsp so it looks like the following.</p>
- <source><![CDATA[
+ </section>
+ <section>
+ <title>To Create a JSP File</title>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file named <code>index.jsp</code>.</p>
+ <p>Edit index.jsp so it looks like the following.</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>index.jsp</title>
@@ -137,52 +139,64 @@
</netui:body>
</netui:html>
]]></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\pageflow_tutorial</code>
- </p>
- </section>
- <section>
- <title>Compile the Page Flow</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\pageflow_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/pageflow_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/pageflow_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 Create the WEB-INF directory, etc.</title>
+ <p>In this step you will assemble the JARs and other supporting files 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></p>
+ <p>Using the command shell opened in the previous step, 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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>You are now ready to compile the Page Flow.</p>
+ <p>Using the command shell opened in the previous step, 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\pageflow_tutorial</code>
+ </p>
+ <p>You should see the following response in the command shell:</p>
+ <source>C:\beehive-src\trunk\test\ant>ant -f buildWebapp.xml build.webapp -Dwebapp.dir=C:\beehive-src\trunk\
+installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial
+Buildfile: buildWebapp.xml
+
+build.webapp:
+[xmlbeanbuild] Could not find any xsd or wsdl files to process.
+ [echo] ========== Complie Java source in WEB-INF/src ==========
+ [echo] netui-compiler.jar: C:\dev-apache\beehive\trunk/netui/build/lib/beehive-netui-compiler.j
+ar
+ [echo] controls.jar: C:\dev-apache\beehive\trunk/controls/build/jars/controls.jar
+ [echo] ========== Generate and compile controls ==========
+ [mkdir] Created dir: C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutor
+ial\WEB-INF\.tmpbeansrc
+ [echo] ========== Compile Page Flows ==========
+ [apt] Compiling 2 source files to C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps
+\pageflow_tutorial\WEB-INF\classes
+ [echo] Copy all .properties files
+ [echo] Copy all .xml files</source>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</code>
+ </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/pageflow_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/pageflow_tutorial</code>, create a file named <code>page2.jsp</code>.</p>
+ <p>Edit page2.jsp so it looks like the following.</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>
@@ -195,16 +209,14 @@
</netui:body>
</netui:html>
]]></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/pageflow_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/pageflow_tutorial/index.jsp.</p>
+ <p>Edit index.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>index.jsp</title>
@@ -220,12 +232,12 @@
</netui:body>
</netui:html>
]]></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/pageflow_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/pageflow_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;
@@ -254,53 +266,39 @@
}
}
]]></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\pageflow_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/pageflow_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/pageflow_tutorial/page2.jsp</code> so it appears as follows.</p>
- <source><![CDATA[
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Using the same command shell used in previous steps, at the command prompt, enter: <code>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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</code>
+ </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/pageflow_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>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.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/pageflow_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>
@@ -320,13 +318,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/pageflow_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/pageflow_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;
@@ -357,7 +355,7 @@
@Jpf.Action(
forwards = {
- @Jpf.Forward(name = "success", path = "showData.jsp")
+ @Jpf.Forward(name = "success", path = "page2.jsp")
}
)
public Forward processData(ProcessDataForm form)
@@ -394,49 +392,39 @@
}
}
]]></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\pageflow_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/pageflow_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>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\pageflow_tutorial</code>
+ </p>
+ <p></p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</code></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/pageflow_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>
+ <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>
+ </section>
+ <section>
+ <title>Shutdown Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\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" )
@@ -450,15 +438,13 @@
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/pageflow_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/pageflow_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>
@@ -470,53 +456,43 @@
</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\pageflow_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/pageflow_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>
- <p>[tbd: more detailed summary]</p>
- </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>At the command prompt, enter: <code>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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>To Start the Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</code>
+ </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/pageflow_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>
+ <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>
+ </section>
+ <section>
+ <title>Shutdown Tomcat Server</title>
+ <p>At the command prompt, enter: <code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\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>
+ <p><!--[tbd: more detailed summary]--></p>
+ </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/site.xml
==============================================================================
--- incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml (original)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml Wed Oct 13 15:05:17 2004
@@ -1,27 +1,35 @@
<?xml version="1.0"?>
<site label="Beehive" href="" xmlns="http://apache.org/forrest/linkmap/1.0">
- <about label="Beehive">
- <index label="Welcome" href="index.html"/>
- <license label="License" href="license.html"/>
- <downloads label="Downloads" href="downloads.html"/>
- <faq label="FAQ" href="faq.html"/>
- </about>
- <documentation label="Documentation">
- <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"/>-->
- <control_overview label="Control Programming" href="Controls.html"/>
- </controls>
- <jsr181 label="Web Services (JSR 181)" href="webservices.html"/>
- <ref label="Reference Docs" href="reference.html"/>
- </documentation>
- <community label="Community">
- <mailinglists label="Mailing Lists" href="mailinglists.html"/>
- <contributors label="Contributors" href="contributors.html"/>
- </community>
- <external-refs>
- <xml.apache.org href="http://xml.apache.org/"/>
- </external-refs>
+ <about label="Beehive">
+ <index label="Welcome" href="index.html"/>
+ <license label="License" href="license.html"/>
+ <downloads label="Downloads" href="downloads.html"/>
+ <faq label="FAQ" href="faq.html"/>
+ </about>
+ <documentation label="Documentation">
+ <building label="Building Beehive" href="building.html"/>
+ <pageflow label="Page Flows">
+ <tutorial_pageflow label="Page Flow Tutorial" href="pageflow/tutorial_pageflow.html"/>
+ <!--<pageflow_programming label="Page Flow Programming" href="pageflow/guide.html"/>-->
+ </pageflow>
+ <controls label="Controls">
+ <!--<tutorial_control label="Control Tutorial" href="controls/tutorial_controls.html"/>-->
+ <control_overview label="Control Programming" href="Controls.html"/>
+ </controls>
+ <wsm label="Web Services">
+ <!--<tutorial_wsm label="Web Services Tutorial" href="wsm/tutorial_wsm.html"/>-->
+ <jsr181 label="Web Services (JSR 181)" href="webservices.html"/>
+ </wsm>
+ <!--<samples label="Samples">
+ <jpetstore label="JPetStore Samples" href="jpetstore.html"/>
+ </samples>-->
+ <ref label="Reference Docs" href="reference.html"/>
+ </documentation>
+ <community label="Community">
+ <mailinglists label="Mailing Lists" href="mailinglists.html"/>
+ <contributors label="Contributors" href="contributors.html"/>
+ </community>
+ <external-refs>
+ <xml.apache.org href="http://xml.apache.org/"/>
+ </external-refs>
</site>
Added: incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml Wed Oct 13 15:05:17 2004
@@ -0,0 +1,522 @@
+<?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 Page Flow Tutorial</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction To the Page Flow Tutorial</title>
+ <section>
+ <title>Tutorial Goals</title>
+ <p>In this tutorial, you will learn:</p>
+ <ul>
+ <li>How to create a basic Page Flow web application</li>
+ <li>How to coordinate user navigation with Forward methods</li>
+ <li>How to handle data submission and processing with data binding and Form Beans</li>
+ <li>How to create a user interface with the <neuti> JSP tag library</li>
+ <li>How Page Flows help to separate data processing and data presentation</li>
+ </ul>
+ </section>
+ <section>
+ <title>Note on the Current State of the Page Flow Tutorial</title>
+ <p>This tutorial is currently a work in progress. Unfinished portions of the tutorial are marked [tbd], standing for "to be done". Also the tutorial assumes that you are using a Windows machine, however, with a little common sense it is very easy to run through the tutorial on a Linux machine. For example, where the tutorial tells you to run FOO.cmd, instead run FOO.sh.</p>
+ <p>Please send any comments to Steve Hanson, at <code>steveh@bea.com</code>.</p>
+ </section>
+ </section>
+ <section id="step1">
+ <title>Step 1: Begin the Page Flow 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>Throughout this tutorial, it is assumed that you have JDK 5 installed at <code>C:\jdk1.5.0</code></p>
+ <p>[tbd: more detailed installation instructions]</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.</p>
+ <p>[tbd: more detailed installation instructions]</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 a New Page Flow Application</title>
+ <section>
+ <title>Introduction</title>
+ <p>
+ In this step you will create a Controller file and a JSP page. A Controller file is a Java class (with the JPF file extension) that controls how your web application functions and what it does. The methods in the Controller file determines all of the major features of a web application: how users navigate from page to page, how user requests are handled, and how the web application accesses back-end resources.
+ </p>
+ <p>
+ Controller files control the features of a web application through the use of Action methods. An Action method may do something simple, such as forward a user from one JSP page to another; or it may do something complex, such as receive user input from a JSP page, calculate and/or retrieve other data based on the user input, and forward the user to a JSP page where the results are displayed.
+ </p>
+ <p>
+ 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>
+ </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>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</code>, create a directory called <code>pageflow_tutorial</code>.</p>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file called <code>Controller.jpf</code>.</p>
+ <p>In a text editor (or your IDE of choice), open the file 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;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></source>
+ </section>
+ <section>
+ <title>To Create a JSP File</title>
+ <p>In the directory <code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</code>, create a file named <code>index.jsp</code>.</p>
+ <p>Edit index.jsp so it looks like the following.</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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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\pageflow_tutorial</code>
+ </p>
+ </section>
+ <section>
+ <title>Compile the Page Flow</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\pageflow_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/pageflow_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/pageflow_tutorial</code>, create a file named <code>page2.jsp</code>.</p>
+ <p>Edit page2.jsp so it looks like the following.</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>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_tutorial/index.jsp.</p>
+ <p>Edit index.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>index.jsp</title>
+ <netui:base/>
+ </head>
+ <netui:body>
+ <p>
+ index.jsp
+ </p>
+ <p>
+ <netui:anchor action="toPage2">Link to page2.jsp</netui:anchor>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></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/pageflow_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;
+
+public class Controller
+ extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ protected Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+}
+ ]]></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\pageflow_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/pageflow_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/pageflow_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>
+ ]]></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/pageflow_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;
+import org.apache.beehive.netui.pageflow.FormData;
+
+@Jpf.Controller
+public class Controller extends PageFlowController
+{
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="index.jsp")
+ }
+ )
+ public Forward begin()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards={
+ @Jpf.Forward(name="success", path="page2.jsp")
+ }
+ )
+ public Forward toPage2()
+ {
+ return new Forward("success");
+ }
+
+ @Jpf.Action(
+ forwards = {
+ @Jpf.Forward(name = "success", path = "showData.jsp")
+ }
+ )
+ public Forward processData(ProcessDataForm form)
+ {
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ return new Forward("success");
+ }
+
+ public static class ProcessDataForm extends FormData
+ {
+ private int age;
+ private String name;
+
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getName()
+ {
+ return this.name;
+ }
+
+ public void setAge(int age)
+ {
+ this.age = age;
+ }
+
+ public int getAge()
+ {
+ return this.age;
+ }
+ }
+}
+ ]]></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\pageflow_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/pageflow_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" )
+ }
+)
+public Forward processData( ProcessDataForm form )
+{
+ System.out.println("Name: " + form.name);
+ System.out.println("Age: " + form.age);
+ getRequest().setAttribute("data", form);
+ 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/pageflow_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\pageflow_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/pageflow_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>
+ <p>[tbd: more detailed summary]</p>
+ </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>
+</document>
Added: incubator/beehive/trunk/site/src/documentation/resources/images/Thumbs.db
==============================================================================
Binary file. No diff available.