Author: steveh
Date: Mon May 16 10:22:40 2005
New Revision: 170413

URL: http://svn.apache.org/viewcvs?rev=170413&view=rev
Log:
Removing references these samples: AddressBook and DB-Control.
Adding new topic for AddressBookEnhanced.

Added:
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml
   (with props)
Modified:
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/getting_started.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/docs/index.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/jpetstore.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/pageflow_datagrid.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/sharedFlow.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/sample-ws-control-blank.xml
    
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/getting_started.xml

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/getting_started.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/getting_started.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/getting_started.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/getting_started.xml
 Mon May 16 10:22:40 2005
@@ -16,10 +16,10 @@
                        <ul>
             <li><a href="site:tutorial_control">Beehive Controls 
Tutorial</a></li>
         </ul>
-        <p>The following <strong>sample</strong> demonstrates a Database 
control implementation:</p>
+        <!--<p>The following <strong>sample</strong> demonstrates a Database 
control implementation:</p>
         <ul>
             <li><a href="site:db-sample">Database Control Sample</a></li>
-        </ul>
+        </ul>-->
         <p>The following <strong>application template</strong> will help you 
get a 
                        Control project started:</p>
         <ul>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/docs/index.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/docs/index.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/docs/index.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/docs/index.xml
 Mon May 16 10:22:40 2005
@@ -30,9 +30,10 @@
         <ul>
             <li><a href="site:jpetstore">Petstore Sample</a></li>
             <li><a href="site:netui-samples">Page Flow Samples</a></li>
-            <li><a href="site:db-sample">Database Control Sample</a></li>
-            <li><a href="site:address">AddressBookWS Sample</a></li>
-            <!--<li><a href="site:employee">EmployeeWS Sample</a></li>-->
+            <!--<li><a href="site:db-sample">Database Control Sample</a></li>
+            <li><a href="site:address">AddressBookWS Sample</a></li>-->
+            <li><a href="site:address-enhanced">AddressBookEnhancedWS 
Sample</a></li>
+                       <!--<li><a href="site:employee">EmployeeWS 
Sample</a></li>-->
             <li><a href="site:wsm-samples">Web Service Annotation 
Samples</a></li>
         </ul>
         <p>The following <strong>application templates</strong> will help you 
get a project started:</p>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/jpetstore.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/jpetstore.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/jpetstore.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/jpetstore.xml
 Mon May 16 10:22:40 2005
@@ -23,7 +23,7 @@
                                The Controls handle the backend data traffic 
and encapsulate 
                                the operations of the web application, such as 
retrieving data 
                                from a database and handling user orders.</p>
-               </section>
+
                <section id="dir_struct">
                        <title>Petstore Directory Structure</title>
                        <p>The table below describes the functions of the most 
important 
@@ -107,6 +107,22 @@
                                        <td>Java object classes used by the 
Controls</td>
                                </tr>
                        </table>
+               </section>
+               <section><title>Build Targets</title>
+                       <p>The build file (located at 
<code>petstoreWeb/build.xml</code>) contains the following
+                       build targets.</p>
+                       <table>
+                               
<tr><th><strong>Target</strong></th><th><strong>Description</strong></th></tr>
+                               <tr><td>deploy-beehive</td><td>Copies the 
Beehive runtime JARs into the webapp's
+                                       WEB-INF/lib directory.</td></tr>
+                               <tr><td>build</td><td>Compiles the webapp 
components:
+                                       XMLBean schemas, controls, page flows, 
and web services.</td></tr>
+                               <tr><td>scrub</td><td>Deletes the build 
directories and the test-related
+                                       directories.</td></tr>
+                               <tr><td>clean</td><td>Deletes the build 
directories from the web app.</td></tr>
+                               <tr><td>war</td><td>Builds a WAR file from the 
web app files.</td></tr>
+                       </table>
+                       </section>
                </section>
                <section id="running">
                        <title>Running the PetStore Sample on Tomcat 5</title>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/pageflow_datagrid.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/pageflow_datagrid.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/pageflow_datagrid.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/pageflow_datagrid.xml
 Mon May 16 10:22:40 2005
@@ -28,8 +28,8 @@
                                database. Any data returned by the database is 
transformed by the method
                                into an appropriate Java object so it is 
available to the rest of the web 
                                application.</p>
-                       <p>For more database control implementations you can 
download and use in applications, 
-                               see <a href="site:db-sample">Database Control 
Sample</a></p>
+                       <!--<p>For more database control implementations you 
can download and use in applications, 
+                               see <a href="site:db-sample">Database Control 
Sample</a></p>-->
                        
                        <p><strong>The Page Flow</strong></p>
                                <p>The Page Flow(s) form the front-end user 
interface of the application.  

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/sharedFlow.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/sharedFlow.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/sharedFlow.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/pageflow/sharedFlow.xml
 Mon May 16 10:22:40 2005
@@ -18,7 +18,7 @@
                        <p>Shared flows can reside anywhere in your web app, 
and can be 
                                invoked from other controller files or from JSP 
files.</p>
                </section>
-               <section id="declaring">
+               <section id="creating">
                        <title>Creating a Shared Flow</title>
                        <p>To create a shared flow controller file</p>
                        <ol>
@@ -36,7 +36,7 @@
 
 }</source>
                </section>
-               <section><title>Adding Actions and Data to a Shared Flow</title>
+               <section id="add_actions"><title>Adding Actions and Data to a 
Shared Flow</title>
                        <p>Shared flows have all of capabilities of other 
controller files. 
                                They can contain</p>
                                <ol>
@@ -98,7 +98,7 @@
 
 }</source>
                        </section>
-        <section>
+        <section id="invoking_from_controller">
                        <title>Invoking Shared Flows from Other Controller 
Files</title>
                        <p>To invoke the functionality of shared flow, it must 
first be declared on the 
                                invoking resource.  To declared a shared flow 
on another controller file, 
@@ -132,12 +132,15 @@
        (with @Jpf.SharedFlowField) without having first declared the 
        shared flow in the Controller annotation (with @Jpf.SharedFlowRef).</p>
 
+                       <note>You cannot access actions in 
<code>Global.app</code> if you've declared 
+                               shared flow references 
(@Jpf.Controller(sharedFlowRefs=...)) in your 
+                               page flow</note>
 <p>Now you can invoke the resources within the shared flow.  For example, to 
invoke the 
        shared flow's <code>handleLogout()</code> method, do the following:</p>
        <source>    _sharedFlowOne.handleLogout();</source>
 
         </section>
-               <section>
+               <section id="invoking_from_JSP">
                        <title>Invoking Shared Flows from JSP Pages</title>
                        <p>Shared flow resources can be accessed from a JSP 
using the scope <code>sharedFlow</code>, 
                                for example,</p>
@@ -156,7 +159,7 @@
 @Jpf.SharedFlowField(name="specificSharedFlow")
                </source>
                </section>
-               <section>
+               <section id="example">
                        <title>Example Code</title>
                        <p>See the shared flow controller file in the PetStore 
sample, 
                                located at 
<code>BEEHIVE_HOME/samples/petstoreWeb/webappRoot/SharedFlow.jpfs</code></p>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml 
(original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/setup.xml 
Mon May 16 10:22:40 2005
@@ -71,15 +71,15 @@
                                following tutorials introduce the basic 
development cycle:</p>
                        <ul>
                                <li>
-                                       <a 
href="controls/tutorial_controls.html">Beehive Controls 
+                                       <a 
href="controls/tutorial_controls.html">Controls 
                                                Tutorial</a>
                                </li>
                                <li>
-                                       <a 
href="pageflow/tutorial_pageflow.html">Beehive Page Flow 
+                                       <a 
href="pageflow/tutorial_pageflow.html">Page Flow 
                                                Tutorial</a>
                                </li>
                                <li>
-                                       <a href="wsm/tutorial_wsm.html">Beehive 
Web Service 
+                                       <a href="wsm/tutorial_wsm.html">Web 
Service 
                                                Tutorial</a>
                                </li>
                        </ul>
@@ -89,16 +89,19 @@
                                        <a href="jpetstore.html">Beehive 
Sample: Petstore</a>
                                </li>
                                <li>
-                                       <a 
href="wsm/sample_Dashboard.html">Beehive Web Service 
+                                       <a href="wsm/sample_Dashboard.html">Web 
Service 
                                                Sample: Petstore Dashboard</a>
                                </li>
-                               <li>
+                               <!--<li>
                                        <a 
href="wsm/sample_AddressBook.html">Beehive AddressBookWS 
                                                and EnhancedAddressBookWS 
Samples</a>
-                               </li>
-                               <li>
+                               </li>-->
+                               <!--<li>
                                        <a 
href="controls/sample_controls-db.html">Database Control 
                                                Sample</a>
+                               </li>-->
+                               <li>
+                                       <a href="site:address-enhanced">Web 
Service Sample: EnhancedAddressBookWS</a>
                                </li>
                        </ul>
                        <p>The following application templates will help you 
get a project 
@@ -115,6 +118,9 @@
                                <li>
                                        <a href="wsm/sample_wsm-blank.html">Web 
Service Project 
                                                Template</a>
+                               </li>
+                               <li>
+                                       <a href="site:ws-control-blank">Web 
Service Control     Template</a>
                                </li>
                        </ul>
                </section>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml 
(original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml 
Mon May 16 10:22:40 2005
@@ -69,8 +69,9 @@
             <jpetstore label="Petstore" href="jpetstore.html"/>
             <netui-samples label="Page Flow Samples" 
href="pageflow/netui-samples.html"/>
             <!--<dash label="Petstore Dashboard" 
href="wsm/sample_Dashboard.html"/>-->
-            <db-sample label="Database Control" 
href="controls/sample_controls-db.html"/>
-            <address label="AddressBook Web Service" 
href="wsm/sample_AddressBook.html"/>
+            <!--db-sample label="Database Control" 
href="controls/sample_controls-db.html"/-->
+            <!--address label="AddressBook Web Service" 
href="wsm/sample_AddressBook.html"/-->
+            <address-enhanced label="AddressBookEnhanced Web Service" 
href="wsm/sample_AddressBookEnhanced.html"/>
                        <!--<employee label="Employee Web Service" 
href="wsm/sample_Employee.html"/>-->
             <wsm-samples label="Web Service Annotation Samples" 
href="wsm/sample_wsmAnnoSamples.html"/>
             <netui-blank label="Page Flow Project" 
href="pageflow/sample_netui-blank.html"/>

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/sample-ws-control-blank.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/sample-ws-control-blank.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/sample-ws-control-blank.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/sample-ws-control-blank.xml
 Mon May 16 10:22:40 2005
@@ -24,7 +24,7 @@
                                along with the control interfaces and compiles 
them into a JAR file.
                                The final service control JAR is saved in the 
build directory.</p>
                        <p>The controls-webservice-blank sample contains the 
WSDL file for the 
-                               <a 
href="site:address">EnhancedAddressBookWS</a> sample, but the web service 
+                               <a 
href="site:address-enhanced">EnhancedAddressBookWS</a> sample, but the web 
service 
                                doesn't need to be running to 
                                generate its service control.</p>
                                
@@ -37,7 +37,7 @@
                        <p>The junit tests call the web service using the 
control interfaces generated based
                                on the WSDL.  The tests add an entry and 
retrieve it to verify the web service.
                                The run the junit tests make sure you have the 
-                                       <a 
href="site:address">EnhancedAddressBookWS</a> up and running.
+                                       <a 
href="site:address-enhanced">EnhancedAddressBookWS</a> up and running.
                                 </p>
                        <note>Controls are meant to be used in a container; in 
a container 
                                (servlet, ejb, spring) the initialization 
happens transparent to the

Modified: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/getting_started.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/getting_started.xml?rev=170413&r1=170412&r2=170413&view=diff
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/getting_started.xml
 (original)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/getting_started.xml
 Mon May 16 10:22:40 2005
@@ -13,10 +13,10 @@
                        <ul><li><a href="site:tutorial_wsm">Beehive Web Service 
Tutorial</a></li></ul>
                        <p>The following <strong>sample</strong> demonstrates 
the basic Beehive 
                                web service features: </p>
-                       <ul><li><a href="site:address">AddressBook 
sample</a></li></ul>
+                       <!--<ul><li><a href="site:address">AddressBook 
sample</a></li></ul>
                        <p>The following <strong>sample</strong> shows more 
advanced web service features, such as web parameters 
-                               and "one way" methods.</p>
-                       <ul><li><a href="site:address">AddressBook-Enhanced 
sample</a></li></ul>
+                               and "one way" methods.</p>-->
+                       <ul><li><a 
href="site:address-enhanced">AddressBook-Enhanced sample</a></li></ul>
                        <!--<p>The following <strong>sample</strong> shows how 
to invoke a control from within a web service: </p>
                        <ul><li><a href="site:employee">Employee 
sample</a></li></ul>-->
        </body>

Added: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml
URL: 
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml?rev=170413&view=auto
==============================================================================
--- 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml
 (added)
+++ 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml
 Mon May 16 10:22:40 2005
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" 
"http://forrest.apache.org/dtd/document-v20.dtd";>
+<document>
+       <header>
+               <title>EnhancedAddressBookWS Sample</title>
+       </header>
+       <body>
+               <section id="intro">
+                       <title>The Sample</title>
+                       <p>The <strong>EnhancedAddressBookWS</strong> sample 
uses 
+                               metadata annotations,
+                               has customized annotations properties, and 
shows exception handling.</p>
+                       <p>Apache Axis provides the automatic client-generation 
for the 
+                               web services. Custom unit tests are provided to 
exercise the 
+                               webservice methods. The unit tests create the 
database tables, 
+                               insert new records, query the database, and 
finally drop 
+                               the tables. Use the junit tests as a template 
for building 
+                               automatic tests for your own web services</p>
+               </section>
+               <section id="running">
+                       <title>Running the Sample</title>
+                       <section id="reqs">
+                               <title>Requirements for Running the 
Sample</title>
+                               <p>To run the Sample, you need:</p>
+                               <ul>
+                                       <li>Beehive</li>
+                                       <li>Tomcat 5</li>
+                                       <li>J2SE 5</li>
+                                       <li>Ant 1.6.2</li>
+                                       <li>junit.jar (v3.8.1 or later, details 
below)</li>
+                               </ul>
+                       </section>
+                       <section id="enviro">
+                               <title>To Set up the Environment</title>
+                               <p>Before proceeding, complete all of the 
necessary and 
+                                       optional steps in the following topic: 
<a class="fork" 
+                                       href="../setup.html">Beehive 
Installation and Setup</a></p>
+                               <p>Open a command shell and confirm that the 
following 
+                                       variables have been set:</p>
+                               <ul>
+                                       <li>
+                                               <code>ANT_HOME</code>
+                                       </li>
+                                       <li>
+                                               <code>CATALINA_HOME</code>
+                                       </li>
+                                       <li>
+                                               <code>JAVA_HOME</code>
+                                       </li>
+                               </ul>
+                               <p>Also ensure that the following elements are 
on your 
+                                       <code>PATH</code>:</p>
+                               <ul>
+                                       <li>
+                                               <code>ANT_HOME/bin</code>
+                                       </li>
+                                       <li>
+                                               <code>JAVA_HOME/bin</code>
+                                       </li>
+                               </ul>
+                       </section>
+                       <section id="setup_server">
+                               <title>To Set up the Server</title>
+                               <section id="copy_app">
+                                       <title>To Copy the Application to a 
Project Folder</title>
+                                       <p>To keep your Beehive distribution 
directory pristine, 
+                                               you should copy the application
+                                                folders to 
+                                               another location before 
proceeding. The following 
+                                               instructions assume that you 
have copied the folder</p> 
+       <source>&lt;BeehiveRoot>/samples/wsm-addressbook</source>               
                         
+<p>                                     into the directory 
+                                               
<code>C:/beehive_projects</code>, resulting in the 
+                                               following directory 
structure.</p>
+               <source>C: 
+  beehive_projects 
+    wsm-addressbook-enhanced</source>
+       
+                               <note>&lt;BeehiveRoot> refers to the top-level 
directory of your Beehive installation.
+                                       A typical value for &lt;BeehiveRoot> 
would be <code>C:/apache/apache-beehive-1.0</code>. </note>
+                               </section>
+                       <section id="start_tomcat">
+                               <title>To Start Tomcat</title>
+                               <p>To start Tomcat, run the following 
command:</p>
+                               <source>%CATALINA_HOME%\bin\startup.bat</source>
+                       </section>      
+                               <section id="external_jars">
+                                       <title>To Download Junit the JAR 
File</title>
+                               <p>Download the junit ZIP archive from <a 
+                                       
href="http://prdownloads.sourceforge.net/junit/junit3.8.1.zip?download";>http://prdownloads.sourceforge.net/junit/junit3.8.1.zip?download</a>
 
+                                       </p>
+                               <p>Unzip the archive, locate 
<code>junit.jar</code>, and copy <code>junit.jar</code> to 
+                                       <code>ANT_HOME/lib</code>.</p>
+                               </section>
+                       <section id="edit_properties_file"><title>Edit the 
<code>build.properties</code> Files</title>
+                               <p>In this section you will edit the 
<code>build.properties</code> file--the files
+                                       that set the build-related properties 
for the web service.</p>
+                               <p>Open the file 
<code>C:/beehive_projects/wsm-addressbook-enhanced/WEB-INF/build.properties</code>
+                                       in a text editor.</p>
+                               <p>Edit the file so that the 
<code>beehive.home</code> property points to the 
+                                       top-level folder of your beehive 
installation.  For example, if you beehive installation
+                                       resides at 
<code>C:/apache/apache-beehive-1.0</code>, then your 
<code>build.properties</code> files
+                                       would appear as follows.</p>
+                               
<source>beehive.home=<strong>C:/apache/apache-beehive-1.0</strong></source>
+                                       </section>
+                       <section id="compile">
+                               <title>To Compile the App</title>
+                                       <p>To compile the 
<strong>EnhancedAddressBookWS</strong> app, enter the following Ant 
command.</p>                                              
+<source>ant 
+  -f C:\beehive_projects\wsm-addressbook-enhanced\WEB-INF\src\build.xml 
+  clean 
+  build 
+  deploy
+
+<strong>Copy and paste version:</strong>
+
+ant -f C:\beehive_projects\wsm-addressbook-enhanced\WEB-INF\src\build.xml 
clean build deploy</source>
+<p>The command above creates a WAR file named 
<code>EnhancedAddressBookWS.war</code> and saves it
+       at C:\beehive_projects.</p>
+<p>To deploy the app to Tomcat, run the following command:</p>
+
+<source>copy C:\beehive_projects\EnhancedAddressBookWS.war 
%CATALINA_HOME%\webapps /Y</source>
+                       </section>              
+            <section id="verify_deploy"><title>To Verify the Deployment</title>
+                               <p>
+                                       <a class="fork" 
href="http://localhost:8080/EnhancedAddressBookWS/";> 
+                                               
http://localhost:8080/EnhancedAddressBookWS/</a>
+                               </p>
+                               </section>      
+                       </section>
+                       <section id="setup_clients">
+                               <title>To Run the Web Service Client</title>
+                               
+                               <p>To generate and run the client, run the 
following build file.</p>
+<source>ant -f 
C:\beehive_projects\wsm-addressbook-enhanced\WEB-INF\src\build-client.xml</source>
+
+                               <p>Note that you do not need to run a 
particular target within the build files
+                                       <code>client-build.xml</code>. Simply 
run the Ant command 
+                                       shown above and the client will be 
generated in 
+                                       
<code>WEB-INF/build/generated</code>.</p>
+<note>When you compile this app you may see the error messages below.<br/><br/>
+       <code>[wsdl2java] - Unable to find required classes 
(javax.activation.DataHandler and javax.mail.internet.MimeMultipart). 
Attachment support is disabled. </code>
+       <br/><br/>
+       <code> [junit] - Unable to find required classes 
(javax.activation.DataHandler and javax.mail.internet.MimeMultipart). 
Attachment support is disabled. </code>
+       <br/><br/>
+       You can ignore these error messages, since this sample does not rely on 
+       the classes mentioned. 
+       </note>
+                               <p>The client consists of JUnit test cases that 
exercise the 
+                                       contract published in the WSDL. The 
final result shows the 
+                                       number of successfully passed JUnit 
tests.</p>
+                               <p>The code generated in 
<code>/WEB-INF/build/generated/</code> 
+                                       can be used as a template to write your 
own client side 
+                                       applications.</p>
+                               <p>Note that the client-build.xml script makes 
certain 
+                                       assumptions about the Tomcat deployment 
context path, namely, 
+                                       that the app is deployed 
+                                       on the context path 
+                                               
<code>EnhancedAddressBookWS</code>. 
+                                       If the context path is changed from 
this value, the URL in 
+                                       the build-client.xml file must be 
adjusted accordingly. </p>
+                       </section>
+               </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/> &copy; 2004, Apache Software Foundation 
</legal>
+       </footer>
+</document>
\ No newline at end of file

Propchange: 
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/wsm/sample_AddressBookEnhanced.xml
------------------------------------------------------------------------------
    svn:eol-style = native


Reply via email to