Author: steveh
Date: Mon Nov 8 10:43:28 2004
New Revision: 56960
Added:
incubator/beehive/site/build/site/controls/sample_controls-blank.html
(contents, props changed)
incubator/beehive/site/build/site/controls/sample_controls-db.html
(contents, props changed)
incubator/beehive/site/build/site/wsm/sample_wsm-blank.html (contents,
props changed)
incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-blank.xml
(contents, props changed)
incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml
(contents, props changed)
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
(contents, props changed)
Modified:
incubator/beehive/site/build/site/Controls.html
incubator/beehive/site/build/site/contributors.html
incubator/beehive/site/build/site/controls/tutorial_controls.html
incubator/beehive/site/build/site/downloads.html
incubator/beehive/site/build/site/faq.html
incubator/beehive/site/build/site/index.html
incubator/beehive/site/build/site/jpetstore.html
incubator/beehive/site/build/site/license.html
incubator/beehive/site/build/site/mailinglists.html
incubator/beehive/site/build/site/pageflow/guide.html
incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html
incubator/beehive/site/build/site/reference.html
incubator/beehive/site/build/site/webservices.html
incubator/beehive/site/build/site/wsm/sample_AddressBook.html
incubator/beehive/site/build/site/wsm/sample_Dashboard.html
incubator/beehive/site/build/site/wsm/tutorial_wsm.html
incubator/beehive/site/src/documentation/content/xdocs/jpetstore.xml
incubator/beehive/site/src/documentation/content/xdocs/site.xml
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_AddressBook.xml
Log:
Latest content for live site.
Modified: incubator/beehive/site/build/site/Controls.html
==============================================================================
--- incubator/beehive/site/build/site/Controls.html (original)
+++ incubator/beehive/site/build/site/Controls.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/contributors.html
==============================================================================
--- incubator/beehive/site/build/site/contributors.html (original)
+++ incubator/beehive/site/build/site/contributors.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
@@ -337,7 +349,7 @@
</tr>
<tr>
-<td colspan="1" rowspan="1">?</td><td colspan="1" rowspan="1">Mike
Merz</td><td colspan="1" rowspan="1">BEA (need CLA)</td>
+<td colspan="1" rowspan="1">mmerz</td><td colspan="1" rowspan="1">Mike
Merz</td><td colspan="1" rowspan="1">BEA</td>
</tr>
<tr>
Added: incubator/beehive/site/build/site/controls/sample_controls-blank.html
==============================================================================
--- (empty file)
+++ incubator/beehive/site/build/site/controls/sample_controls-blank.html
Mon Nov 8 10:43:28 2004
@@ -0,0 +1,309 @@
+<!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>"Blank" Control Sample</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">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="../wsm/tutorial_wsm.html">Web Services Tutorial</a>
+</li>
+
+<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">Petstore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_Dashboard.html">Petstore Dashboard</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Control Project</font></span>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<a href="../reference.html">Reference Docs</a>
+</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>"Blank" Control Sample</h1>
+</td>
+</tr>
+</table>
+<ul class="minitoc">
+<li>
+<a href="#intro">Distributable Control Projects</a>
+</li>
+<li></li>
+</ul>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h3>Distributable Control Projects</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>"Mentioning the "control project" model for using controls (perhaps as a
2nd controls tutorial?) -- ie, using the controls-blank template to create a
controls JAR that is then importable in multiple webapps (WEB-INF/lib), and
using this to help isolate business logic in controls from presentation logic
in the webapp proper." </p>
+</div>
+
+<a name="N10016"></a>
+<h3></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>
Added: incubator/beehive/site/build/site/controls/sample_controls-db.html
==============================================================================
--- (empty file)
+++ incubator/beehive/site/build/site/controls/sample_controls-db.html Mon Nov
8 10:43:28 2004
@@ -0,0 +1,348 @@
+<!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>Database Control Sample</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">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="../wsm/tutorial_wsm.html">Web Services Tutorial</a>
+</li>
+
+<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">Petstore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_Dashboard.html">Petstore Dashboard</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Database Control</font></span>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
+</li>
+
+</ul>
+</li>
+
+<li>
+<a href="../reference.html">Reference Docs</a>
+</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>Database Control Sample</h1>
+</td>
+</tr>
+</table>
+<ul class="minitoc">
+<li>
+<a href="#Control+Programming%3A+Simplifying+Access+to+Resources">Control
Programming: Simplifying Access to Resources</a>
+<ul class="minitoc">
+<li>
+<a href="#Structure+of+the+Database+Control">Structure of the Database
Control</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Distributing+the+Database+Control">Distributing the Database
Control</a>
+</li>
+</ul>
+
+<a name="N1000C"></a><a
name="Control+Programming%3A+Simplifying+Access+to+Resources"></a>
+<h3>Control Programming: Simplifying Access to Resources</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Control Programming...simplifying access to a resource, in this case a
database.</p>
+<a name="N10015"></a><a name="Structure+of+the+Database+Control"></a>
+<h4>Structure of the Database Control</h4>
+<div style="margin-left: 0 ; border: 2px"></div>
+<p>The Database Control is a <em>base control</em>: it is designed to be
extented by a <em>control extension</em>. Base controls package the
boilerplate code, the common routines that any code must execute in order to
access a resource. Control extensions contain the interesting, variable
aspects of accessing the resource. If this model were applied to the case of
JMS access, the base control would contain the boilerplate tasks consisting of
obtaining sessions, referencing queues, etc. The control extension configures
the base control for access to a particular JMS resource. The control
extension would anwser the questions: What the JNDI name of the JMS resources?
What message should be sent?
+</p>
+<p>
+In the case of a database resource, The boilerplate parts of the code are
tasks such as making a JDBC connection with the database and handling the
resultsets, tasks specified in the base control. An extension of the base
database control configures the base control by setting the JNDI name the
target database, the SQL statements used to communicate with the database, the
maximum size of resultsets that the control will accept, etc.
+</p>
+<p>
+Not all base controls need to extended to be used: they can be designed to be
used directly by the client, without an control extension intermediary. But in
the case of the database Database Control is designed in order to be extended
by another class, which answers all of the parameter questions: the interesting
parts of accessing the particular resource, whatever it is. An example of a
control extention off of the base Database Control is EmployeeDBControl.jcx
(located at
BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample). The
fragment below shows how the control extension configures the base control for
a JDBC connection to a particular Derby database.
+ </p>
+<p>
+<strong>EmployeeDBControl.jcx</strong>
+</p>
+<pre class="code">@ControlExtension
[EMAIL PROTECTED](jndiName="jdbc:derby:build/databaseControlTestDB;create=true")
+public interface EmployeeDBControl extends DatabaseControl
+{
+ ...
+}
+</pre>
+<ul>
+
+<li>Metadata annotations: reduces configuring the control for resource access
to a matter of setting properties throught annotations. To a client, the
control appears as a JavaBean that is instantiated and operated upon for
resource access. Base controls configure the container using annotations.
Control extensions configure the base.</li>
+
+<li>events (<a
href="http://incubator.apache.org/beehive/ControlsOverview.html#Operations";>http://incubator.apache.org/beehive/ControlsOverview.html#Operations</a>)</li>
+
+<li>resource management (<a
href="http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management";>http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management</a>)....
[todo]</li>
+
+</ul>
+</div>
+
+<a name="N10047"></a><a name="Distributing+the+Database+Control"></a>
+<h3>Distributing the Database Control</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>[todo]</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/site/build/site/controls/tutorial_controls.html
==============================================================================
--- incubator/beehive/site/build/site/controls/tutorial_controls.html
(original)
+++ incubator/beehive/site/build/site/controls/tutorial_controls.html Mon Nov
8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook</a>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/downloads.html
==============================================================================
--- incubator/beehive/site/build/site/downloads.html (original)
+++ incubator/beehive/site/build/site/downloads.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/faq.html
==============================================================================
--- incubator/beehive/site/build/site/faq.html (original)
+++ incubator/beehive/site/build/site/faq.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/index.html
==============================================================================
--- incubator/beehive/site/build/site/index.html (original)
+++ incubator/beehive/site/build/site/index.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
@@ -264,20 +276,20 @@
<a href="#Get+Involved">Get Involved</a>
</li>
</ul>
- <!--
- Beehive
- Welcome<should link to the HTML page created from Welcome.doc>
- License<should link to http://www.apache.org/licenses/LICENSE-2.0>
-
- Documentation
- FAQ<should link to the HTML page created from FAQ.doc>
- Controls Overview<should link to Kyle's control Overview>
- Controls Programming<should link to Kyle's Controls programming pdf>
- Web Services (JSR 181)<should link to
http://jcp.org/en/jsr/detail?id=181>
-
- Contributing
- Mailing Lists<should link to HTML Page created from MailingLists.doc>
- Contributers<should link to HTML Page created from Contributers.doc>
+ <!--
+ Beehive
+ Welcome<should link to the HTML page created from Welcome.doc>
+ License<should link to http://www.apache.org/licenses/LICENSE-2.0>
+
+ Documentation
+ FAQ<should link to the HTML page created from FAQ.doc>
+ Controls Overview<should link to Kyle's control Overview>
+ Controls Programming<should link to Kyle's Controls programming pdf>
+ Web Services (JSR 181)<should link to
http://jcp.org/en/jsr/detail?id=181>
+
+ Contributing
+ Mailing Lists<should link to HTML Page created from MailingLists.doc>
+ Contributers<should link to HTML Page created from Contributers.doc>
-->
Modified: incubator/beehive/site/build/site/jpetstore.html
==============================================================================
--- incubator/beehive/site/build/site/jpetstore.html (original)
+++ incubator/beehive/site/build/site/jpetstore.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
@@ -279,13 +291,13 @@
<a name="N1000C"></a><a name="Introduction"></a>
<h3>Introduction</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>The Petstore sample is composed of Page Flows and Controls. The Page Flows
form the application's user interface, while the Controls coordinate the
- applciation's back-end resources.</p>
-<p>The Page Flows are arranged in a modular fashion. There are separate Page
Flows for different user activities, for example the 'shop' Page Flow (located
at: <span class="codefrag">petstoreWeb/shop/</span>) lets users browse the
catalog of pets, the 'checkout' Page Flow (petstoreWeb/checkout) lets users
purchase selected items from a shopping cart, etc.</p>
+<p>The Petstore sample demonstrates how to integrate all three Beehive
technologies (Page Flows, Controls and Web Services) in one application.</p>
+<p>The Page Flows provide customers with web access to the Petstore. There
are separate Page Flows for different customer activities: the 'shop' Page Flow
(located at: <span class="codefrag">petstoreWeb/shop/</span>) lets users browse
the catalog of pets, the 'checkout' Page Flow (petstoreWeb/checkout) lets users
purchase selected items from a shopping cart, etc.</p>
+<p>The Web Service provides employee access to the Petstore. Through the web
service (located at <span
class="codefrag">petstoreWeb/WEB-INF/src/PetstoreInventoryManager.jws</span>)
employees can update the current inventory and prices displayed to customers
through the web site. A Swing client for the web service is provided in the
sample <a
href="http://incubator.apache.org/beehive/wsm/sample_Dashboard.html";>Petstore
Dashboard</a>. </p>
<p>Most of the Page Flows have associated Control files (located at: <span
class="codefrag">petstoreWeb/WEB-INF/src/org/apache/beehive/samples/petstore/controls/</span>).
The Controls handle the backend data traffic and encupsulate the operations
of the web application, such as retrieving data from a database and handling
user orders.</p>
</div>
-<a name="N10022"></a><a name="Petstore+Directory+Structure"></a>
+<a name="N1002C"></a><a name="Petstore+Directory+Structure"></a>
<h3>Petstore Directory Structure</h3>
<div style="margin-left: 0 ; border: 2px">
<p>The table below describes the functions of the most important files in the
Petstore web application.</p>
@@ -359,6 +371,12 @@
<tr>
+<td colspan="1"
rowspan="1"> lib/PetstoreInventoryManager.jws</td><td
colspan="1" rowspan="1">Web service for employee access to the store</td>
+
+</tr>
+
+<tr>
+
<td colspan="1"
rowspan="1"> src/.../controls</td><td
colspan="1" rowspan="1">Beehive Controls encapsulating different
functionalities, including handling user account data, catalogue data, and
order processing.</td>
</tr>
@@ -378,10 +396,10 @@
</table>
</div>
-<a name="N100D6"></a><a name="Running+the+PetStore+Sample+on+Tomcat+5"></a>
+<a name="N100EC"></a><a name="Running+the+PetStore+Sample+on+Tomcat+5"></a>
<h3>Running the PetStore Sample on Tomcat 5</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100DC"></a><a name="Requirements"></a>
+<a name="N100F2"></a><a name="Requirements"></a>
<h4>Requirements</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Beehive requires the following software to build and deploy
@@ -397,7 +415,7 @@
</ul>
</div>
-<a name="N100F2"></a><a name="Setup"></a>
+<a name="N10108"></a><a name="Setup"></a>
<h4>Setup</h4>
<div style="margin-left: 0 ; border: 2px">
<p>In the descriptions below, <span class="codefrag">BEEHIVE_HOME</span>
refers to the root of the
@@ -442,7 +460,7 @@
</p>
</div>
-<a name="N10132"></a><a name="Building%0A"></a>
+<a name="N10148"></a><a name="Building%0A"></a>
<h4>Building
</h4>
<div style="margin-left: 0 ; border: 2px">
@@ -457,14 +475,12 @@
</pre>
<p>This will copy the Beehive webapp runtime into
</p>
-<pre class="code"> BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/lib
-
-</pre>
+<pre class="code"> BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/lib</pre>
<p>and run the Beehive webapp build process on the petstoreWeb application.
</p>
</div>
-<a name="N10155"></a><a name="Deploying+and+Running%0A"></a>
+<a name="N1016B"></a><a name="Deploying+and+Running%0A"></a>
<h4>Deploying and Running
</h4>
<div style="margin-left: 0 ; border: 2px">
@@ -489,9 +505,7 @@
-Dcontext.path=petstoreWeb</pre>
<p>To hit the running application, use the URL:
</p>
-<pre class="code"> http://localhost:8080/petstoreWeb/Controller.jpf
-
-</pre>
+<pre class="code"> http://localhost:8080/petstoreWeb/Controller.jpf</pre>
</div>
</div>
Modified: incubator/beehive/site/build/site/license.html
==============================================================================
--- incubator/beehive/site/build/site/license.html (original)
+++ incubator/beehive/site/build/site/license.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/mailinglists.html
==============================================================================
--- incubator/beehive/site/build/site/mailinglists.html (original)
+++ incubator/beehive/site/build/site/mailinglists.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/pageflow/guide.html
==============================================================================
--- incubator/beehive/site/build/site/pageflow/guide.html (original)
+++ incubator/beehive/site/build/site/pageflow/guide.html Mon Nov 8
10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook</a>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html
==============================================================================
--- incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html
(original)
+++ incubator/beehive/site/build/site/pageflow/tutorial_pageflow.html Mon Nov
8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook</a>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/reference.html
==============================================================================
--- incubator/beehive/site/build/site/reference.html (original)
+++ incubator/beehive/site/build/site/reference.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/webservices.html
==============================================================================
--- incubator/beehive/site/build/site/webservices.html (original)
+++ incubator/beehive/site/build/site/webservices.html Mon Nov 8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="wsm/sample_AddressBook.html">AddressBook</a>
+<a href="wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Modified: incubator/beehive/site/build/site/wsm/sample_AddressBook.html
==============================================================================
--- incubator/beehive/site/build/site/wsm/sample_AddressBook.html
(original)
+++ incubator/beehive/site/build/site/wsm/sample_AddressBook.html Mon Nov
8 10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<span class="sel"><font color="#ffcc00">AddressBook</font></span>
+<span class="sel"><font color="#ffcc00">AddressBook/Employee</font></span>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
@@ -276,14 +288,15 @@
<a name="N1000C"></a><a name="The+AddressBookWS+and+EmployeeWS+Samples"></a>
<h3>The AddressBookWS and EmployeeWS Samples</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>The AddressBookWS sample is an annotation-aware web service based on the
Apache Axis sample of the same name. AddressBookWS is organized as an
application with POJO (Plain Old Java Objects) models, service interface,
service implementation, and unit tests for the service. The directory structure
and ant build file can be used as a template for building new standalone web
services.</p>
-<p>EmployeeWS [todo]</p>
+<p>The <strong>AddressBookWS</strong> sample is an annotation-aware web
service based on the Apache Axis sample of the same name. AddressBookWS is
organized as an application with POJO (Plain Old Java Objects) models, service
interface, service implementation, and unit tests for the service. Apache Axis
provides automatic client-generation and junit test cases for the sample. The
directory structure and ant build file can be used as a template for building
new standalone web services.</p>
+<p>
+<strong>EmployeeWS</strong> provides a web service interface for an Employee
database. Using SOAP messages, the web service queries the backend database:
selecting, updating and inserting employee data. A Beehive database control
connects the web service and the database. The web service class is located at
<span class="codefrag">EmployeeWS/WEB-INF/src/web/Service.jws</span>. The
database control is located at <span
class="codefrag">EmployeeWS/WEB-INF/src/org/apache/beehive/sample/EmployeeDBControl.jcx</span>.
Apache Derby supplies the database implementation. (Installing Derby
requires a simple JAR file download, described below.) Apache Axis provides
the automatic client-generation for the web service. Custom unit tests are
provided to exercise the webservice methods. The unit tests creates the
database table, inserts a new record, queries the database, and finally drops
the table. Use the junit tests as a template for building automatic tests for
your own controls.</p>
</div>
-<a name="N10019"></a><a name="Running+the+Samples"></a>
+<a name="N10024"></a><a name="Running+the+Samples"></a>
<h3>Running the Samples</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1001F"></a><a name="Requirements+for+Running+the+Sample"></a>
+<a name="N1002A"></a><a name="Requirements+for+Running+the+Sample"></a>
<h4>Requirements for Running the Sample</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To run the Samples, you need:</p>
@@ -303,7 +316,7 @@
</ul>
</div>
-<a name="N1003E"></a><a name="Setting+up+the+Environment"></a>
+<a name="N10049"></a><a name="Setting+up+the+Environment"></a>
<h4>Setting up the Environment</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Download a Beehive distribution archive, and explode it on your local
machine. In the instructions below, the top level directory of the exploded
Beehive archive is called '<span class="codefrag"><dist-dir></span>'.
For example if you explode the archive into </p>
@@ -331,7 +344,7 @@
<p> Copy <span class="codefrag">junit.jar</span> to <span
class="codefrag">ANT_HOME/lib</span>.</p>
<p> Download derby_46005.jar from <a
href="http://incubator.apache.org/derby/binaries/derby_snapshot_svnversion_46005.ZIP";>http://incubator.apache.org/derby/binaries/derby_snapshot_svnversion_46005.ZIP</a>.</p>
<p> Copy <span class="codefrag">derby_46005.jar</span> to <span
class="codefrag">BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/lib</span>.</p>
-<a name="N10094"></a><a name="Setting+up+the+Server"></a>
+<a name="N1009F"></a><a name="Setting+up+the+Server"></a>
<h4>Setting up the Server</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -341,8 +354,20 @@
<pre class="code"> ant -f ant\buildWebapp.xml start</pre>
<p>This will start the Tomcat server located at <span
class="codefrag">CATALINA_HOME</span>.</p>
<p>To build and deploy the web services, run the following Ant commands:</p>
-<pre class="code"> ant -Dwebapp.dir=%BEEHIVE_HOME%\samples\AddressBookWS
-Dcontext.path=AddressBookWS -f ant\buildWebapp.xml deploy.wsm.webapp.runtime
build.webapp deploy</pre>
-<pre class="code"> ant -Dwebapp.dir=%BEEHIVE_HOME%\samples\EmployeeWS
-Dcontext.path=EmployeeWS -f ant\buildWebapp.xml deploy.wsm.webapp.runtime
build.webapp deploy</pre>
+<pre class="code"> ant
+ -Dwebapp.dir=%BEEHIVE_HOME%\samples\AddressBookWS
+ -Dcontext.path=AddressBookWS
+ -f ant\buildWebapp.xml
+ deploy.wsm.webapp.runtime
+ build.webapp
+ deploy</pre>
+<pre class="code"> ant
+ -Dwebapp.dir=%BEEHIVE_HOME%\samples\EmployeeWS
+ -Dcontext.path=EmployeeWS
+ -f ant\buildWebapp.xml
+ deploy.wsm.webapp.runtime
+ build.webapp
+ deploy</pre>
<p>Verify that the web services are running by pointing your browser to:</p>
<p>
@@ -364,7 +389,7 @@
<a href="http://localhost:8080/EmployeeWS/web/Service.jws?wsdl";>
http://localhost:8080/EmployeeWS/web/Service.jws?wsdl</a>
</p>
</div>
-<a name="N100E8"></a><a name="Setting+up+the+Clients"></a>
+<a name="N100F3"></a><a name="Setting+up+the+Clients"></a>
<h4>Setting up the Clients</h4>
<div style="margin-left: 0 ; border: 2px">
<p>To generate the clients run the following build files.</p>
Modified: incubator/beehive/site/build/site/wsm/sample_Dashboard.html
==============================================================================
--- incubator/beehive/site/build/site/wsm/sample_Dashboard.html (original)
+++ incubator/beehive/site/build/site/wsm/sample_Dashboard.html Mon Nov 8
10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook</a>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Added: incubator/beehive/site/build/site/wsm/sample_wsm-blank.html
==============================================================================
--- (empty file)
+++ incubator/beehive/site/build/site/wsm/sample_wsm-blank.html Mon Nov 8
10:43:28 2004
@@ -0,0 +1,309 @@
+<!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>"Blank" Control Sample</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">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="../wsm/tutorial_wsm.html">Web Services Tutorial</a>
+</li>
+
+<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">Petstore</a>
+</li>
+
+<li>
+<a href="../wsm/sample_Dashboard.html">Petstore Dashboard</a>
+</li>
+
+<li>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Web Service Project</font></span>
+</li>
+
+</ul>
+</li>
+
+<li>
+<a href="../reference.html">Reference Docs</a>
+</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>"Blank" Control Sample</h1>
+</td>
+</tr>
+</table>
+<ul class="minitoc">
+<li>
+<a href="#intro">Distributable Control Projects</a>
+</li>
+<li></li>
+</ul>
+
+<a name="N1000C"></a><a name="intro"></a>
+<h3>Distributable Control Projects</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>"Mentioning the "control project" model for using controls (perhaps as a
2nd controls tutorial?) -- ie, using the controls-blank template to create a
controls JAR that is then importable in multiple webapps (WEB-INF/lib), and
using this to help isolate business logic in controls from presentation logic
in the webapp proper." </p>
+</div>
+
+<a name="N10016"></a>
+<h3></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/site/build/site/wsm/tutorial_wsm.html
==============================================================================
--- incubator/beehive/site/build/site/wsm/tutorial_wsm.html (original)
+++ incubator/beehive/site/build/site/wsm/tutorial_wsm.html Mon Nov 8
10:43:28 2004
@@ -180,7 +180,19 @@
</li>
<li>
-<a href="../wsm/sample_AddressBook.html">AddressBook</a>
+<a href="../wsm/sample_AddressBook.html">AddressBook/Employee</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-db.html">Database Control</a>
+</li>
+
+<li>
+<a href="../controls/sample_controls-blank.html">Control Project</a>
+</li>
+
+<li>
+<a href="../wsm/sample_wsm-blank.html">Web Service Project</a>
</li>
</ul>
Added:
incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-blank.xml
==============================================================================
--- (empty file)
+++
incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-blank.xml
Mon Nov 8 10:43:28 2004
@@ -0,0 +1,21 @@
+<?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>"Blank" Control Sample</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Distributable Control Projects</title>
+<p>"Mentioning the "control project" model for using controls (perhaps as a
2nd controls tutorial?) -- ie, using the controls-blank template to create a
controls JAR that is then importable in multiple webapps (WEB-INF/lib), and
using this to help isolate business logic in controls from presentation logic
in the webapp proper." </p>
+ </section>
+ <section>
+ <title></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/site/src/documentation/content/xdocs/controls/sample_controls-db.xml
==============================================================================
--- (empty file)
+++
incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml
Mon Nov 8 10:43:28 2004
@@ -0,0 +1,45 @@
+<?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>Database Control Sample</title>
+ </header>
+ <body>
+ <section>
+ <title>Control Programming: Simplifying Access to Resources</title>
+ <p>Control Programming...simplifying access to a resource, in this
case a database.</p>
+ <section>
+ <title>Structure of the Database Control</title>
+ </section>
+ <p>The Database Control is a <em>base control</em>: it is designed to
be extented by a <em>control extension</em>. Base controls package the
boilerplate code, the common routines that any code must execute in order to
access a resource. Control extensions contain the interesting, variable
aspects of accessing the resource. If this model were applied to the case of
JMS access, the base control would contain the boilerplate tasks consisting of
obtaining sessions, referencing queues, etc. The control extension configures
the base control for access to a particular JMS resource. The control
extension would anwser the questions: What the JNDI name of the JMS resources?
What message should be sent?
+</p><p>
+In the case of a database resource, The boilerplate parts of the code are
tasks such as making a JDBC connection with the database and handling the
resultsets, tasks specified in the base control. An extension of the base
database control configures the base control by setting the JNDI name the
target database, the SQL statements used to communicate with the database, the
maximum size of resultsets that the control will accept, etc.
+</p><p>
+Not all base controls need to extended to be used: they can be designed to be
used directly by the client, without an control extension intermediary. But in
the case of the database Database Control is designed in order to be extended
by another class, which answers all of the parameter questions: the interesting
parts of accessing the particular resource, whatever it is. An example of a
control extention off of the base Database Control is EmployeeDBControl.jcx
(located at
BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample). The
fragment below shows how the control extension configures the base control for
a JDBC connection to a particular Derby database.
+ </p>
+<p><strong>EmployeeDBControl.jcx</strong></p>
+<source>@ControlExtension
[EMAIL PROTECTED](jndiName="jdbc:derby:build/databaseControlTestDB;create=true")
+public interface EmployeeDBControl extends DatabaseControl
+{
+ ...
+}
+</source>
+
+ <ul>
+ <li>Metadata annotations: reduces configuring the control for resource
access to a matter of setting properties throught annotations. To a client,
the control appears as a JavaBean that is instantiated and operated upon for
resource access. Base controls configure the container using annotations.
Control extensions configure the base.</li>
+ <li>events (<link
href="http://incubator.apache.org/beehive/ControlsOverview.html#Operations";>http://incubator.apache.org/beehive/ControlsOverview.html#Operations</link>)</li>
+ <li>resource management (<link
href="http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management";>http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management</link>)....
[todo]</li>
+ </ul>
+ </section>
+ <section>
+ <title>Distributing the Database Control</title>
+ <p>[todo]</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/site/src/documentation/content/xdocs/jpetstore.xml
==============================================================================
--- incubator/beehive/site/src/documentation/content/xdocs/jpetstore.xml
(original)
+++ incubator/beehive/site/src/documentation/content/xdocs/jpetstore.xml
Mon Nov 8 10:43:28 2004
@@ -7,9 +7,9 @@
<body>
<section>
<title>Introduction</title>
- <p>The Petstore sample is composed of Page Flows and Controls.
The Page Flows form the application's user interface, while the Controls
coordinate the
- applciation's back-end resources.</p>
- <p>The Page Flows are arranged in a modular fashion. There are
separate Page Flows for different user activities, for example the 'shop' Page
Flow (located at: <code>petstoreWeb/shop/</code>) lets users browse the catalog
of pets, the 'checkout' Page Flow (petstoreWeb/checkout) lets users purchase
selected items from a shopping cart, etc.</p>
+ <p>The Petstore sample demonstrates how to integrate all three
Beehive technologies (Page Flows, Controls and Web Services) in one
application.</p>
+ <p>The Page Flows provide customers with web access to the
Petstore. There are separate Page Flows for different customer activities: the
'shop' Page Flow (located at: <code>petstoreWeb/shop/</code>) lets users browse
the catalog of pets, the 'checkout' Page Flow (petstoreWeb/checkout) lets users
purchase selected items from a shopping cart, etc.</p>
+ <p>The Web Service provides employee access to the Petstore. Through
the web service (located at
<code>petstoreWeb/WEB-INF/src/PetstoreInventoryManager.jws</code>) employees
can update the current inventory and prices displayed to customers through the
web site. A Swing client for the web service is provided in the sample <link
href="http://incubator.apache.org/beehive/wsm/sample_Dashboard.html";>Petstore
Dashboard</link>. </p>
<p>Most of the Page Flows have associated Control files (located at:
<code>petstoreWeb/WEB-INF/src/org/apache/beehive/samples/petstore/controls/</code>).
The Controls handle the backend data traffic and encupsulate the operations
of the web application, such as retrieving data from a database and handling
user orders.</p>
</section>
<section>
@@ -50,6 +50,9 @@
<td> lib</td><td>JAR
resources</td>
</tr>
<tr>
+
<td> lib/PetstoreInventoryManager.jws</td><td>Web
service for employee access to the store</td>
+ </tr>
+ <tr>
<td> src/.../controls</td><td>Beehive
Controls encapsulating different functionalities, including handling user
account data, catalogue data, and order processing.</td>
</tr>
<tr>
@@ -117,9 +120,7 @@
</source>
<p>This will copy the Beehive webapp runtime into
</p>
- <source> BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/lib
-
-</source>
+ <source> BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/lib</source>
<p>and run the Beehive webapp build process on the petstoreWeb
application.
</p>
@@ -147,9 +148,7 @@
-Dcontext.path=petstoreWeb</source>
<p>To hit the running application, use the URL:
</p>
- <source> http://localhost:8080/petstoreWeb/Controller.jpf
-
-</source>
+ <source>
http://localhost:8080/petstoreWeb/Controller.jpf</source>
</section>
</section>
</body>
Modified: incubator/beehive/site/src/documentation/content/xdocs/site.xml
==============================================================================
--- incubator/beehive/site/src/documentation/content/xdocs/site.xml
(original)
+++ incubator/beehive/site/src/documentation/content/xdocs/site.xml Mon Nov
8 10:43:28 2004
@@ -24,8 +24,11 @@
</wsm>
<samples label="Samples">
<jpetstore label="Petstore" href="jpetstore.html"/>
- <jsr181 label="Petstore Dashboard"
href="wsm/sample_Dashboard.html"/>
- <jsr181 label="AddressBook" href="wsm/sample_AddressBook.html"/>
+ <dash label="Petstore Dashboard" href="wsm/sample_Dashboard.html"/>
+ <address label="AddressBook/Employee"
href="wsm/sample_AddressBook.html"/>
+ <db label="Database Control"
href="controls/sample_controls-db.html"/>
+ <control-blank label="Control Project"
href="controls/sample_controls-blank.html"/>
+ <wsm-blank label="Web Service Project"
href="wsm/sample_wsm-blank.html"/>
</samples>
<ref label="Reference Docs" href="reference.html"/>
<!--<gloss label="Glossary" href="glossary.html"/>-->
Modified:
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_AddressBook.xml
==============================================================================
---
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_AddressBook.xml
(original)
+++
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_AddressBook.xml
Mon Nov 8 10:43:28 2004
@@ -7,8 +7,8 @@
<body>
<section>
<title>The AddressBookWS and EmployeeWS Samples</title>
- <p>The AddressBookWS sample is an annotation-aware web service
based on the Apache Axis sample of the same name. AddressBookWS is organized as
an application with POJO (Plain Old Java Objects) models, service interface,
service implementation, and unit tests for the service. The directory structure
and ant build file can be used as a template for building new standalone web
services.</p>
- <p>EmployeeWS [todo]</p>
+ <p>The <strong>AddressBookWS</strong> sample is an
annotation-aware web service based on the Apache Axis sample of the same name.
AddressBookWS is organized as an application with POJO (Plain Old Java Objects)
models, service interface, service implementation, and unit tests for the
service. Apache Axis provides automatic client-generation and junit test cases
for the sample. The directory structure and ant build file can be used as a
template for building new standalone web services.</p>
+ <p><strong>EmployeeWS</strong> provides a web service interface
for an Employee database. Using SOAP messages, the web service queries the
backend database: selecting, updating and inserting employee data. A Beehive
database control connects the web service and the database. The web service
class is located at <code>EmployeeWS/WEB-INF/src/web/Service.jws</code>. The
database control is located at
<code>EmployeeWS/WEB-INF/src/org/apache/beehive/sample/EmployeeDBControl.jcx</code>.
Apache Derby supplies the database implementation. (Installing Derby
requires a simple JAR file download, described below.) Apache Axis provides
the automatic client-generation for the web service. Custom unit tests are
provided to exercise the webservice methods. The unit tests creates the
database table, inserts a new record, queries the database, and finally drops
the table. Use the junit tests as a template for building automatic tests for
your own controls.</p>
</section>
<section>
<title>Running the Samples</title>
@@ -57,8 +57,20 @@
<source> ant -f ant\buildWebapp.xml start</source>
<p>This will start the Tomcat server located at
<code>CATALINA_HOME</code>.</p>
<p>To build and deploy the web services, run the following Ant
commands:</p>
- <source> ant
-Dwebapp.dir=%BEEHIVE_HOME%\samples\AddressBookWS -Dcontext.path=AddressBookWS
-f ant\buildWebapp.xml deploy.wsm.webapp.runtime build.webapp deploy</source>
- <source> ant -Dwebapp.dir=%BEEHIVE_HOME%\samples\EmployeeWS
-Dcontext.path=EmployeeWS -f ant\buildWebapp.xml deploy.wsm.webapp.runtime
build.webapp deploy</source>
+ <source> ant
+ -Dwebapp.dir=%BEEHIVE_HOME%\samples\AddressBookWS
+ -Dcontext.path=AddressBookWS
+ -f ant\buildWebapp.xml
+ deploy.wsm.webapp.runtime
+ build.webapp
+ deploy</source>
+ <source> ant
+ -Dwebapp.dir=%BEEHIVE_HOME%\samples\EmployeeWS
+ -Dcontext.path=EmployeeWS
+ -f ant\buildWebapp.xml
+ deploy.wsm.webapp.runtime
+ build.webapp
+ deploy</source>
<p>Verify that the web services are running by pointing your
browser to:</p>
<p>
<fork
href="http://localhost:8080/AddressBookWS/";>http://localhost:8080/AddressBookWS/</fork>
Added:
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
==============================================================================
--- (empty file)
+++
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
Mon Nov 8 10:43:28 2004
@@ -0,0 +1,21 @@
+<?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>"Blank" Control Sample</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Distributable Control Projects</title>
+<p>"Mentioning the "control project" model for using controls (perhaps as a
2nd controls tutorial?) -- ie, using the controls-blank template to create a
controls JAR that is then importable in multiple webapps (WEB-INF/lib), and
using this to help isolate business logic in controls from presentation logic
in the webapp proper." </p>
+ </section>
+ <section>
+ <title></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>
