Author: steveh
Date: Thu Nov 18 13:45:25 2004
New Revision: 76292
Modified:
incubator/beehive/site/build/site/controls/tutorial_controls.html
incubator/beehive/site/build/site/wsm/datatypes.html
incubator/beehive/site/build/site/wsm/sample_wsm-blank.html
incubator/beehive/site/src/documentation/content/xdocs/controls/tutorial_controls.xml
incubator/beehive/site/src/documentation/content/xdocs/wsm/datatypes.xml
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
Log:
Fixing bad path in "Web Service Project" topic.
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 Thu Nov
18 13:45:25 2004
@@ -355,6 +355,20 @@
</li>
<li>
<a href="#Step+3%3A+Add+a+Parameterized+Method+to+the+Control">Step 3: Add a
Parameterized Method to the Control</a>
+<ul class="minitoc">
+<li>
+<a href="#To+edit+the+Interface+and+Implementation+Files">To edit the
Interface and Implementation Files</a>
+</li>
+<li>
+<a href="#To+Edit+the+Test+JSP+Page">To Edit the Test JSP Page</a>
+</li>
+<li>
+<a href="#To+Compile+and+Redeploy+the+Control">To Compile and Redeploy the
Control</a>
+</li>
+<li>
+<a href="#To+Test+the+Control-N101AF">To Test the Control</a>
+</li>
+</ul>
</li>
</ul>
@@ -484,7 +498,7 @@
<a name="N100FC"></a><a name="To+Create+the+Control%27s+Interface+File"></a>
<h4>To Create the Control's Interface File</h4>
<div style="margin-left: 0 ; border: 2px">
-<p>The interface file is a JAVA file, that defines the public face of your
control. <!--[tbd]-->
+<p>The interface file is a JAVA file that defines the public face of your
control. <!--[tbd]-->
</p>
<p>In the directory <span
class="codefrag">C:/beehive_projects/control_tutorial/WEB-INF/src/hellocontrol</span>,
create a file named <span class="codefrag">Hello.java</span>.</p>
<p>Edit Hello.java so it looks like the following.</p>
@@ -514,9 +528,9 @@
<title>Control Tutorial Test Page</title>
</head>
<netui:body>
+ <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
<h3>Control Tutorial Test Page</h3>
<p>
- <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
Response from the hello() method on the Hello Control: <strong>
<%= helloBean.hello() %> </strong>
</p>
</netui:body>
@@ -557,322 +571,90 @@
<a name="N10166"></a><a
name="Step+3%3A+Add+a+Parameterized+Method+to+the+Control"></a>
<h3>Step 3: Add a Parameterized Method to the Control</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>[TODO: This step is coming soon.]</p>
-</div>
- <!--<section id="step_3">
- <title>Step 3: Navigation</title>
- <section>
- <title>Create a Destination JSP Page</title>
- <p>In the directory
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>,
create a file named <code>page2.jsp</code>.</p>
- <p>Edit page2.jsp so it looks like the following.</p>
- <source><![CDATA[
- ]]></source>
- </section>
- <section>
- <title>Create a Link to the Destination Page</title>
- <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/index.jsp.</p>
- <p>Edit index.jsp so it appears as follows.</p>
- <source><![CDATA[
- ]]></source>
- </section>
- <section>
- <title>Add an Action Method to Handle the Link</title>
- <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf.</p>
- <p>Edit Controller.jpf so it appears as follows.</p>
- <source><![CDATA[
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-
-public class Controller
- extends PageFlowController
-{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- protected Forward begin()
- {
- return new Forward("success");
- }
-
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="page2.jsp")
- }
- )
- public Forward toPage2()
- {
- return new Forward("success");
- }
-}
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
- <section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
- </p>
- <p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
- </section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
- </section>
- </section>
- <section id="step_4">
- <title>Step 4: Submitting Data</title>
- <section>
- <title>To Create a Submission Form</title>
- <p>Edit the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/page2.jsp</code>
so it appears as follows.</p>
- <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>page2.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
- Welcome to page2.jsp!
- </p>
- <p>
- <netui:form action="processData">
- <p>Name:<netui:textBox dataSource="actionForm.name"/>
- <p>Age:<netui:textBox dataSource="actionForm.age"/>
- <p><netui:button type="submit">Submit</netui:button>
- </netui:form>
- </p>
- </netui:body>
-</netui:html>
- ]]></source>
- </section>
- <section>
- <title>To Edit the Controller File to Handle the Submitted
Data</title>
- <p>Open the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf</code>
- </p>
- <p>Edit Controller.jpf so it appears as follows.</p>
- <source><![CDATA[
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-import org.apache.beehive.netui.pageflow.FormData;
-
[EMAIL PROTECTED]
-public class Controller extends PageFlowController
-{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- public Forward begin()
- {
- return new Forward("success");
- }
+<a name="N1016C"></a><a
name="To+edit+the+Interface+and+Implementation+Files"></a>
+<h4>To edit the Interface and Implementation Files</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Edit <span class="codefrag">HelloImpl.jcs</span> so it appears as follows.
Code to add appears in bold type.</p>
+<pre class="code">package hellocontrol;
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="page2.jsp")
- }
- )
- public Forward toPage2()
- {
- return new Forward("success");
- }
+import org.apache.beehive.controls.api.bean.*;
- @Jpf.Action(
- forwards = {
- @Jpf.Forward(name = "success", path = "showData.jsp")
- }
- )
- public Forward processData(ProcessDataForm form)
[EMAIL PROTECTED]
+public class HelloImpl implements Hello
+{
+ public String hello()
{
- System.out.println("Name: " + form.name);
- System.out.println("Age: " + form.age);
- return new Forward("success");
+ return "Hello, World!";
}
- public static class ProcessDataForm extends FormData
+ <strong>public String helloParam( String name )
{
- private int age;
- private String name;
-
- public void setName(String name)
- {
- this.name = name;
- }
+ return "Hello, " + name + "!";
+ }</strong>
+}</pre>
+<p>Save an close <span class="codefrag">HelloImpl.jcs</span>
+</p>
+<p>Edit <span class="codefrag">Hello.java</span> so it appears as follows.
Code to add appears in bold type.</p>
+<pre class="code">package hellocontrol;
- public String getName()
- {
- return this.name;
- }
+import org.apache.beehive.controls.api.bean.ControlInterface;
- public void setAge(int age)
- {
- this.age = age;
- }
[EMAIL PROTECTED]
+public interface Hello
+{
+ public String hello();
- public int getAge()
- {
- return this.age;
- }
- }
-}
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
- <section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
- </p>
- <p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
- </section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
- </section>
- </section>
- <section id="step_5">
- <title>Step 5: Processing and Displaying Data</title>
- <section>
- <title>To Process the Submitted Data</title>
- <p>Edit the processData method in the Controller.jpf file so
it appears as follows. Code to add appears in red.</p>
- <source><![CDATA[
[EMAIL PROTECTED](
- forwards = {
- @Jpf.Forward( name = "success", path = "showData.jsp" )
- }
-)
-public Forward processData( ProcessDataForm form )
-{
- System.out.println("Name: " + form.name);
- System.out.println("Age: " + form.age);
- getRequest().setAttribute("data", form);
- return new Forward("success");
-}
- ]]></source>
- </section>
- <section>
- <title>To Create a JSP Page to Display Submitted Data</title>
- <p>Create a file named displayData.jsp in the directory
[TOMCAT_HOME]/directory/control_tutorial. Edit showData.jsp so it appears as
follows.</p>
- <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>showData.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>Name:<netui:span value="${requestScope.data.name}"/>
- <p>Age:<netui:span value="${requestScope.data.age}"/>
- </netui:body>
-</netui:html>
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
- <section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
- </p>
- <p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
- </section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
- </section>
- </section>
- <section id="summary">
- <title>Summary: Page Flow Tutorial</title>
- <p>This tutorial introduced you to the basics of building web
applications with Beehive Page Flows.</p>
- <p>Concepts and Tasks Introduced in This Tutorial</p>
- <ul>
- <li>JSP files make up the presentation layer of a web
application</li>
- <li>JPF files contain the code, individual Action methods,
that determines the major features of a Workshop web application: how users
navigate from page to page, and how data moves around the application.</li>
- <li>User input data is data bound to Form Beans before the
data is submitted to an Action method.</li>
- <li>You can use the <netui...> tag library to data bind to
Java objects and render them as HTML</li>
- </ul>
- </section>-->
-
+ <strong>public String helloParam( String name );</strong>
+}</pre>
+</div>
+<a name="N10194"></a><a name="To+Edit+the+Test+JSP+Page"></a>
+<h4>To Edit the Test JSP Page</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Edit <span class="codefrag">hello.jsp</span> so it appears as follows.
Code to add appears in bold type.</p>
+<pre class="code"><%@ page language="java"
contentType="text/html;charset=UTF-8"%>
+<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
+<netui:html>
+ <head>
+ <title>Control Tutorial Test Page</title>
+ </head>
+ <netui:body>
+ <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
+ <h3>Control Tutorial Test Page</h3>
+ <p>
+ Response from the hello() method on the Hello Control: <strong>
<%= helloBean.hello() %> </strong>
+ </p>
+ <strong><p>
+ Response from the helloParam() method on the Hello Control:
<strong> <%= helloBean.helloParam("Moon") %> </strong>
+ </p></strong>
+ </netui:body>
+</netui:html></pre>
+<p>Save and close <span class="codefrag">hello.jsp</span>
+</p>
+</div>
+<a name="N101AE"></a><a name="To+Compile+and+Redeploy+the+Control"></a>
+<h4>To Compile and Redeploy the Control</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Compile and redeploy the control with the following And command:</p>
+<pre class="code"> ant
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
+ -Dwebapp.dir=C:\beehive_projects\control_tutorial
+ -Dcontext.path=control_tutorial
+ undeploy
+ build.webapp
+ deploy</pre>
+</div>
+<a name="N101BD"></a><a name="To+Test+the+Control-N101AF"></a>
+<h4>To Test the Control</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Open a web browser and enter the following in the address bar: <a
target="_blank"
href="http://localhost:8080/control_tutorial/hello.jsp";>http://localhost:8080/control_tutorial/hello.jsp</a>
+
+</p>
+<p>You will be directed to the index.jsp page.</p>
+<p>Note the messages on the page: "Hello, World!" and "Hello, Moon!"</p>
+<p>These messages are provided by the Hello control.</p>
+</div>
+</div>
+
<div class="attribution"></div>
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
Modified: incubator/beehive/site/build/site/wsm/datatypes.html
==============================================================================
--- incubator/beehive/site/build/site/wsm/datatypes.html (original)
+++ incubator/beehive/site/build/site/wsm/datatypes.html Thu Nov 18
13:45:25 2004
@@ -350,7 +350,7 @@
<a name="N10038"></a><a name="Attachments"></a>
<h3>Attachments</h3>
<div style="margin-left: 0 ; border: 2px">
-<p>DataHandler types provide attachment support in Apache Axis. If <span
class="codefrag">activation.jar</span> and <span
class="codefrag">mailapi.jar</span> are available, then developers can use
java.awt.Image, javax.mail.internet.MimeMultipart as well as any classes
extending javax.activation.DataHandler to transmit raw data as web service
attachments. See see the <a
href="sample_Dashboard.html#Download+Required+JAR+Files">Petstore Dashboard
Sample</a> for instructions on acquiring these JARs. If these types are used
directly as return values or parameters, then the client must be an Axis
client.</p>
+<p>DataHandler types provide attachment support in Apache Axis. If <span
class="codefrag">activation.jar</span> and <span
class="codefrag">mailapi.jar</span> are available, then developers can use
java.awt.Image, javax.mail.internet.MimeMultipart as well as any classes
extending javax.activation.DataHandler to transmit raw data as web service
attachments. See the <a
href="sample_Dashboard.html#Download+Required+JAR+Files">Petstore Dashboard
Sample</a> for instructions on acquiring these JARs. If these types are used
directly as return values or parameters, then the client must be an Axis
client.</p>
</div>
Modified: incubator/beehive/site/build/site/wsm/sample_wsm-blank.html
==============================================================================
--- incubator/beehive/site/build/site/wsm/sample_wsm-blank.html (original)
+++ incubator/beehive/site/build/site/wsm/sample_wsm-blank.html Thu Nov 18
13:45:25 2004
@@ -330,14 +330,14 @@
deploy.wsm.webapp.runtime</pre>
<p>To build and run the template, run the following Ant command. (Before
running ensure that Tomcat is turned on: <span
class="codefrag">%CATALINA_HOME%\bin\startup.bat</span>. Or use the Ant
command provided in the distribution: <span class="codefrag">ant -f
%BEEHIVE_HOME%\ant\buildWebapp.xml start</span>. If you use the provided Ant
command, you will have to press <span class="codefrag">Ctrl+C</span> to
continue issuing commands in that command window.)</p>
<pre class="code"> ant
- -f ant\buildWebapp.xml
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
-Dwebapp.dir=<Project-Folder>
-Dcontext.path=HelloWorldWS
build.webapp
deploy</pre>
<p>If the HelloWorldWS web service is already deployed, use the redeploy
target:</p>
<pre class="code"> ant
- -f ant\buildWebapp.xml
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
-Dwebapp.dir=<Project-Folder>
-Dcontext.path=HelloWorldWS
build.webapp
Modified:
incubator/beehive/site/src/documentation/content/xdocs/controls/tutorial_controls.xml
==============================================================================
---
incubator/beehive/site/src/documentation/content/xdocs/controls/tutorial_controls.xml
(original)
+++
incubator/beehive/site/src/documentation/content/xdocs/controls/tutorial_controls.xml
Thu Nov 18 13:45:25 2004
@@ -109,7 +109,7 @@
</section>
<section>
<title>To Create the Control's Interface File</title>
- <p>The interface file is a JAVA file, that defines the public
face of your control. <!--[tbd]-->
+ <p>The interface file is a JAVA file that defines the public
face of your control. <!--[tbd]-->
</p>
<p>In the directory
<code>C:/beehive_projects/control_tutorial/WEB-INF/src/hellocontrol</code>,
create a file named <code>Hello.java</code>.</p>
<p>Edit Hello.java so it looks like the following.</p>
@@ -138,9 +138,9 @@
<title>Control Tutorial Test Page</title>
</head>
<netui:body>
+ <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
<h3>Control Tutorial Test Page</h3>
<p>
- <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
Response from the hello() method on the Hello Control: <strong> <%=
helloBean.hello() %> </strong>
</p>
</netui:body>
@@ -176,322 +176,86 @@
</section>
<section>
<title>Step 3: Add a Parameterized Method to the
Control</title>
- <p>[TODO: This step is coming soon.]</p>
- </section>
- <!--<section id="step_3">
- <title>Step 3: Navigation</title>
- <section>
- <title>Create a Destination JSP Page</title>
- <p>In the directory
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial</code>,
create a file named <code>page2.jsp</code>.</p>
- <p>Edit page2.jsp so it looks like the following.</p>
- <source><![CDATA[
- ]]></source>
- </section>
- <section>
- <title>Create a Link to the Destination Page</title>
- <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/index.jsp.</p>
- <p>Edit index.jsp so it appears as follows.</p>
- <source><![CDATA[
- ]]></source>
- </section>
- <section>
- <title>Add an Action Method to Handle the Link</title>
- <p>Open the file
C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf.</p>
- <p>Edit Controller.jpf so it appears as follows.</p>
- <source><![CDATA[
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-
-public class Controller
- extends PageFlowController
-{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- protected Forward begin()
- {
- return new Forward("success");
- }
+ <section>
+ <title>To edit the Interface and Implementation
Files</title>
+ <p>Edit <code>HelloImpl.jcs</code> so it appears as
follows. Code to add appears in bold type.</p>
+<source>package hellocontrol;
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="page2.jsp")
- }
- )
- public Forward toPage2()
- {
- return new Forward("success");
- }
-}
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
- <section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
- </p>
- <p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
- </section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
- </section>
- </section>
- <section id="step_4">
- <title>Step 4: Submitting Data</title>
- <section>
- <title>To Create a Submission Form</title>
- <p>Edit the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/page2.jsp</code>
so it appears as follows.</p>
- <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>page2.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>
- Welcome to page2.jsp!
- </p>
- <p>
- <netui:form action="processData">
- <p>Name:<netui:textBox dataSource="actionForm.name"/>
- <p>Age:<netui:textBox dataSource="actionForm.age"/>
- <p><netui:button type="submit">Submit</netui:button>
- </netui:form>
- </p>
- </netui:body>
-</netui:html>
- ]]></source>
- </section>
- <section>
- <title>To Edit the Controller File to Handle the Submitted
Data</title>
- <p>Open the file
<code>C:/beehive-src/trunk/installed/jakarta-tomcat-5.0.25/webapps/control_tutorial/Controller.jpf</code>
- </p>
- <p>Edit Controller.jpf so it appears as follows.</p>
- <source><![CDATA[
-import org.apache.beehive.netui.pageflow.Forward;
-import org.apache.beehive.netui.pageflow.PageFlowController;
-import org.apache.beehive.netui.pageflow.annotations.Jpf;
-import org.apache.beehive.netui.pageflow.FormData;
-
[EMAIL PROTECTED]
-public class Controller extends PageFlowController
-{
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="index.jsp")
- }
- )
- public Forward begin()
- {
- return new Forward("success");
- }
+import org.apache.beehive.controls.api.bean.*;
- @Jpf.Action(
- forwards={
- @Jpf.Forward(name="success", path="page2.jsp")
- }
- )
- public Forward toPage2()
[EMAIL PROTECTED]
+public class HelloImpl implements Hello
+{
+ public String hello()
{
- return new Forward("success");
+ return "Hello, World!";
}
- @Jpf.Action(
- forwards = {
- @Jpf.Forward(name = "success", path = "showData.jsp")
- }
- )
- public Forward processData(ProcessDataForm form)
+ <strong>public String helloParam( String name )
{
- System.out.println("Name: " + form.name);
- System.out.println("Age: " + form.age);
- return new Forward("success");
- }
+ return "Hello, " + name + "!";
+ }</strong>
+}</source>
+<p>Save an close <code>HelloImpl.jcs</code></p>
+<p>Edit <code>Hello.java</code> so it appears as follows. Code to add appears
in bold type.</p>
+<source>package hellocontrol;
- public static class ProcessDataForm extends FormData
- {
- private int age;
- private String name;
+import org.apache.beehive.controls.api.bean.ControlInterface;
+
[EMAIL PROTECTED]
+public interface Hello
+{
+ public String hello();
+
+ <strong>public String helloParam( String name );</strong>
+}</source>
+ </section>
+
+<section>
+ <title>To Edit the Test JSP Page</title>
+ <p>Edit <code>hello.jsp</code> so it appears as follows. Code to add
appears in bold type.</p>
+ <source><%@ page language="java" contentType="text/html;charset=UTF-8"%>
+<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0";
prefix="netui"%>
+<netui:html>
+ <head>
+ <title>Control Tutorial Test Page</title>
+ </head>
+ <netui:body>
+ <jsp:useBean class="hellocontrol.HelloBean" id="helloBean"
scope="session"/>
+ <h3>Control Tutorial Test Page</h3>
+ <p>
+ Response from the hello() method on the Hello Control: <strong>
<%= helloBean.hello() %> </strong>
+ </p>
+ <strong><p>
+ Response from the helloParam() method on the Hello Control:
<strong> <%= helloBean.helloParam("Moon") %> </strong>
+ </p></strong>
+ </netui:body>
+</netui:html></source>
+ <p>Save and close <code>hello.jsp</code></p>
+</section>
+<section>
+ <title>To Compile and Redeploy the Control</title>
+<p>Compile and redeploy the control with the following And command:</p>
+
+ <source> ant
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
+ -Dwebapp.dir=C:\beehive_projects\control_tutorial
+ -Dcontext.path=control_tutorial
+ undeploy
+ build.webapp
+ deploy</source>
+</section>
- public void setName(String name)
- {
- this.name = name;
- }
-
- public String getName()
- {
- return this.name;
- }
-
- public void setAge(int age)
- {
- this.age = age;
- }
-
- public int getAge()
- {
- return this.age;
- }
- }
-}
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
- <section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
- </p>
- <p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
- </section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
- </section>
- </section>
- <section id="step_5">
- <title>Step 5: Processing and Displaying Data</title>
- <section>
- <title>To Process the Submitted Data</title>
- <p>Edit the processData method in the Controller.jpf file so
it appears as follows. Code to add appears in red.</p>
- <source><![CDATA[
[EMAIL PROTECTED](
- forwards = {
- @Jpf.Forward( name = "success", path = "showData.jsp" )
- }
-)
-public Forward processData( ProcessDataForm form )
-{
- System.out.println("Name: " + form.name);
- System.out.println("Age: " + form.age);
- getRequest().setAttribute("data", form);
- return new Forward("success");
-}
- ]]></source>
- </section>
- <section>
- <title>To Create a JSP Page to Display Submitted Data</title>
- <p>Create a file named displayData.jsp in the directory
[TOMCAT_HOME]/directory/control_tutorial. Edit showData.jsp so it appears as
follows.</p>
- <source><![CDATA[
-<%@ page language="java" contentType="text/html;charset=UTF-8"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0";
prefix="netui-data"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%>
-<%@ taglib uri="http://beehive.apache.org/netui/tags-template-1.0";
prefix="netui-template"%>
-<netui:html>
- <head>
- <title>showData.jsp</title>
- <netui:base/>
- </head>
- <netui:body>
- <p>Name:<netui:span value="${requestScope.data.name}"/>
- <p>Age:<netui:span value="${requestScope.data.age}"/>
- </netui:body>
-</netui:html>
- ]]></source>
- </section>
- <section>
- <title>Compile the Page Flow</title>
- <p>Open a command shell.</p>
- <p>At the command prompt, enter: <code>set
JAVA_HOME=C:\jdk1.5.0</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk</code>
- </p>
- <p>At the command prompt, enter: <code>beehiveEnv.cmd</code>
- </p>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\test\ant</code>
- </p>
- <p>At the command prompt, enter: <code>ant -f buildWebapp.xml
build.webapp
-Dwebapp.dir=C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\webapps\control_tutorial</code>
- </p>
- </section>
- <section>
- <title>To Start the Tomcat Server</title>
- <p>At the command prompt, enter: <code>cd
C:\beehive-src\trunk\installed\jakarta-tomcat-5.0.25\bin</code>
- </p>
- <p>At the command prompt, enter: <code>startup.bat</code>
- </p>
- <p>Leave this command shell open, so that you can stop and
restart Tomcat when necessary.</p>
- </section>
<section>
- <title>To Test the Page Flow Web Application</title>
- <p>Open a web browser and enter the following in the address
bar: <code>http://localhost:8080/control_tutorial</code>
+ <title>To Test the Control</title>
+ <p>Open a web browser and enter the following in the address
bar: <fork
href="http://localhost:8080/control_tutorial/hello.jsp";>http://localhost:8080/control_tutorial/hello.jsp</fork>
</p>
<p>You will be directed to the index.jsp page.</p>
- <p>Click the link.</p>
- <p>You will be directed to page2.jsp.</p>
+ <p>Note the messages on the page: "Hello, World!" and "Hello,
Moon!"</p>
+ <p>These messages are provided by the Hello control.</p>
</section>
- <section>
- <title>Shutdown Tomcat Server</title>
- <p>At the command prompt, enter: <code>shutdown.bat</code>
- </p>
</section>
- </section>
- <section id="summary">
- <title>Summary: Page Flow Tutorial</title>
- <p>This tutorial introduced you to the basics of building web
applications with Beehive Page Flows.</p>
- <p>Concepts and Tasks Introduced in This Tutorial</p>
- <ul>
- <li>JSP files make up the presentation layer of a web
application</li>
- <li>JPF files contain the code, individual Action methods,
that determines the major features of a Workshop web application: how users
navigate from page to page, and how data moves around the application.</li>
- <li>User input data is data bound to Form Beans before the
data is submitted to an Action method.</li>
- <li>You can use the <netui...> tag library to data bind to
Java objects and render them as HTML</li>
- </ul>
- </section>-->
- </body>
+ </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
Modified:
incubator/beehive/site/src/documentation/content/xdocs/wsm/datatypes.xml
==============================================================================
--- incubator/beehive/site/src/documentation/content/xdocs/wsm/datatypes.xml
(original)
+++ incubator/beehive/site/src/documentation/content/xdocs/wsm/datatypes.xml
Thu Nov 18 13:45:25 2004
@@ -29,7 +29,7 @@
<section>
<title>Attachments</title>
-<p>DataHandler types provide attachment support in Apache Axis. If
<code>activation.jar</code> and <code>mailapi.jar</code> are available, then
developers can use java.awt.Image, javax.mail.internet.MimeMultipart as well as
any classes extending javax.activation.DataHandler to transmit raw data as web
service attachments. See see the <link
href="sample_Dashboard.html#Download+Required+JAR+Files">Petstore Dashboard
Sample</link> for instructions on acquiring these JARs. If these types are
used directly as return values or parameters, then the client must be an Axis
client.</p>
+<p>DataHandler types provide attachment support in Apache Axis. If
<code>activation.jar</code> and <code>mailapi.jar</code> are available, then
developers can use java.awt.Image, javax.mail.internet.MimeMultipart as well as
any classes extending javax.activation.DataHandler to transmit raw data as web
service attachments. See the <link
href="sample_Dashboard.html#Download+Required+JAR+Files">Petstore Dashboard
Sample</link> for instructions on acquiring these JARs. If these types are
used directly as return values or parameters, then the client must be an Axis
client.</p>
</section>
<section>
Modified:
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
==============================================================================
---
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
(original)
+++
incubator/beehive/site/src/documentation/content/xdocs/wsm/sample_wsm-blank.xml
Thu Nov 18 13:45:25 2004
@@ -26,14 +26,14 @@
deploy.wsm.webapp.runtime</source>
<p>To build and run the template, run the following Ant command. (Before
running ensure that Tomcat is turned on:
<code>%CATALINA_HOME%\bin\startup.bat</code>. Or use the Ant command provided
in the distribution: <code>ant -f %BEEHIVE_HOME%\ant\buildWebapp.xml
start</code>. If you use the provided Ant command, you will have to press
<code>Ctrl+C</code> to continue issuing commands in that command window.)</p>
<source> ant
- -f ant\buildWebapp.xml
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
-Dwebapp.dir=<Project-Folder>
-Dcontext.path=HelloWorldWS
build.webapp
deploy</source>
<p>If the HelloWorldWS web service is already deployed, use the redeploy
target:</p>
<source> ant
- -f ant\buildWebapp.xml
+ -f %BEEHIVE_HOME%\ant\buildWebapp.xml
-Dwebapp.dir=<Project-Folder>
-Dcontext.path=HelloWorldWS
build.webapp
