Author: steveh
Date: Fri Oct 22 15:32:11 2004
New Revision: 55333
Added:
incubator/beehive/trunk/site/build/site/beehive/
incubator/beehive/trunk/site/build/site/beehive/guide.html (contents,
props changed)
incubator/beehive/trunk/site/build/site/glossary.html (contents, props
changed)
incubator/beehive/trunk/site/src/documentation/content/xdocs/beehive/
incubator/beehive/trunk/site/src/documentation/content/xdocs/beehive/guide.xml
(contents, props changed)
incubator/beehive/trunk/site/src/documentation/content/xdocs/glossary.xml
(contents, props changed)
Modified:
incubator/beehive/trunk/site/build/site/Controls.html
incubator/beehive/trunk/site/build/site/building.html
incubator/beehive/trunk/site/build/site/contributors.html
incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
incubator/beehive/trunk/site/build/site/downloads.html
incubator/beehive/trunk/site/build/site/faq.html
incubator/beehive/trunk/site/build/site/index.html
incubator/beehive/trunk/site/build/site/jpetstore.html
incubator/beehive/trunk/site/build/site/license.html
incubator/beehive/trunk/site/build/site/mailinglists.html
incubator/beehive/trunk/site/build/site/pageflow/guide.html
incubator/beehive/trunk/site/build/site/pageflow/tutorial_pageflow.html
incubator/beehive/trunk/site/build/site/reference.html
incubator/beehive/trunk/site/build/site/webservices.html
incubator/beehive/trunk/site/build/site/wsm/sample_AddressBook.html
incubator/beehive/trunk/site/build/site/wsm/tutorial_wsm.html
incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml
incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml
incubator/beehive/trunk/site/src/documentation/content/xdocs/site.xml
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
Log:
Adding place-holder files for the Beehive user guide, and a glossary page.
Modified: incubator/beehive/trunk/site/build/site/Controls.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/Controls.html (original)
+++ incubator/beehive/trunk/site/build/site/Controls.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Added: incubator/beehive/trunk/site/build/site/beehive/guide.html
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/build/site/beehive/guide.html Fri Oct 22
15:32:11 2004
@@ -0,0 +1,375 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Putting the Pieces Together</title>
+<link type="text/css" href="../skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script
src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="../images/_incubator-logo.gif"></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="../images/_beehive_logo_wide.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="incubator.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Beehive site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="../skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="../skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a class="base-selected"
href="../index.html">Home</a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom"
bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"
valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Beehive</font>
+<ul>
+
+<li>
+<a href="../index.html">Welcome</a>
+</li>
+
+<li>
+<a href="../license.html">License</a>
+</li>
+
+<li>
+<a href="../downloads.html">Downloads</a>
+</li>
+
+<li>
+<a href="../faq.html">FAQ</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Documentation</font>
+<ul>
+
+<li>
+<font color="#CFDCED">Beehive</font>
+<ul>
+
+<li>
+<span class="sel"><font color="#ffcc00">Putting the Pieces
Together</font></span>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Page Flows</font>
+<ul>
+
+<li>
+<a href="../pageflow/tutorial_pageflow.html">Page Flow Tutorial</a>
+</li>
+
+<li>
+<a href="../pageflow/guide.html">Page Flow Programming</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Controls</font>
+<ul>
+
+<li>
+<a href="../controls/tutorial_controls.html">Control Tutorial</a>
+</li>
+
+<li>
+<a href="../Controls.html">Control Programming</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Web Services</font>
+<ul>
+
+
+<li>
+<a href="../webservices.html">Web Services (JSR 181)</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
+<li>
+<a href="../jpetstore.html">Beehive Samples: JPetStore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<a href="../reference.html">Reference Docs</a>
+</li>
+
+<li>
+<a href="../glossary.html">Glossary</a>
+</li>
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Community</font>
+<ul>
+
+<li>
+<a href="../mailinglists.html">Mailing Lists</a>
+</li>
+
+<li>
+<a href="../contributors.html">Contributors</a>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="right"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td colspan="2"
align="left" width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Putting the Pieces Together</h1>
+</td>
+</tr>
+</table>
+<ul class="minitoc">
+<li>
+<a href="#intro">How Do Page Flows, Controls, and Web Services Fit
Together?</a>
+</li>
+<li>
+<a href="#How+Do+Page+Flows+Work%3F">How Do Page Flows Work?</a>
+</li>
+<li>
+<a href="#nav">Navigation</a>
+</li>
+<li>
+<a href="#submit">Submitting Data: Form Beans, and Data Binding</a>
+</li>
+<li>
+<a href="#processing_data">Processing Data</a>
+</li>
+<li>
+<a href="#displaying_data">Displaying Data</a>
+</li>
+<li>
+<a href="#controls">Accessing Back-End Resources with Controls</a>
+</li>
+<li>
+<a href="#validation">Validation</a>
+</li>
+<li>
+<a href="#security">Security</a>
+</li>
+</ul>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h3>How Do Page Flows, Controls, and Web Services Fit Together?</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Page Flows make building Java web applications easy and intuitive. When
programming with Page Flows, the developer writes Java files and JSP
pages--that's it. There is very little occasion to work with configuration
files, or other components. Page Flow programming is not only simple, it is
also excells at separating the presentation logic from the data processing
logic. This results in uncluttered JSP code which is easy to understand and
edit. Moreover, many of the most difficult programming tasks, such as security
and validation, are handled with a simple declarative programming model using
Java annotations.</p>
+</div>
+
+<a name="N10016"></a><a name="How+Do+Page+Flows+Work%3F"></a>
+<h3>How Do Page Flows Work?</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>A Page Flow consists of a single directory containing a Java class, called
the "Controller", and any number of JSP pages.
+ The role of the JSP pages is to present a visual interface for
users of the web application. The role of the Controller file is to coordinate
all of the things that can happen when a user visits a web site. These duties
include: handling user requests, fashioning responses to user requests,
preserving session state, and coordinating back-end resources (such as
databases and web services).</p>
+<p>The JSP files use special tags (the "<netui>" tags) and databinding
expressions which bind the user interface to objects and actions in the
Controller file.
+ </p>
+<p>tbd: need diagram here</p>
+<p>The action methods in the controller file implement code that can result in
site navigation, passing data, or invoking back-end business logic via
controls.
+ Significantly, the business logic in the controller class is
separate from the presentation code defined in the JSP files.
+ The overall purpose of a page flow is to provide you with an
easy-to-use framework for building dynamic, sophisticated web applications.
+ While page flows give you access to advanced features of J2EE, you
do not have to be a J2EE expert to quickly develop and deploy Java-based
applications built on page flows.</p>
+<p>The programming model: annotations, data binding expressions, <netui>
tags, etc.</p>
+</div>
+
+<a name="N1002C"></a><a name="nav"></a>
+<h3>Navigation</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10033"></a><a name="submit"></a>
+<h3>Submitting Data: Form Beans, and Data Binding</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N1003A"></a><a name="processing_data"></a>
+<h3>Processing Data</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10041"></a><a name="displaying_data"></a>
+<h3>Displaying Data</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10048"></a><a name="controls"></a>
+<h3>Accessing Back-End Resources with Controls</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N1004F"></a><a name="validation"></a>
+<h3>Validation</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10056"></a><a name="security"></a>
+<h3>Security</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<div class="attribution"></div>
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 2004 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " + document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
Modified: incubator/beehive/trunk/site/build/site/building.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/building.html (original)
+++ incubator/beehive/trunk/site/build/site/building.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<span class="sel"><font color="#ffcc00">Building Beehive</font></span>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<span class="sel"><font color="#ffcc00">Building Beehive</font></span>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/contributors.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/contributors.html (original)
+++ incubator/beehive/trunk/site/build/site/contributors.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified:
incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
(original)
+++ incubator/beehive/trunk/site/build/site/controls/tutorial_controls.html
Fri Oct 22 15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="../building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="../webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="../wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="../reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/downloads.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/downloads.html (original)
+++ incubator/beehive/trunk/site/build/site/downloads.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/faq.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/faq.html (original)
+++ incubator/beehive/trunk/site/build/site/faq.html Fri Oct 22 15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Added: incubator/beehive/trunk/site/build/site/glossary.html
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/build/site/glossary.html Fri Oct 22
15:32:11 2004
@@ -0,0 +1,350 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Glossary of Terms</title>
+<link type="text/css" href="skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js"
language="JavaScript" type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="images/_incubator-logo.gif"></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="images/_beehive_logo_wide.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="incubator.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Beehive site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a class="base-selected"
href="index.html">Home</a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt="" src="skin/images/spacer.gif"
class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10"
height="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Beehive</font>
+<ul>
+
+<li>
+<a href="index.html">Welcome</a>
+</li>
+
+<li>
+<a href="license.html">License</a>
+</li>
+
+<li>
+<a href="downloads.html">Downloads</a>
+</li>
+
+<li>
+<a href="faq.html">FAQ</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Documentation</font>
+<ul>
+
+<li>
+<font color="#CFDCED">Beehive</font>
+<ul>
+
+<li>
+<a href="beehive/guide.html">Putting the Pieces Together</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Page Flows</font>
+<ul>
+
+<li>
+<a href="pageflow/tutorial_pageflow.html">Page Flow Tutorial</a>
+</li>
+
+<li>
+<a href="pageflow/guide.html">Page Flow Programming</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Controls</font>
+<ul>
+
+<li>
+<a href="controls/tutorial_controls.html">Control Tutorial</a>
+</li>
+
+<li>
+<a href="Controls.html">Control Programming</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Web Services</font>
+<ul>
+
+
+<li>
+<a href="webservices.html">Web Services (JSR 181)</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
+<li>
+<a href="jpetstore.html">Beehive Samples: JPetStore</a>
+</li>
+
+<li>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<a href="reference.html">Reference Docs</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Glossary</font></span>
+</li>
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Community</font>
+<ul>
+
+<li>
+<a href="mailinglists.html">Mailing Lists</a>
+</li>
+
+<li>
+<a href="contributors.html">Contributors</a>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt="" src="skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td><td colspan="2" align="left"
width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Glossary of Terms</h1>
+</td>
+</tr>
+</table>
+<ul class="minitoc">
+<li>
+<a href="#Terms">Terms</a>
+</li>
+</ul>
+
+<a name="N1000C"></a><a name="Terms"></a>
+<h3>Terms</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+<a name="bee_control"></a>Beehive Control -- Beehive Controls are designed to
make it easier to integrate complex resources into your Java application. For
example, the A Beehive Control consists of two JAVA files: a Control
implementation file, and a Control interface file. </p>
+<p>Contoller file</p>
+<p>Contoller implementation</p>
+<p>Contoller interface</p>
+<p>Contoller file</p>
+<p>Data Binding</p>
+<p>Form Bean -- Typically, a Form Bean is a server-side representation of a
HTML <netui:form> tag. Form Beans follow ordinary Java Bean syntax: each
Form Bean is a class consisting of any number of members, each member having a
setter and a getter method
+ associated with it. Form Beans must extend the class
org.apache.beehive.netui.pageflow.FormData. The Sample Form Bean below has two
members, each member has a getter and setter method associated with it.</p>
+<pre class="code">
+ public static class ProfileFormBean extends FormData
+ {
+ private int age;
+
+ private String name;
+
+ public void setAge(int age)
+ {
+ this.age = age;
+ }
+
+ public int getAge()
+ {
+ return this.age;
+ }
+
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getName()
+ {
+ return this.name;
+ }
+ }
+ </pre>
+<p>Form Beans are most often used to pick up data that is submitted from a
<netui:form> tag, or incoming data from a back-end resource. Once the
data has been picked up by a Form Bean instance, it is then passed to an Action
method.</p>
+<p>JWS</p>
+<p>JPF</p>
+<p>JCS</p>
+<p><netui> tag library</p>
+<p>Page Flow</p>
+</div>
+
+<div class="attribution"></div>
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1" alt=""
src="skin/images/spacer.gif" class="spacer"><a
href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a
href="skin/images/chapter.gif"></a><a
href="skin/images/chapter_open.gif"></a><a
href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 2004 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " + document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
Modified: incubator/beehive/trunk/site/build/site/index.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/index.html (original)
+++ incubator/beehive/trunk/site/build/site/index.html Fri Oct 22 15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,18 +157,37 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
</ul>
</li>
@@ -245,20 +261,20 @@
<a href="#Get+Involved">Get Involved</a>
</li>
</ul>
- <!--
- Beehive
- Welcome<should link to the HTML page created from Welcome.doc>
- License<should link to http://www.apache.org/licenses/LICENSE-2.0>
-
- Documentation
- FAQ<should link to the HTML page created from FAQ.doc>
- Controls Overview<should link to Kyle's control Overview>
- Controls Programming<should link to Kyle's Controls programming pdf>
- Web Services (JSR 181)<should link to
http://jcp.org/en/jsr/detail?id=181>
-
- Contributing
- Mailing Lists<should link to HTML Page created from MailingLists.doc>
- Contributers<should link to HTML Page created from Contributers.doc>
+ <!--
+ Beehive
+ Welcome<should link to the HTML page created from Welcome.doc>
+ License<should link to http://www.apache.org/licenses/LICENSE-2.0>
+
+ Documentation
+ FAQ<should link to the HTML page created from FAQ.doc>
+ Controls Overview<should link to Kyle's control Overview>
+ Controls Programming<should link to Kyle's Controls programming pdf>
+ Web Services (JSR 181)<should link to
http://jcp.org/en/jsr/detail?id=181>
+
+ Contributing
+ Mailing Lists<should link to HTML Page created from MailingLists.doc>
+ Contributers<should link to HTML Page created from Contributers.doc>
-->
Modified: incubator/beehive/trunk/site/build/site/jpetstore.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/jpetstore.html (original)
+++ incubator/beehive/trunk/site/build/site/jpetstore.html Fri Oct 22
15:32:11 2004
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Apache Beehive Web Services</title>
+<title>Beehive Sample: PetStore</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -20,9 +20,9 @@
<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="images/incubator-logo.gif"></a></td>
+<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="images/_incubator-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="images/beehive_logo_wide.gif"></a></td>
+<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="images/_beehive_logo_wide.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search"; method="get">
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -175,7 +172,11 @@
<ul>
<li>
-<span class="sel"><font color="#ffcc00">JPetStore Samples</font></span>
+<span class="sel"><font color="#ffcc00">Beehive Samples:
JPetStore</font></span>
+</li>
+
+<li>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
@@ -184,6 +185,18 @@
<li>
<a href="reference.html">Reference Docs</a>
</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
</ul>
</li>
@@ -239,18 +252,34 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Apache Beehive Web Services</h1>
+<h1>Beehive Sample: PetStore</h1>
</td>
</tr>
</table>
-
-
-<p>
-See the <a target="_blank"
href="http://wiki.apache.org/beehive/Web_20Services";>WSM on the Beehive
wiki</a> and the
-<a target="_blank" href="http://jcp.org/en/jsr/detail?id=181";>JSR 181 Spec</a>
for more information.
-</p>
-
-
+<ul class="minitoc">
+<li>
+<a href="#Anatomy+of+PetStore">Anatomy of PetStore</a>
+</li>
+</ul>
+
+<a name="N1000C"></a><a name="Anatomy+of+PetStore"></a>
+<h3>Anatomy of PetStore</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+ <!-- Just a sketch for now...will re-write from a distribution point
of view later
+ <section>
+ <title>Running the PetStore Sample</title>
+ <p>To run the Petstore sample, you need to (1) add the Beehive
supporting JARs (and other files) to the sample's WEB-INF directory, (2)
compile the Petstore source, (3) deploy the sample to Tomcat, or some other
servlet container, and (4) start up your servlet container.</p>
+ <p>(1) To add the supporting JARs to the WEB-INF directory, run
the following target:</p>
+ <source>ant -f C:\beehive-src\trunk\netui\ant\webappTemplate.xml
-Dwebapp.dist.dir=C:\dev-apache\beehive\trunk\samples\petstoreWeb</source>
+ <p>(2) To compile the sample source code, run the following
target:</p>
+ <source>ant -f C:\beehive-src\trunk\test\ant\buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\dev-apache\beehive\trunk\samples\petstoreWeb</source>
+ <p>(3) To deploy the sample to Tomcat, copy the petstoreWeb folder
to Tomcat's webapps directory.
(C:\dev-apache\beehive\trunk\installed\jakarta-tomcat-5.0.25\webapps) :</p>
+ <p>(4) To start up the Tomcat server, run the following:</p>
+
<source>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</source>
+ <p>Now visit http://localhost:8080/petstoreWeb/index.jsp to see
the Petstore application runnng.</p>
+ </section>
+ -->
+
<div class="attribution"></div>
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
Modified: incubator/beehive/trunk/site/build/site/license.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/license.html (original)
+++ incubator/beehive/trunk/site/build/site/license.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/mailinglists.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/mailinglists.html (original)
+++ incubator/beehive/trunk/site/build/site/mailinglists.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/pageflow/guide.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/pageflow/guide.html (original)
+++ incubator/beehive/trunk/site/build/site/pageflow/guide.html Fri Oct 22
15:32:11 2004
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Beehive Page Flow Tutorial</title>
+<title>Page Flow Users Guide</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -20,9 +20,9 @@
<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="../images/incubator-logo.gif"></a></td>
+<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="../images/_incubator-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="../images/beehive_logo_wide.gif"></a></td>
+<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="../images/_beehive_logo_wide.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search"; method="get">
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="../building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -175,7 +172,11 @@
<ul>
<li>
-<a href="../jpetstore.html">JPetStore Samples</a>
+<a href="../jpetstore.html">Beehive Samples: JPetStore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
@@ -184,6 +185,18 @@
<li>
<a href="../reference.html">Reference Docs</a>
</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
</ul>
</li>
@@ -239,754 +252,89 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Beehive Page Flow Tutorial</h1>
+<h1>Page Flow Users Guide</h1>
</td>
</tr>
</table>
<ul class="minitoc">
<li>
-<a href="#intro">Introduction To the Page Flow Tutorial</a>
-<ul class="minitoc">
-<li>
-<a href="#Tutorial+Goals">Tutorial Goals</a>
-</li>
-<li>
-<a href="#Note+on+the+Current+State+of+the+Page+Flow+Tutorial">Note on the
Current State of the Page Flow Tutorial</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step1">Step 1: Begin the Page Flow Tutorial</a>
-<ul class="minitoc">
-<li></li>
-<li>
-<a href="#Download+and+Install+JDK5">Download and Install JDK5</a>
-</li>
-<li>
-<a href="#Download+and+Install+SVN+%28Subversion+Source+Control%29">Download
and Install SVN (Subversion Source Control)</a>
-</li>
-<li>
-<a href="#Download+and+Install+Beehive">Download and Install Beehive</a>
-</li>
-<li>
-<a href="#Install+ANT">Install ANT</a>
-</li>
-<li>
-<a href="#Run+the+">Run the bootstrap Target</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_2">Step 2: Create a New Page Flow Application</a>
-<ul class="minitoc">
-<li>
-<a href="#Introduction">Introduction</a>
-</li>
-<li>
-<a href="#To+Create+a+Controller+File">To Create a Controller File</a>
-</li>
-<li>
-<a href="#To+Create+a+JSP+File">To Create a JSP File</a>
-</li>
-<li>
-<a href="#To+Create+the+WEB-INF+directory">To Create the WEB-INF directory</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application">To Test the Page Flow Web
Application</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_3">Step 3: Navigation</a>
-<ul class="minitoc">
-<li>
-<a href="#Create+a+Destination+JSP+Page">Create a Destination JSP Page</a>
-</li>
-<li>
-<a href="#Create+a+Link+to+the+Destination+Page">Create a Link to the
Destination Page</a>
-</li>
-<li>
-<a href="#Add+an+Action+Method+to+Handle+the+Link">Add an Action Method to
Handle the Link</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow-N101D6">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N101FE">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N10214">To Test the Page Flow
Web Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server">Shutdown Tomcat Server</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_4">Step 4: Submitting Data</a>
-<ul class="minitoc">
-<li>
-<a href="#To+Create+a+Submission+Form">To Create a Submission Form</a>
+<a href="#intro">What's So Great About Page Flows?</a>
</li>
<li>
-<a href="#To+Edit+the+Controller+File+to+Handle+the+Submitted+Data">To Edit
the Controller File to Handle the Submitted Data</a>
+<a href="#How+Do+Page+Flows+Work%3F">How Do Page Flows Work?</a>
</li>
<li>
-<a href="#Compile+the+Page+Flow-N10263">Compile the Page Flow</a>
+<a href="#nav">Navigation</a>
</li>
<li>
-<a href="#To+Start+the+Tomcat+Server-N1028B">To Start the Tomcat Server</a>
+<a href="#submit">Submitting Data: Form Beans, and Data Binding</a>
</li>
<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N102A1">To Test the Page Flow
Web Application</a>
+<a href="#processing_data">Processing Data</a>
</li>
<li>
-<a href="#Shutdown+Tomcat+Server-N102B7">Shutdown Tomcat Server</a>
-</li>
-</ul>
+<a href="#displaying_data">Displaying Data</a>
</li>
<li>
-<a href="#step_5">Step 5: Processing and Displaying Data</a>
-<ul class="minitoc">
-<li>
-<a href="#To+Process+the+Submitted+Data">To Process the Submitted Data</a>
+<a href="#controls">Accessing Back-End Resources with Controls</a>
</li>
<li>
-<a href="#To+Create+a+JSP+Page+to+Display+Submitted+Data">To Create a JSP Page
to Display Submitted Data</a>
+<a href="#validation">Validation</a>
</li>
<li>
-<a href="#Compile+the+Page+Flow-N102E7">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N1030F">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N10325">To Test the Page Flow
Web Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server-N1033B">Shutdown Tomcat Server</a>
+<a href="#security">Security</a>
</li>
</ul>
-</li>
-<li>
-<a href="#summary">Summary: Page Flow Tutorial</a>
-</li>
-</ul>
-
+
<a name="N1000C"></a><a name="intro"></a>
-<h3>Introduction To the Page Flow Tutorial</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10012"></a><a name="Tutorial+Goals"></a>
-<h4>Tutorial Goals</h4>
+<h3>What's So Great About Page Flows?</h3>
<div style="margin-left: 0 ; border: 2px">
-<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>
+<p>Page Flows make building Java web applications easy and intuitive. When
programming with Page Flows, the developer writes Java files and JSP
pages--that's it. There is very little occasion to work with configuration
files, or other components. Page Flow programming is not only simple, it is
also excells at separating the presentation logic from the data processing
logic. This results in uncluttered JSP code which is easy to understand and
edit. Moreover, many of the most difficult programming tasks, such as security
and validation, are handled with a simple declarative programming model using
Java annotations.</p>
</div>
-<a name="N1002E"></a><a
name="Note+on+the+Current+State+of+the+Page+Flow+Tutorial"></a>
-<h4>Note on the Current State of the Page Flow Tutorial</h4>
+
+<a name="N10016"></a><a name="How+Do+Page+Flows+Work%3F"></a>
+<h3>How Do Page Flows Work?</h3>
<div style="margin-left: 0 ; border: 2px">
-<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 <span class="codefrag">[EMAIL
PROTECTED]</span>.</p>
+<p>A Page Flow consists of a single directory containing a Java class, called
the "Controller", and any number of JSP pages.
+ The role of the JSP pages is to present a visual interface for
users of the web application. The role of the Controller file is to coordinate
all of the things that can happen when a user visits a web site. These duties
include: handling user requests, fashioning responses to user requests,
preserving session state, and coordinating back-end resources (such as
databases and web services).</p>
+<p>The JSP files use special tags (the "<netui>" tags) and databinding
expressions which bind the user interface to objects and actions in the
Controller file.
+ </p>
+<p>tbd: need diagram here</p>
+<p>The action methods in the controller file implement code that can result in
site navigation, passing data, or invoking back-end business logic via
controls.
+ Significantly, the business logic in the controller class is
separate from the presentation code defined in the JSP files.
+ The overall purpose of a page flow is to provide you with an
easy-to-use framework for building dynamic, sophisticated web applications.
+ While page flows give you access to advanced features of J2EE, you
do not have to be a J2EE expert to quickly develop and deploy Java-based
applications built on page flows.</p>
+<p>The programming model: annotations, data binding expressions, <netui>
tags, etc.</p>
</div>
-</div>
-
-<a name="N1003F"></a><a name="step1"></a>
-<h3>Step 1: Begin the Page Flow Tutorial</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10045"></a>
-<h4></h4>
+
+<a name="N1002C"></a><a name="nav"></a>
+<h3>Navigation</h3>
<div style="margin-left: 0 ; border: 2px"></div>
-<a name="N1004B"></a><a name="Download+and+Install+JDK5"></a>
-<h4>Download and Install JDK5</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>If you do not have JDK5 installed on your machine, visit <a target="_blank"
href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>
and download the latest version of JDK5.</p>
-<p>Throughout this tutorial, it is assumed that you have JDK 5 installed at
<span class="codefrag">C:\jdk1.5.0</span>
-</p>
-<p>[tbd: more detailed installation instructions]</p>
-</div>
-<a name="N10061"></a><a
name="Download+and+Install+SVN+%28Subversion+Source+Control%29"></a>
-<h4>Download and Install SVN (Subversion Source Control)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Visit <a target="_blank"
href="http://subversion.tigris.org";>http://subversion.tigris.org</a> and
install the SVN source control system.</p>
-<p>[tbd: more detailed installation instructions]</p>
-</div>
-<a name="N10072"></a><a name="Download+and+Install+Beehive"></a>
-<h4>Download and Install Beehive</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Create a directory called <span
class="codefrag">beehive-src</span> on your C: drive. Confirm that the the
following directory structure exists: <span
class="codefrag">C:/beehive-src</span>. 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: <span class="codefrag">cd beehive-src</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">svn checkout
http://svn.apache.org/repos/asf/incubator/beehive/trunk/</span>
-
-</p>
-<p>Wait a few minutes while the Beehive source is downloaded to your local
machine.</p>
-<p>At the command prompt, enter: <span class="codefrag">exit</span>
-
-</p>
-</div>
-<a name="N1009A"></a><a name="Install+ANT"></a>
-<h4>Install ANT</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Create a directory named <span class="codefrag">installed</span>at <span
class="codefrag">C:/beehive-src/trunk/installed</span>.</p>
-<p>Unzip the file <span
class="codefrag">C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip</span>
into <span class="codefrag">C:/beehive-src/Beehive/installed</span>.</p>
-<p>After the file has unzipped, confirm that the following directory structure
exists: <span
class="codefrag">C:/beehive-src/trunk/installed/apache-ant-1.6.2</span>.</p>
-</div>
-<a name="N100B9"></a><a name="Run+the+"></a>
-<h4>Run the bootstrap Target</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">set
BEEHIVE_HOME=C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant bootstrap</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">exit</span>
-
-</p>
-</div>
-</div>
-
-<a name="N100E8"></a><a name="step_2"></a>
-<h3>Step 2: Create a New Page Flow Application</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N100EE"></a><a name="Introduction"></a>
-<h4>Introduction</h4>
-<div style="margin-left: 0 ; border: 2px">
-<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>
-</div>
-<a name="N100FE"></a><a name="To+Create+a+Controller+File"></a>
-<h4>To Create a Controller File</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In this step you will create the Controller file in place in the Tomcat
deployment directory.</p>
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</span>,
create a directory called <span class="codefrag">pageflow_tutorial</span>.</p>
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file called <span class="codefrag">Controller.jpf</span>.</p>
-<p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-
[EMAIL PROTECTED]
-public class Controller extends PageFlowController
-{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- protected Forward begin()
- {
- return new Forward("success");
- }
-}
- </pre>
-</div>
-<a name="N10125"></a><a name="To+Create+a+JSP+File"></a>
-<h4>To Create a JSP File</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file named <span class="codefrag">index.jsp</span>.</p>
-<p>Edit index.jsp so it looks like the following.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>index.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
- index.jsp
- </p>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N1013D"></a><a name="To+Create+the+WEB-INF+directory"></a>
-<h4>To Create the WEB-INF directory</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p> Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\netui\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f
webappTemplate.xml
-Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N1015F"></a><a name="Compile+the+Page+Flow"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10172"></a><a name="To+Start+the+Tomcat+Server"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N10188"></a><a name="To+Test+the+Page+Flow+Web+Application"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-</div>
-</div>
-
-<a name="N10199"></a><a name="step_3"></a>
-<h3>Step 3: Navigation</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N1019F"></a><a name="Create+a+Destination+JSP+Page"></a>
-<h4>Create a Destination JSP Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file named <span class="codefrag">page2.jsp</span>.</p>
-<p>Edit page2.jsp so it looks like the following.</p>
-<pre class="code">
-<%@ 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>
- </pre>
-</div>
-<a name="N101B7"></a><a name="Create+a+Link+to+the+Destination+Page"></a>
-<h4>Create a Link to the Destination Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/index.jsp.</p>
-<p>Edit index.jsp so it appears as follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ 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>
- </pre>
-</div>
-<a name="N101C9"></a><a name="Add+an+Action+Method+to+Handle+the+Link"></a>
-<h4>Add an Action Method to Handle the Link</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/Controller.jpf.</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
-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");
- }
-}
- </pre>
-</div>
-<a name="N101DB"></a><a name="Compile+the+Page+Flow-N101D6"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10203"></a><a name="To+Start+the+Tomcat+Server-N101FE"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N10219"></a><a
name="To+Test+the+Page+Flow+Web+Application-N10214"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N1022F"></a><a name="Shutdown+Tomcat+Server"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N1023D"></a><a name="step_4"></a>
-<h3>Step 4: Submitting Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10243"></a><a name="To+Create+a+Submission+Form"></a>
-<h4>To Create a Submission Form</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Edit the file <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/page2.jsp</span>
so it appears as follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>page2.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
- Welcome to page2.jsp!
- </p>
- <p>
- <netui:form action="processData">
- <p>Name:<netui:textBox dataSource="actionForm.name"/>
- <p>Age:<netui:textBox dataSource="actionForm.age"/>
- <p><netui:button type="submit">Submit</netui:button>
- </netui:form>
- </p>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N10255"></a><a
name="To+Edit+the+Controller+File+to+Handle+the+Submitted+Data"></a>
-<h4>To Edit the Controller File to Handle the Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/Controller.jpf</span>
-
-</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
-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;
-
[EMAIL PROTECTED]
-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;
- }
- }
-}
- </pre>
-</div>
-<a name="N1026A"></a><a name="Compile+the+Page+Flow-N10263"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10292"></a><a name="To+Start+the+Tomcat+Server-N1028B"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N102A8"></a><a
name="To+Test+the+Page+Flow+Web+Application-N102A1"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N102BE"></a><a name="Shutdown+Tomcat+Server-N102B7"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N102CC"></a><a name="step_5"></a>
-<h3>Step 5: Processing and Displaying Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N102D2"></a><a name="To+Process+the+Submitted+Data"></a>
-<h4>To Process the Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Edit the processData method in the Controller.jpf file so it appears as
follows. Code to add appears in red.</p>
-<pre class="code">
[EMAIL PROTECTED](
- 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");
-}
- </pre>
-</div>
-<a name="N102E1"></a><a
name="To+Create+a+JSP+Page+to+Display+Submitted+Data"></a>
-<h4>To Create a JSP Page to Display Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Create a file named displayData.jsp in the directory
[TOMCAT_HOME]/directory/pageflow_tutorial. Edit showData.jsp so it appears as
follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>showData.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>Name:<netui:span value="${requestScope.data.name}"/>
- <p>Age:<netui:span value="${requestScope.data.age}"/>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N102F0"></a><a name="Compile+the+Page+Flow-N102E7"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10318"></a><a name="To+Start+the+Tomcat+Server-N1030F"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N1032E"></a><a
name="To+Test+the+Page+Flow+Web+Application-N10325"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N10344"></a><a name="Shutdown+Tomcat+Server-N1033B"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N10352"></a><a name="summary"></a>
-<h3>Summary: Page Flow Tutorial</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>This tutorial introduced you to the basics of building web applications
with Beehive Page Flows.</p>
-<p>Concepts and Tasks Introduced in This Tutorial</p>
-<p>[tbd: more detailed summary]</p>
-</div>
-
+
+<a name="N10033"></a><a name="submit"></a>
+<h3>Submitting Data: Form Beans, and Data Binding</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N1003A"></a><a name="processing_data"></a>
+<h3>Processing Data</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10041"></a><a name="displaying_data"></a>
+<h3>Displaying Data</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10048"></a><a name="controls"></a>
+<h3>Accessing Back-End Resources with Controls</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N1004F"></a><a name="validation"></a>
+<h3>Validation</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
+<a name="N10056"></a><a name="security"></a>
+<h3>Security</h3>
+<div style="margin-left: 0 ; border: 2px"></div>
+
<div class="attribution"></div>
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
Modified:
incubator/beehive/trunk/site/build/site/pageflow/tutorial_pageflow.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/pageflow/tutorial_pageflow.html
(original)
+++ incubator/beehive/trunk/site/build/site/pageflow/tutorial_pageflow.html
Fri Oct 22 15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="../building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="../webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="../wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="../reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/reference.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/reference.html (original)
+++ incubator/beehive/trunk/site/build/site/reference.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<span class="sel"><font color="#ffcc00">Reference Docs</font></span>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/webservices.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/webservices.html (original)
+++ incubator/beehive/trunk/site/build/site/webservices.html Fri Oct 22
15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<span class="sel"><font color="#ffcc00">Web Services (JSR 181)</font></span>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook Sample</a>
+<a href="wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
</li>
-
<li>
<a href="reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/wsm/sample_AddressBook.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/wsm/sample_AddressBook.html
(original)
+++ incubator/beehive/trunk/site/build/site/wsm/sample_AddressBook.html Fri Oct
22 15:32:11 2004
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="../building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -160,17 +157,36 @@
<li>
<a href="../webservices.html">Web Services (JSR 181)</a>
</li>
+
+</ul>
+</li>
+
+<li>
+<font color="#CFDCED">Samples</font>
+<ul>
+
<li>
-<span class="sel"><font color="#ffcc00">AddressBook Sample</font></span>
+<span class="sel"><font color="#ffcc00">WSM Sample: AddressBook</font></span>
</li>
</ul>
</li>
-
<li>
<a href="../reference.html">Reference Docs</a>
+</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
</li>
</ul>
Modified: incubator/beehive/trunk/site/build/site/wsm/tutorial_wsm.html
==============================================================================
--- incubator/beehive/trunk/site/build/site/wsm/tutorial_wsm.html
(original)
+++ incubator/beehive/trunk/site/build/site/wsm/tutorial_wsm.html Fri Oct
22 15:32:11 2004
@@ -2,7 +2,7 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>Beehive Page Flow Tutorial</title>
+<title>Beehive Web Service Tutorial</title>
<link type="text/css" href="../skin/page.css" rel="stylesheet">
</head>
<body text="#000000" bgcolor="#FFFFFF">
@@ -20,9 +20,9 @@
<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="../images/incubator-logo.gif"></a></td>
+<td bgcolor="#294563"><a href="http://incubator.apache.org/";><img border="0"
class="logoImage" alt="Apache Incubator"
src="../images/_incubator-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="../images/beehive_logo_wide.gif"></a></td>
+<!--================= start Project Logo ==================--><td width="100%"
align="center" bgcolor="#294563"><a
href="http://incubator.apache.org/beehive";><img border="0" class="logoImage"
alt="Apache Beehive" src="../images/_beehive_logo_wide.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
<form target="_blank" action="http://www.google.com/search"; method="get">
@@ -121,9 +121,6 @@
<font color="#CFDCED">Documentation</font>
<ul>
-<li>
-<a href="../building.html">Building Beehive</a>
-</li>
<li>
<font color="#CFDCED">Page Flows</font>
@@ -175,7 +172,11 @@
<ul>
<li>
-<a href="../jpetstore.html">JPetStore Samples</a>
+<a href="../jpetstore.html">Beehive Samples: JPetStore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">WSM Sample: AddressBook</a>
</li>
</ul>
@@ -184,6 +185,18 @@
<li>
<a href="../reference.html">Reference Docs</a>
</li>
+
+
+<li>
+<font color="#CFDCED">Beehive Source</font>
+<ul>
+
+<li>
+<a href="../building.html">Building Beehive</a>
+</li>
+
+</ul>
+</li>
</ul>
</li>
@@ -239,148 +252,66 @@
<table class="title" summary="">
<tr>
<td valign="middle">
-<h1>Beehive Page Flow Tutorial</h1>
+<h1>Beehive Web Service Tutorial</h1>
</td>
</tr>
</table>
<ul class="minitoc">
<li>
-<a href="#intro">Introduction To the Page Flow Tutorial</a>
+<a href="#intro">Introduction to the Web Service Tutorial</a>
<ul class="minitoc">
<li>
<a href="#Tutorial+Goals">Tutorial Goals</a>
</li>
<li>
-<a href="#Note+on+the+Current+State+of+the+Page+Flow+Tutorial">Note on the
Current State of the Page Flow Tutorial</a>
+<a href="#Note+on+the+Current+State+of+the+Web+Service+Tutorial">Note on the
Current State of the Web Service Tutorial</a>
</li>
</ul>
</li>
<li>
-<a href="#step1">Step 1: Begin the Page Flow Tutorial</a>
+<a href="#step1">Step 1: Begin the Web Service Tutorial</a>
<ul class="minitoc">
-<li></li>
<li>
<a href="#Download+and+Install+JDK5">Download and Install JDK5</a>
</li>
<li>
-<a href="#Download+and+Install+SVN+%28Subversion+Source+Control%29">Download
and Install SVN (Subversion Source Control)</a>
-</li>
-<li>
-<a href="#Download+and+Install+Beehive">Download and Install Beehive</a>
-</li>
-<li>
<a href="#Install+ANT">Install ANT</a>
</li>
<li>
-<a href="#Run+the+">Run the bootstrap Target</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_2">Step 2: Create a New Page Flow Application</a>
-<ul class="minitoc">
-<li>
-<a href="#Introduction">Introduction</a>
-</li>
-<li>
-<a href="#To+Create+a+Controller+File">To Create a Controller File</a>
-</li>
-<li>
-<a href="#To+Create+a+JSP+File">To Create a JSP File</a>
-</li>
-<li>
-<a href="#To+Create+the+WEB-INF+directory">To Create the WEB-INF directory</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application">To Test the Page Flow Web
Application</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_3">Step 3: Navigation</a>
-<ul class="minitoc">
-<li>
-<a href="#Create+a+Destination+JSP+Page">Create a Destination JSP Page</a>
-</li>
-<li>
-<a href="#Create+a+Link+to+the+Destination+Page">Create a Link to the
Destination Page</a>
-</li>
-<li>
-<a href="#Add+an+Action+Method+to+Handle+the+Link">Add an Action Method to
Handle the Link</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow-N101D6">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N101FE">To Start the Tomcat Server</a>
-</li>
-<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N10214">To Test the Page Flow
Web Application</a>
-</li>
-<li>
-<a href="#Shutdown+Tomcat+Server">Shutdown Tomcat Server</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#step_4">Step 4: Submitting Data</a>
-<ul class="minitoc">
-<li>
-<a href="#To+Create+a+Submission+Form">To Create a Submission Form</a>
-</li>
-<li>
-<a href="#To+Edit+the+Controller+File+to+Handle+the+Submitted+Data">To Edit
the Controller File to Handle the Submitted Data</a>
-</li>
-<li>
-<a href="#Compile+the+Page+Flow-N10263">Compile the Page Flow</a>
-</li>
-<li>
-<a href="#To+Start+the+Tomcat+Server-N1028B">To Start the Tomcat Server</a>
+<a href="#Download+and+Install+Tomcat+5">Download and Install Tomcat 5</a>
</li>
<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N102A1">To Test the Page Flow
Web Application</a>
+<a href="#Download+and+Install+a+Beehive+Binary+Distribution">Download and
Install a Beehive Binary Distribution</a>
</li>
<li>
-<a href="#Shutdown+Tomcat+Server-N102B7">Shutdown Tomcat Server</a>
+<a href="#Set+up+the+Development+Environment">Set up the Development
Environment</a>
</li>
</ul>
</li>
<li>
-<a href="#step_5">Step 5: Processing and Displaying Data</a>
+<a href="#step_2">Step 2: Create a New Web Service</a>
<ul class="minitoc">
<li>
-<a href="#To+Process+the+Submitted+Data">To Process the Submitted Data</a>
-</li>
-<li>
-<a href="#To+Create+a+JSP+Page+to+Display+Submitted+Data">To Create a JSP Page
to Display Submitted Data</a>
+<a href="#Introduction">Introduction</a>
</li>
<li>
-<a href="#Compile+the+Page+Flow-N102E7">Compile the Page Flow</a>
+<a href="#Set+Up+Drop+In+Deployment">Set Up Drop In Deployment</a>
</li>
<li>
-<a href="#To+Start+the+Tomcat+Server-N1030F">To Start the Tomcat Server</a>
+<a href="#To+Create+a+JWS+File">To Create a JWS File</a>
</li>
<li>
-<a href="#To+Test+the+Page+Flow+Web+Application-N10325">To Test the Page Flow
Web Application</a>
+<a href="#Compile+the+Web+Service">Compile the Web Service</a>
</li>
<li>
-<a href="#Shutdown+Tomcat+Server-N1033B">Shutdown Tomcat Server</a>
+<a href="#Test+the+Web+Service">Test the Web Service</a>
</li>
</ul>
</li>
-<li>
-<a href="#summary">Summary: Page Flow Tutorial</a>
-</li>
</ul>
<a name="N1000C"></a><a name="intro"></a>
-<h3>Introduction To the Page Flow Tutorial</h3>
+<h3>Introduction to the Web Service Tutorial</h3>
<div style="margin-left: 0 ; border: 2px">
<a name="N10012"></a><a name="Tutorial+Goals"></a>
<h4>Tutorial Goals</h4>
@@ -388,267 +319,207 @@
<p>In this tutorial, you will learn:</p>
<ul>
-<li>How to create a basic Page Flow web application</li>
+<li>How to create a basic Beehive web service application.</li>
-<li>How to coordinate user navigation with Forward methods</li>
+<li>How to use (JSR 175 and 181) metadata annotations.</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>
+<li>How to deploy and test a web service to Tomcat</li>
</ul>
</div>
-<a name="N1002E"></a><a
name="Note+on+the+Current+State+of+the+Page+Flow+Tutorial"></a>
-<h4>Note on the Current State of the Page Flow Tutorial</h4>
+<a name="N10028"></a><a
name="Note+on+the+Current+State+of+the+Web+Service+Tutorial"></a>
+<h4>Note on the Current State of the Web Service Tutorial</h4>
<div style="margin-left: 0 ; border: 2px">
-<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 <span class="codefrag">[EMAIL
PROTECTED]</span>.</p>
+<p>This tutorial is currently a work in progress, and will by changed and
amended in the coming weeks. 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 <span class="codefrag">steveh
at bea.com</span>.</p>
</div>
</div>
-<a name="N1003F"></a><a name="step1"></a>
-<h3>Step 1: Begin the Page Flow Tutorial</h3>
+<a name="N10039"></a><a name="step1"></a>
+<h3>Step 1: Begin the Web Service Tutorial</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10045"></a>
-<h4></h4>
-<div style="margin-left: 0 ; border: 2px"></div>
-<a name="N1004B"></a><a name="Download+and+Install+JDK5"></a>
+<a name="N1003F"></a><a name="Download+and+Install+JDK5"></a>
<h4>Download and Install JDK5</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>If you do not have JDK5 installed on your machine, visit <a target="_blank"
href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>
and download the latest version of JDK5.</p>
-<p>Throughout this tutorial, it is assumed that you have JDK 5 installed at
<span class="codefrag">C:\jdk1.5.0</span>
-</p>
-<p>[tbd: more detailed installation instructions]</p>
+<p>If you do not have JDK5 installed on your machine, visit <a target="_blank"
href="http://java.sun.com/j2se/1.5.0/download.jsp";>http://java.sun.com/j2se/1.5.0/download.jsp</a>
and download and install the latest version. (Note: it is important that you
install version beta51 or later.)</p>
+<p>Throughout this tutorial, it is assumed that you have JDK 5 installed at
<span class="codefrag">C:\jdk1.5.0</span>.</p>
+<p></p>
</div>
-<a name="N10061"></a><a
name="Download+and+Install+SVN+%28Subversion+Source+Control%29"></a>
-<h4>Download and Install SVN (Subversion Source Control)</h4>
+<a name="N10055"></a><a name="Install+ANT"></a>
+<h4>Install ANT</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>Visit <a target="_blank"
href="http://subversion.tigris.org";>http://subversion.tigris.org</a> and
install the SVN source control system.</p>
-<p>[tbd: more detailed installation instructions]</p>
+<p>If you do not have Ant 1.6.2 installed on your machine, visit <a
target="_blank"
href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip</a>
+</p>
+<p>After download is complete, unzip the file <span
class="codefrag">apache-ant-1.6.2-bin.zip</span> into your C: drive.</p>
+<p>After the file has unzipped, confirm that the following directory structure
exists: <span class="codefrag">C:/apache-ant-1.6.2</span>.</p>
</div>
-<a name="N10072"></a><a name="Download+and+Install+Beehive"></a>
-<h4>Download and Install Beehive</h4>
+<a name="N1006E"></a><a name="Download+and+Install+Tomcat+5"></a>
+<h4>Download and Install Tomcat 5</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>
- Create a directory called <span
class="codefrag">beehive-src</span> on your C: drive. Confirm that the the
following directory structure exists: <span
class="codefrag">C:/beehive-src</span>. 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: <span class="codefrag">cd beehive-src</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">svn checkout
http://svn.apache.org/repos/asf/incubator/beehive/trunk/</span>
-
-</p>
-<p>Wait a few minutes while the Beehive source is downloaded to your local
machine.</p>
-<p>At the command prompt, enter: <span class="codefrag">exit</span>
-
-</p>
+<p>If you do not have Tomcat 5 installed on your machine, visit <a
target="_blank"
href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip</a>
and download the ZIP file.</p>
+<p>Unzip jakarta-tomcat-5.0.25.zip into the C: drive.</p>
+<p>After the unzip is complete, confirm that the following directory exists:
<span class="codefrag">C:/jakarta-tomcat-5.0.25</span>.</p>
+<p></p>
</div>
-<a name="N1009A"></a><a name="Install+ANT"></a>
-<h4>Install ANT</h4>
+<a name="N10087"></a><a
name="Download+and+Install+a+Beehive+Binary+Distribution"></a>
+<h4>Download and Install a Beehive Binary Distribution</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>Create a directory named <span class="codefrag">installed</span>at <span
class="codefrag">C:/beehive-src/trunk/installed</span>.</p>
-<p>Unzip the file <span
class="codefrag">C:/beehive-src/trunk/external/ant/apache-ant-1.6.2-bin.zip</span>
into <span class="codefrag">C:/beehive-src/Beehive/installed</span>.</p>
-<p>After the file has unzipped, confirm that the following directory structure
exists: <span
class="codefrag">C:/beehive-src/trunk/installed/apache-ant-1.6.2</span>.</p>
+<p>Visit [tbd: distribution download link] and download the latest binary
distribution of Beehive.</p>
+<p>
+ Create a directory called <span
class="codefrag">beehive-0.4</span> on your C: drive. Confirm that the the
following directory structure exists: <span
class="codefrag">C:/beehive-0.4</span>. This directory will store the Beehive
distribution JARs and all of your Beehive projects.
+ </p>
</div>
-<a name="N100B9"></a><a name="Run+the+"></a>
-<h4>Run the bootstrap Target</h4>
+<a name="N1009A"></a><a name="Set+up+the+Development+Environment"></a>
+<h4>Set up the Development Environment</h4>
<div style="margin-left: 0 ; border: 2px">
<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">set
BEEHIVE_HOME=C:\beehive-src\trunk</span>
+<p> Note: if you have JDK5 installed in a different
directory, set JAVA_HOME to that location.</p>
+<p>At the command prompt, enter: <span class="codefrag">set
CATALINA_HOME=C:/jakarta-tomcat-5.0.25</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
+<p>At the command prompt, enter: <span class="codefrag">set
ANT_HOME=C:\apache-ant-1.6.2</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant bootstrap</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">exit</span>
+<p>At the command prompt, enter: <span class="codefrag">set
PATH=%PATH%;C:\apache-ant-1.6.2\bin</span>
</p>
+<p>Leave the command shell open to use throughout the tutorial</p>
+<p>You are now ready to create a Beehive web service.
+ </p>
</div>
</div>
-<a name="N100E8"></a><a name="step_2"></a>
-<h3>Step 2: Create a New Page Flow Application</h3>
+<a name="N100C3"></a><a name="step_2"></a>
+<h3>Step 2: Create a New Web Service</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100EE"></a><a name="Introduction"></a>
+<a name="N100C9"></a><a name="Introduction"></a>
<h4>Introduction</h4>
<div style="margin-left: 0 ; border: 2px">
-<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>[tbd]</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>
+</p>
+<p>
+</p>
</div>
-<a name="N100FE"></a><a name="To+Create+a+Controller+File"></a>
-<h4>To Create a Controller File</h4>
+<a name="N100D9"></a><a name="Set+Up+Drop+In+Deployment"></a>
+<h4>Set Up Drop In Deployment</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>In this step you will create the Controller file in place in the Tomcat
deployment directory.</p>
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps</span>,
create a directory called <span class="codefrag">pageflow_tutorial</span>.</p>
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file called <span class="codefrag">Controller.jpf</span>.</p>
-<p>In a text editor (or your IDE of choice), open the file Controller.jpf.</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-
[EMAIL PROTECTED]
-public class Controller extends PageFlowController
+<p>Copy the folder <span class="codefrag">[tbd]/AnnotatedAxis</span> into the
directory <span class="codefrag">C:/jakarta-tomcat-5.0.25/webapps</span>.</p>
+<p>Confirm that the following directory structure exists: <span
class="codefrag">C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis</span>
+</p>
+<p>At the command prompt, enter: <span
class="codefrag">C:/jakarta-tomcat-5.0.25/bin/startup.bat</span>
+</p>
+<p>Visit <a target="_blank"
href="http://localhost:8080/AnnotatedAxis/index.html";>http://localhost:8080/AnnotatedAxis/index.html</a>
to confirm AnnotatedAxis is installed on Tomcat. If you do not see an
information page on AnnotatedAxis, then something is wrong. Ensure that
AnnotatedAxis directory is in C:/jakarta-tomcat-5.0.25/webapps, restart Tomcat,
and try again.</p>
+<p>At the command prompt, enter: <span
class="codefrag">C:/jakarta-tomcat-5.0.25/bin/shutdown.bat</span>
+</p>
+</div>
+<a name="N100FF"></a><a name="To+Create+a+JWS+File"></a>
+<h4>To Create a JWS File</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>In the directory <span
class="codefrag">C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis</span>, create
a folder named <span class="codefrag">myWebservice</span>.</p>
+<p>In the directory <span
class="codefrag">C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis/myWebservice</span>,
create a file named <span class="codefrag">HelloWorld.jws</span>.</p>
+<p>Edit HelloWorld.jws so it looks like the following:</p>
+<pre class="code">
+package myWebservice;
+
+import java.rmi.RemoteException;
+
+import javax.jws.Oneway;
+import javax.jws.WebMethod;
+import javax.jws.WebParam;
+import javax.jws.WebResult;
+import javax.jws.WebService;
+
[EMAIL PROTECTED](
targetNamespace="http://www.beehive.com/myWebService/HelloWorld";)
+public class HelloWorld
{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- protected Forward begin()
+ /**
+ * @throws java.rmi.RemoteException
+ */
+ @WebMethod
+ public String hello() throws RemoteException
{
- return new Forward("success");
+ return String "Hello, World!";
}
}
- </pre>
-</div>
-<a name="N10125"></a><a name="To+Create+a+JSP+File"></a>
-<h4>To Create a JSP File</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file named <span class="codefrag">index.jsp</span>.</p>
-<p>Edit index.jsp so it looks like the following.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>index.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
- index.jsp
- </p>
- </netui:body>
-</netui:html>
</pre>
</div>
-<a name="N1013D"></a><a name="To+Create+the+WEB-INF+directory"></a>
-<h4>To Create the WEB-INF directory</h4>
+<a name="N10120"></a><a name="Compile+the+Web+Service"></a>
+<h4>Compile the Web Service</h4>
<div style="margin-left: 0 ; border: 2px">
-<p> Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\netui\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f
webappTemplate.xml
-Dwebapp.dist.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N1015F"></a><a name="Compile+the+Page+Flow"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
+<p>At the command prompt, enter: <span class="codefrag">ant -f
C:\beehive-0.4\ant\buildWebappCore.xml build.webapp
-Dwebapp.dir=C:\jakarta-tomcat-5.0.25\webapps\AnnotatedAxis</span>
</p>
+<p>[tbd: currently gives a Can't find xmlbean class error. Use ant -f
C:\dev-apache\beehive\trunk\test\ant\buildWebapp.xml build.webapp
-Dwebapp.dir=C:\jakarta-tomcat-5.0.25\webapps\AnnotatedAxis as a temp.
workaround.]</p>
</div>
-<a name="N10172"></a><a name="To+Start+the+Tomcat+Server"></a>
-<h4>To Start the Tomcat Server</h4>
+<a name="N10130"></a><a name="Test+the+Web+Service"></a>
+<h4>Test the Web Service</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
+<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-0.4\trunk\test\ant</span>
</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
+<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-0.4\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
</div>
-<a name="N10188"></a><a name="To+Test+the+Page+Flow+Web+Application"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
</div>
-</div>
-
-<a name="N10199"></a><a name="step_3"></a>
-<h3>Step 3: Navigation</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N1019F"></a><a name="Create+a+Destination+JSP+Page"></a>
-<h4>Create a Destination JSP Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>In the directory <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial</span>,
create a file named <span class="codefrag">page2.jsp</span>.</p>
-<p>Edit page2.jsp so it looks like the following.</p>
-<pre class="code">
-<%@ 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>
+ <!--
+ <section id="step_3">
+ <title>Step 3: Navigation</title>
+ <section>
+ <title>Create a Destination JSP Page</title>
+ <p>In the directory
<code>C:/beehive-0.4/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>
- </pre>
-</div>
-<a name="N101B7"></a><a name="Create+a+Link+to+the+Destination+Page"></a>
-<h4>Create a Link to the Destination Page</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/index.jsp.</p>
-<p>Edit index.jsp so it appears as follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ 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>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></source>
+ </section>
+ <section>
+ <title>Create a Link to the Destination
Page</title>
+ <p>Open the file
C:/beehive-0.4/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>
- </pre>
-</div>
-<a name="N101C9"></a><a name="Add+an+Action+Method+to+Handle+the+Link"></a>
-<h4>Add an Action Method to Handle the Link</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/Controller.jpf.</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
+ </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-0.4/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;
@@ -676,98 +547,80 @@
return new Forward("success");
}
}
- </pre>
-</div>
-<a name="N101DB"></a><a name="Compile+the+Page+Flow-N101D6"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10203"></a><a name="To+Start+the+Tomcat+Server-N101FE"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N10219"></a><a
name="To+Test+the+Page+Flow+Web+Application-N10214"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N1022F"></a><a name="Shutdown+Tomcat+Server"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N1023D"></a><a name="step_4"></a>
-<h3>Step 4: Submitting Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N10243"></a><a name="To+Create+a+Submission+Form"></a>
-<h4>To Create a Submission Form</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Edit the file <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/page2.jsp</span>
so it appears as follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>page2.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
+ ]]></source>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Open a command shell.</p>
+ <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk</code>
+ </p>
+ <p>At the command prompt, enter:
<code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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-0.4\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-0.4/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>
- </pre>
-</div>
-<a name="N10255"></a><a
name="To+Edit+the+Controller+File+to+Handle+the+Submitted+Data"></a>
-<h4>To Edit the Controller File to Handle the Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open the file <span
class="codefrag">C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/pageflow_tutorial/Controller.jpf</span>
-
-</p>
-<p>Edit Controller.jpf so it appears as follows.</p>
-<pre class="code">
+ </p>
+ <p>
+ <netui:form action="processData">
+ <p>Name:<netui:textBox dataSource="actionForm.name"/>
+ <p>Age:<netui:textBox dataSource="actionForm.age"/>
+ <p><netui:button type="submit">Submit</netui:button>
+ </netui:form>
+ </p>
+ </netui:body>
+</netui:html>
+ ]]></source>
+ </section>
+ <section>
+ <title>To Edit the Controller File to Handle
the Submitted Data</title>
+ <p>Open the file
<code>C:/beehive-0.4/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;
@@ -834,66 +687,50 @@
}
}
}
- </pre>
-</div>
-<a name="N1026A"></a><a name="Compile+the+Page+Flow-N10263"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10292"></a><a name="To+Start+the+Tomcat+Server-N1028B"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N102A8"></a><a
name="To+Test+the+Page+Flow+Web+Application-N102A1"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N102BE"></a><a name="Shutdown+Tomcat+Server-N102B7"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N102CC"></a><a name="step_5"></a>
-<h3>Step 5: Processing and Displaying Data</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N102D2"></a><a name="To+Process+the+Submitted+Data"></a>
-<h4>To Process the Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Edit the processData method in the Controller.jpf file so it appears as
follows. Code to add appears in red.</p>
-<pre class="code">
+ ]]></source>
+ </section>
+ <section>
+ <title>Compile the Page Flow</title>
+ <p>Open a command shell.</p>
+ <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk</code>
+ </p>
+ <p>At the command prompt, enter:
<code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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-0.4\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" )
@@ -906,86 +743,71 @@
getRequest().setAttribute("data", form);
return new Forward("success");
}
- </pre>
-</div>
-<a name="N102E1"></a><a
name="To+Create+a+JSP+Page+to+Display+Submitted+Data"></a>
-<h4>To Create a JSP Page to Display Submitted Data</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Create a file named displayData.jsp in the directory
[TOMCAT_HOME]/directory/pageflow_tutorial. Edit showData.jsp so it appears as
follows.</p>
-<pre class="code">
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>showData.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>Name:<netui:span value="${requestScope.data.name}"/>
- <p>Age:<netui:span value="${requestScope.data.age}"/>
- </netui:body>
-</netui:html>
- </pre>
-</div>
-<a name="N102F0"></a><a name="Compile+the+Page+Flow-N102E7"></a>
-<h4>Compile the Page Flow</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a command shell.</p>
-<p>At the command prompt, enter: <span class="codefrag">set
JAVA_HOME=C:\jdk1.5.0</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">beehiveEnv.cmd</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\test\ant</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\pageflow_tutorial</span>
-
-</p>
-</div>
-<a name="N10318"></a><a name="To+Start+the+Tomcat+Server-N1030F"></a>
-<h4>To Start the Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</span>
-
-</p>
-<p>At the command prompt, enter: <span class="codefrag">startup.bat</span>
-
-</p>
-<p>Leave this command shell open, so that you can stop and restart Tomcat when
necessary.</p>
-</div>
-<a name="N1032E"></a><a
name="To+Test+the+Page+Flow+Web+Application-N10325"></a>
-<h4>To Test the Page Flow Web Application</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Open a web browser and enter the following in the address bar: <span
class="codefrag">http://localhost:8080/pageflow_tutorial</span>
-
-</p>
-<p>You will be directed to the index.jsp page.</p>
-<p>Click the link.</p>
-<p>You will be directed to page2.jsp.</p>
-</div>
-<a name="N10344"></a><a name="Shutdown+Tomcat+Server-N1033B"></a>
-<h4>Shutdown Tomcat Server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>At the command prompt, enter: <span class="codefrag">shutdown.bat</span>
-
-</p>
-</div>
-</div>
-
-<a name="N10352"></a><a name="summary"></a>
-<h3>Summary: Page Flow Tutorial</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>This tutorial introduced you to the basics of building web applications
with Beehive Page Flows.</p>
-<p>Concepts and Tasks Introduced in This Tutorial</p>
-<p>[tbd: more detailed summary]</p>
-</div>
+ ]]></source>
+ </section>
+ <section>
+ <title>To Create a JSP Page to Display
Submitted Data</title>
+ <p>Create a file named displayData.jsp in the
directory [TOMCAT_HOME]/directory/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-0.4\trunk</code>
+ </p>
+ <p>At the command prompt, enter:
<code>beehiveEnv.cmd</code>
+ </p>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\test\ant</code>
+ </p>
+ <p>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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-0.4\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>
+ -->
<div class="attribution"></div>
</div>
Added:
incubator/beehive/trunk/site/src/documentation/content/xdocs/beehive/guide.xml
==============================================================================
--- (empty file)
+++
incubator/beehive/trunk/site/src/documentation/content/xdocs/beehive/guide.xml
Fri Oct 22 15:32:11 2004
@@ -0,0 +1,52 @@
+<?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>Putting the Pieces Together</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>How Do Page Flows, Controls, and Web Services Fit
Together?</title>
+ <p>Page Flows make building Java web applications easy and
intuitive. When programming with Page Flows, the developer writes Java files
and JSP pages--that's it. There is very little occasion to work with
configuration files, or other components. Page Flow programming is not only
simple, it is also excells at separating the presentation logic from the data
processing logic. This results in uncluttered JSP code which is easy to
understand and edit. Moreover, many of the most difficult programming tasks,
such as security and validation, are handled with a simple declarative
programming model using Java annotations.</p>
+ </section>
+ <section>
+ <title>How Do Page Flows Work?</title>
+ <p>A Page Flow consists of a single directory containing a Java
class, called the "Controller", and any number of JSP pages.
+ The role of the JSP pages is to present a visual interface for
users of the web application. The role of the Controller file is to coordinate
all of the things that can happen when a user visits a web site. These duties
include: handling user requests, fashioning responses to user requests,
preserving session state, and coordinating back-end resources (such as
databases and web services).</p>
+ <p>The JSP files use special tags (the "<netui>" tags) and
databinding expressions which bind the user interface to objects and actions in
the Controller file.
+ </p>
+ <p>tbd: need diagram here</p>
+ <p>The action methods in the controller file implement code that
can result in site navigation, passing data, or invoking back-end business
logic via controls.
+ Significantly, the business logic in the controller class is
separate from the presentation code defined in the JSP files.
+ The overall purpose of a page flow is to provide you with an
easy-to-use framework for building dynamic, sophisticated web applications.
+ While page flows give you access to advanced features of J2EE, you
do not have to be a J2EE expert to quickly develop and deploy Java-based
applications built on page flows.</p>
+ <p>The programming model: annotations, data binding expressions,
<netui> tags, etc.</p>
+ </section>
+ <section id="nav">
+ <title>Navigation</title>
+ </section>
+ <section id="submit">
+ <title>Submitting Data: Form Beans, and Data Binding</title>
+ </section>
+ <section id="processing_data">
+ <title>Processing Data</title>
+ </section>
+ <section id="displaying_data">
+ <title>Displaying Data</title>
+ </section>
+ <section id="controls">
+ <title>Accessing Back-End Resources with Controls</title>
+ </section>
+ <section id="validation">
+ <title>Validation</title>
+ </section>
+ <section id="security">
+ <title>Security</title>
+ </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/glossary.xml
==============================================================================
--- (empty file)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/glossary.xml
Fri Oct 22 15:32:11 2004
@@ -0,0 +1,59 @@
+<?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>Glossary of Terms</title>
+ </header>
+ <body>
+ <section>
+ <title>Terms</title>
+ <p id="bee_control">Beehive Control -- Beehive Controls are
designed to make it easier to integrate complex resources into your Java
application. For example, the A Beehive Control consists of two JAVA
files: a Control implementation file, and a Control interface file. </p>
+ <p>Contoller file</p>
+ <p>Contoller implementation</p>
+ <p>Contoller interface</p>
+ <p>Contoller file</p>
+ <p>Data Binding</p>
+ <p>Form Bean -- Typically, a Form Bean is a server-side
representation of a HTML <netui:form> tag. Form Beans follow ordinary Java
Bean syntax: each Form Bean is a class consisting of any number of members,
each member having a setter and a getter method
+ associated with it. Form Beans must extend the class
org.apache.beehive.netui.pageflow.FormData. The Sample Form Bean below has two
members, each member has a getter and setter method associated with it.</p>
+ <source><![CDATA[
+ public static class ProfileFormBean extends FormData
+ {
+ private int age;
+
+ private String name;
+
+ public void setAge(int age)
+ {
+ this.age = age;
+ }
+
+ public int getAge()
+ {
+ return this.age;
+ }
+
+ public void setName(String name)
+ {
+ this.name = name;
+ }
+
+ public String getName()
+ {
+ return this.name;
+ }
+ }
+ ]]></source>
+ <p>Form Beans are most often used to pick up data that is
submitted from a <netui:form> tag, or incoming data from a back-end
resource. Once the data has been picked up by a Form Bean instance, it is then
passed to an Action method.</p>
+ <p>JWS</p>
+ <p>JPF</p>
+ <p>JCS</p>
+ <p><netui> tag library</p>
+ <p>Page Flow</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/jpetstore.xml
==============================================================================
--- incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml
(original)
+++ incubator/beehive/trunk/site/src/documentation/content/xdocs/jpetstore.xml
Fri Oct 22 15:32:11 2004
@@ -1,25 +1,31 @@
<?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 />
+ <header>
+ <title>Beehive Sample: PetStore</title>
+ </header>
+ <body>
+ <section>
+ <title>Anatomy of PetStore</title>
+ </section>
+ <!-- Just a sketch for now...will re-write from a distribution point
of view later
+ <section>
+ <title>Running the PetStore Sample</title>
+ <p>To run the Petstore sample, you need to (1) add the Beehive
supporting JARs (and other files) to the sample's WEB-INF directory, (2)
compile the Petstore source, (3) deploy the sample to Tomcat, or some other
servlet container, and (4) start up your servlet container.</p>
+ <p>(1) To add the supporting JARs to the WEB-INF directory, run
the following target:</p>
+ <source>ant -f C:\beehive-src\trunk\netui\ant\webappTemplate.xml
-Dwebapp.dist.dir=C:\dev-apache\beehive\trunk\samples\petstoreWeb</source>
+ <p>(2) To compile the sample source code, run the following
target:</p>
+ <source>ant -f C:\beehive-src\trunk\test\ant\buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\dev-apache\beehive\trunk\samples\petstoreWeb</source>
+ <p>(3) To deploy the sample to Tomcat, copy the petstoreWeb folder
to Tomcat's webapps directory.
(C:\dev-apache\beehive\trunk\installed\jakarta-tomcat-5.0.25\webapps) :</p>
+ <p>(4) To start up the Tomcat server, run the following:</p>
+
<source>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</source>
+ <p>Now visit http://localhost:8080/petstoreWeb/index.jsp to see
the Petstore application runnng.</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/pageflow/guide.xml
==============================================================================
---
incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml
(original)
+++
incubator/beehive/trunk/site/src/documentation/content/xdocs/pageflow/guide.xml
Fri Oct 22 15:32:11 2004
@@ -1,522 +1,52 @@
<?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>[EMAIL PROTECTED]</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;
-
[EMAIL PROTECTED]
-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;
-
[EMAIL PROTECTED]
-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[
[EMAIL PROTECTED](
- 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/>
+ <header>
+ <title>Page Flow Users Guide</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>What's So Great About Page Flows?</title>
+ <p>Page Flows make building Java web applications easy and
intuitive. When programming with Page Flows, the developer writes Java files
and JSP pages--that's it. There is very little occasion to work with
configuration files, or other components. Page Flow programming is not only
simple, it is also excells at separating the presentation logic from the data
processing logic. This results in uncluttered JSP code which is easy to
understand and edit. Moreover, many of the most difficult programming tasks,
such as security and validation, are handled with a simple declarative
programming model using Java annotations.</p>
+ </section>
+ <section>
+ <title>How Do Page Flows Work?</title>
+ <p>A Page Flow consists of a single directory containing a Java
class, called the "Controller", and any number of JSP pages.
+ The role of the JSP pages is to present a visual interface for
users of the web application. The role of the Controller file is to coordinate
all of the things that can happen when a user visits a web site. These duties
include: handling user requests, fashioning responses to user requests,
preserving session state, and coordinating back-end resources (such as
databases and web services).</p>
+ <p>The JSP files use special tags (the "<netui>" tags) and
databinding expressions which bind the user interface to objects and actions in
the Controller file.
+ </p>
+ <p>tbd: need diagram here</p>
+ <p>The action methods in the controller file implement code that
can result in site navigation, passing data, or invoking back-end business
logic via controls.
+ Significantly, the business logic in the controller class is
separate from the presentation code defined in the JSP files.
+ The overall purpose of a page flow is to provide you with an
easy-to-use framework for building dynamic, sophisticated web applications.
+ While page flows give you access to advanced features of J2EE, you
do not have to be a J2EE expert to quickly develop and deploy Java-based
applications built on page flows.</p>
+ <p>The programming model: annotations, data binding expressions,
<netui> tags, etc.</p>
+ </section>
+ <section id="nav">
+ <title>Navigation</title>
+ </section>
+ <section id="submit">
+ <title>Submitting Data: Form Beans, and Data Binding</title>
+ </section>
+ <section id="processing_data">
+ <title>Processing Data</title>
+ </section>
+ <section id="displaying_data">
+ <title>Displaying Data</title>
+ </section>
+ <section id="controls">
+ <title>Accessing Back-End Resources with Controls</title>
+ </section>
+ <section id="validation">
+ <title>Validation</title>
+ </section>
+ <section id="security">
+ <title>Security</title>
+ </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
Fri Oct 22 15:32:11 2004
@@ -7,7 +7,9 @@
<faq label="FAQ" href="faq.html"/>
</about>
<documentation label="Documentation">
- <building label="Building Beehive" href="building.html"/>
+ <!--<beehive label="Beehive">
+ <guide label="Putting the Pieces Together"
href="beehive/guide.html"/>
+ </beehive>-->
<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"/>-->
@@ -19,12 +21,16 @@
<wsm label="Web Services">
<!--<tutorial_wsm label="Web Services Tutorial"
href="wsm/tutorial_wsm.html"/>-->
<jsr181 label="Web Services (JSR 181)" href="webservices.html"/>
- <jsr181 label="AddressBook Sample"
href="wsm/sample_AddressBook.html"/>
</wsm>
- <!--<samples label="Samples">
- <jpetstore label="JPetStore Samples" href="jpetstore.html"/>
- </samples>-->
+ <samples label="Samples">
+ <!--<jpetstore label="Beehive Samples: JPetStore"
href="jpetstore.html"/>-->
+ <jsr181 label="WSM Sample: AddressBook"
href="wsm/sample_AddressBook.html"/>
+ </samples>
<ref label="Reference Docs" href="reference.html"/>
+ <!--<gloss label="Glossary" href="glossary.html"/>-->
+ <source label="Beehive Source">
+ <building label="Building Beehive" href="building.html"/>
+ </source>
</documentation>
<community label="Community">
<mailinglists label="Mailing Lists" href="mailinglists.html"/>
Modified:
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
==============================================================================
---
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
(original)
+++
incubator/beehive/trunk/site/src/documentation/content/xdocs/wsm/tutorial_wsm.xml
Fri Oct 22 15:32:11 2004
@@ -12,10 +12,8 @@
<p>In this tutorial, you will learn:</p>
<ul>
<li>How to create a basic Beehive web
service application.</li>
- <li>How to use metadata
annotations.</li>
- <li></li>
- <li></li>
- <li></li>
+ <li>How to use (JSR 175 and 181)
metadata annotations.</li>
+ <li>How to deploy and test a web
service to Tomcat</li>
</ul>
</section>
<section>
@@ -28,50 +26,42 @@
<title>Step 1: Begin the Web Service Tutorial</title>
<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.</p>
+ <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 and install the latest version. (Note: it is important that you
install version beta51 or later.)</p>
<p>Throughout this tutorial, it is assumed that
you have JDK 5 installed at <code>C:\jdk1.5.0</code>.</p>
<p></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></p>
+ <title>Install ANT</title>
+ <p>If you do not have Ant 1.6.2 installed on
your machine, visit <fork
href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/ant/apache-ant-1.6.2-bin.zip</fork></p>
+ <p>After download is complete, unzip the file
<code>apache-ant-1.6.2-bin.zip</code> into your C: drive.</p>
+ <p>After the file has unzipped, confirm that
the following directory structure exists: <code>C:/apache-ant-1.6.2</code>.</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>
+ <title>Download and Install Tomcat 5</title>
+ <p>If you do not have Tomcat 5 installed on
your machine, visit <fork
href="http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip";>http://svn.apache.org/repos/asf/incubator/beehive/trunk/external/tomcat/jakarta-tomcat-5.0.25.zip</fork>
and download the ZIP file.</p>
+ <p>Unzip jakarta-tomcat-5.0.25.zip into the C:
drive.</p>
+ <p>After the unzip is complete, confirm that
the following directory exists: <code>C:/jakarta-tomcat-5.0.25</code>.</p>
+ <p></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>
+ <title>Download and Install a Beehive Binary
Distribution</title>
+ <p>Visit [tbd: distribution download link] and
download the latest binary distribution of Beehive.</p>
+ <p>
+ Create a directory called
<code>beehive-0.4</code> on your C: drive. Confirm that the the following
directory structure exists: <code>C:/beehive-0.4</code>. This directory will
store the Beehive distribution JARs and all of your Beehive projects.
+ </p>
</section>
<section>
- <title>Run the <code>bootstrap</code> Target
and Compile the Beehive Source</title>
+ <title>Set up the Development
Environment</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> Note: if you have
JDK5 installed in a different directory, set JAVA_HOME to that location.</p>
+ <p>At the command prompt, enter: <code>set
CATALINA_HOME=C:/jakarta-tomcat-5.0.25</code>
</p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
+ <p>At the command prompt, enter: <code>set
ANT_HOME=C:\apache-ant-1.6.2</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>Wait a few minutes while the
<code>bootstrap</code> target completes.
- </p>
- <p>At the command prompt, enter: <code>ant
deploy</code>.
- </p>
- <p>Wait a few minutes while the
<code>deploy</code> target completes.
+ <p>At the command prompt, enter: <code>set
PATH=%PATH%;C:\apache-ant-1.6.2\bin</code>
</p>
+ <p>Leave the command shell open to use
throughout the tutorial</p>
<p>You are now ready to create a Beehive web
service.
</p>
</section>
@@ -80,99 +70,69 @@
<title>Step 2: Create a New Web Service</title>
<section>
<title>Introduction</title>
- <p></p>
+ <p>[tbd]</p>
<p> </p>
<p> </p>
</section>
<section>
<title>Set Up Drop In Deployment</title>
- <p>Copy the folder
C:/beehive-src/trunk/wsm/test/webapps/AnnotatedAxis into the directory
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps.</p>
- <p>Confirm that the following directory
structure exists:
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\AnnotatedAxis</p>
- <p>At the command prompt, enter:
<code>C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin\startup.bat</code></p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\wsm\samples\dropInDeployment\AddressBook\server</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;
-
[EMAIL PROTECTED]
-public class Controller extends PageFlowController
+ <p>Copy the folder
<code>[tbd]/AnnotatedAxis</code> into the directory
<code>C:/jakarta-tomcat-5.0.25/webapps</code>.</p>
+ <p>Confirm that the following directory
structure exists:
<code>C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis</code></p>
+ <p>At the command prompt, enter:
<code>C:/jakarta-tomcat-5.0.25/bin/startup.bat</code></p>
+ <p>Visit <fork
href="http://localhost:8080/AnnotatedAxis/index.html";>http://localhost:8080/AnnotatedAxis/index.html</fork>
to confirm AnnotatedAxis is installed on Tomcat. If you do not see an
information page on AnnotatedAxis, then something is wrong. Ensure that
AnnotatedAxis directory is in C:/jakarta-tomcat-5.0.25/webapps, restart Tomcat,
and try again.</p>
+
+ <p>At the command prompt, enter:
<code>C:/jakarta-tomcat-5.0.25/bin/shutdown.bat</code></p>
+ </section>
+ <section>
+ <title>To Create a JWS File</title>
+ <p>In the directory
<code>C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis</code>, create a folder
named <code>myWebservice</code>.</p>
+ <p>In the directory
<code>C:/jakarta-tomcat-5.0.25/webapps/AnnotatedAxis/myWebservice</code>,
create a file named <code>HelloWorld.jws</code>.</p>
+ <p>Edit HelloWorld.jws so it looks like the
following:</p>
+ <source><![CDATA[
+package myWebservice;
+
+import java.rmi.RemoteException;
+
+import javax.jws.Oneway;
+import javax.jws.WebMethod;
+import javax.jws.WebParam;
+import javax.jws.WebResult;
+import javax.jws.WebService;
+
[EMAIL PROTECTED](
targetNamespace="http://www.beehive.com/myWebService/HelloWorld";)
+public class HelloWorld
{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- protected Forward begin()
+ /**
+ * @throws java.rmi.RemoteException
+ */
+ @WebMethod
+ public String hello() throws RemoteException
{
- return new Forward("success");
+ return String "Hello, World!";
}
}
- ]]></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>
+ <title>Compile the Web Service</title>
+ <p>At the command prompt, enter: <code>ant -f
C:\beehive-0.4\ant\buildWebappCore.xml build.webapp
-Dwebapp.dir=C:\jakarta-tomcat-5.0.25\webapps\AnnotatedAxis</code>
</p>
+ <p>[tbd: currently gives a Can't find xmlbean
class error. Use ant -f C:\dev-apache\beehive\trunk\test\ant\buildWebapp.xml
build.webapp -Dwebapp.dir=C:\jakarta-tomcat-5.0.25\webapps\AnnotatedAxis as a
temp. workaround.]</p>
</section>
<section>
- <title>Compile the Page Flow</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
+ <title>Test the Web Service</title>
+ <p>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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>In the directory
<code>C:/beehive-0.4/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"%>
@@ -194,7 +154,7 @@
</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>Open the file
C:/beehive-0.4/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"%>
@@ -219,7 +179,7 @@
</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>Open the file
C:/beehive-0.4/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;
@@ -256,18 +216,18 @@
<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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
</p>
<p>At the command prompt, enter:
<code>startup.bat</code>
</p>
@@ -291,7 +251,7 @@
<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>
+ <p>Edit the file
<code>C:/beehive-0.4/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"%>
@@ -319,7 +279,7 @@
</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>Open the file
<code>C:/beehive-0.4/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[
@@ -396,18 +356,18 @@
<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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
</p>
<p>At the command prompt, enter:
<code>startup.bat</code>
</p>
@@ -472,18 +432,18 @@
<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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\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>At the command prompt, enter: <code>ant -f
buildWebapp.xml build.webapp
-Dwebapp.dir=C:\beehive-0.4\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>At the command prompt, enter: <code>cd
C:\beehive-0.4\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
</p>
<p>At the command prompt, enter:
<code>startup.bat</code>
</p>
@@ -509,6 +469,7 @@
<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/>
