Author: ekoneil
Date: Tue May 10 13:32:29 2005
New Revision: 169518
URL: http://svn.apache.org/viewcvs?rev=169518&view=rev
Log:
Complete the move of the system controls from ControlHaus to Apache SVN.
This change includes the Forrest-ized documentation for the controls and the
samples for the controls. None of these samples are wired into the
distribution (and likely won't be for 1.0), but the source is now here so that
they can be evolved and versioned as part of Beehive.
Thanks to Chad Schoettger for helping get this wired up.
BB: self
DRT: Beehive pass
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejb-annotations.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbControlTutorial.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbDoc.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbc-annotations.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbcControlDevGuide.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbcControlTutorial.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jms/
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jms/jms-annotations.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jms/jmsControlTutorial.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jms/jmsDoc.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/webservices-annotations.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/webservicesControlTutorial.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/webservices/webservicesDoc.xml
incubator/beehive/trunk/system-controls/samples/
incubator/beehive/trunk/system-controls/samples/ejb/
incubator/beehive/trunk/system-controls/samples/ejb/build.xml
incubator/beehive/trunk/system-controls/samples/ejb/client/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/ControlTestCase.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/DefaultContainerContext.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/DefaultControlHandle.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/EJBControlClient.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/EJBControlTestCase.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/HelloBeanClient.java
incubator/beehive/trunk/system-controls/samples/ejb/client/org/apache/beehive/controls/system/ejb/sample/client/SingleControlTestCase.java
incubator/beehive/trunk/system-controls/samples/ejb/control/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/system/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/system/ejb/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/system/ejb/sample/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/system/ejb/sample/control/
incubator/beehive/trunk/system-controls/samples/ejb/control/org/apache/beehive/controls/system/ejb/sample/control/HelloEJBControl.jcx
incubator/beehive/trunk/system-controls/samples/ejb/ejb/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/META-INF/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/META-INF/ejb-jar.xml
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/HelloBean.java
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/HelloHome.java
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/HelloLocal.java
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/HelloLocalHome.java
incubator/beehive/trunk/system-controls/samples/ejb/ejb/org/apache/beehive/controls/system/ejb/sample/bean/HelloRemote.java
incubator/beehive/trunk/system-controls/samples/jdbc/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/Controller.jpf
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/META-INF/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/META-INF/context.xml
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/build.properties
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/build.xml
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/controls/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/controls/PopulateDBCtrl.jcx
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/controls/SimpleDBControl.jcx
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/servlet/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/servlet/DerbyListener.java
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/shared/
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/src/shared/SharedFlow.jpfs
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/WEB-INF/web.xml
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/demo.jsp
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/details.jsp
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/error.jsp
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/index.jsp
incubator/beehive/trunk/system-controls/samples/jdbc/jdbcControlSample/sql.jsp
incubator/beehive/trunk/system-controls/samples/jms/
incubator/beehive/trunk/system-controls/samples/jms/build.xml
incubator/beehive/trunk/system-controls/samples/jms/src/
incubator/beehive/trunk/system-controls/samples/jms/src/org/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/ControlTestCase.java
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/DefaultContainerContext.java
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/DefaultControlHandle.java
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/OrderQueue.jcx
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/SampleQueue.jcx
incubator/beehive/trunk/system-controls/samples/jms/src/org/apache/beehive/controls/system/jms/samples/TestOrderQueue.java
incubator/beehive/trunk/system-controls/samples/webservice/
incubator/beehive/trunk/system-controls/samples/webservice/amazon/
incubator/beehive/trunk/system-controls/samples/webservice/amazon/README.txt
incubator/beehive/trunk/system-controls/samples/webservice/amazon/build.xml
incubator/beehive/trunk/system-controls/samples/webservice/amazon/junit/
incubator/beehive/trunk/system-controls/samples/webservice/amazon/junit/AmazonCommerceTest.java
incubator/beehive/trunk/system-controls/samples/webservice/amazon/junit/log4j.properties
incubator/beehive/trunk/system-controls/samples/webservice/amazon/schemas/
incubator/beehive/trunk/system-controls/samples/webservice/amazon/schemas/AWSAlexa.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/amazon/schemas/AWSECommerceService.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/common/
incubator/beehive/trunk/system-controls/samples/webservice/common/src/
incubator/beehive/trunk/system-controls/samples/webservice/common/src/test/
incubator/beehive/trunk/system-controls/samples/webservice/common/src/test/ControlTestCase.java
incubator/beehive/trunk/system-controls/samples/webservice/google/
incubator/beehive/trunk/system-controls/samples/webservice/google/build.xml
incubator/beehive/trunk/system-controls/samples/webservice/google/junit/
incubator/beehive/trunk/system-controls/samples/webservice/google/junit/model/
incubator/beehive/trunk/system-controls/samples/webservice/google/junit/model/GoogleControlTest.java
incubator/beehive/trunk/system-controls/samples/webservice/google/rpc_schemas/
incubator/beehive/trunk/system-controls/samples/webservice/google/rpc_schemas/GoogleSearch.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/google/servlet/
incubator/beehive/trunk/system-controls/samples/webservice/google/servlet/GoogleServlet.java
incubator/beehive/trunk/system-controls/samples/webservice/lib/
incubator/beehive/trunk/system-controls/samples/webservice/lib/commons-cli-1.0.jar
(with props)
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/README.txt
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/build.xml
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/doc_schemas/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/doc_schemas/SoapMessageHandlersSample.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/doc_schemas/StockQuoteImpl.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/doc_schemas/WebParamDocumentLiteralSample.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/log4j.properties
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/header/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/header/HeaderTest.java
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/header/SignException.java
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/header/SignatureUtilities.java
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/webparam/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/webparam/WebParamDocumentLiteralSampleTest.java
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/junit/org/wsm/samples/client/webparam/WebParamRpcLiteralSampleTest.java
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/rpc_schemas/
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/rpc_schemas/RpcEncodedSample.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/wsm_samples_client/rpc_schemas/RpcLiteralSample.wsdl
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/README.txt
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/build.xml
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/junit/
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/junit/SimpleWebSericeTest.java
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/schemas/
incubator/beehive/trunk/system-controls/samples/webservice/xmlbeans/schemas/AddressBook.wsdl
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/site.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/tutorial/tut_dbdrivenwebapp.xml
incubator/beehive/trunk/system-controls/src/ejb/build.xml
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=169518&r1=169517&r2=169518&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
Tue May 10 13:32:29 2005
@@ -17,6 +17,13 @@
<tutorial_control label="Controls"
href="controls/tutorial_controls.html"/>
<tutorial_wsm label="Web Services" href="wsm/tutorial_wsm.html"/>
<!--<tut_dbwebapp label="DB-Driven Web App"
href="tutorial/tut_dbdrivenwebapp.html" />-->
+ <tutorial_system-controls label="System Controls">
+ <control label="EJB Control Tutorial"
href="system-controls/ejb/ejbControlTutorial.html"/>
+ <control label="JDBC Control Tutorial"
href="system-controls/jdbc/jdbcControlTutorial.html"/>
+ <control label="JMS Control Tutorial"
href="system-controls/jms/jmsControlTutorial.html"/>
+ <control label="Webservices Control Tutorial"
href="system-controls/webservices/webservicesControlTutorial.html"/>
+ </tutorial_system-controls>
+
</tutorials>
<pageflow label="Page Flows">
<pageflow_getting_started label="Getting Started"
href="pageflow/getting_started.html"/>
@@ -41,6 +48,12 @@
<control_prog label="Control Programming"
href="controls/controlsProgramming.html"/>
<control_contain label="Controls Containment"
href="controls/controlsContainment.html"/>
</controls>
+ <controls label="System Controls">
+ <ejb_control label="Ejb Control"
href="system-controls/ejb/ejbDoc.html"/>
+ <jdbc_control label="Jdbc Control"
href="system-controls/jdbc/jdbcControlDevGuide.html"/>
+ <jms_control label="Jms Control"
href="system-controls/jms/jmsDoc.html"/>
+ <webservices_control label="Web Services Control"
href="system-controls/webservices/webservicesDoc.html"/>
+ </controls>
<wsm label="Web Services">
<wsm_getting_started label="Getting Started"
href="wsm/getting_started.html"/>
<wsm_overview label="Web Services Overview"
href="wsm/wsm_overview.html"/>
@@ -75,6 +88,13 @@
<netui_config label="beehive-netui-config.xml"
href="pageflow/config/beehive-netui-config.html"/>
<netui_api label="Page Flow Javadoc"
href="apidocs/classref_pageflows/index.html"/>
</netui>
+ <system-controls label="System Controls">
+ <control label="System Controls Javadoc"
href="apidocs/classref_systemcontrols/index.html"/>
+ <control label="Ejb Control Annotations"
href="system-controls/ejb/ejb-annotations.html"/>
+ <control label="Jdbc Control Annotations"
href="system-controls/jdbc/jdbc-annotations.html"/>
+ <control label="Jms Control Annotations"
href="system-controls/jms/jms-annotations.html"/>
+ <control label="Webservices Control Annotations"
href="system-controls/webservices/webservices-annotations.html"/>
+ </system-controls>
<ws label="Web Services">
<control label="Web Services Annotations"
href="wsm/annotations/wsm_annotations.html"/>
<ws label="Web Services Javadoc"
href="apidocs/classref_wsm/index.html"/>
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejb-annotations.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejb-annotations.xml?rev=169518&view=auto
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejb-annotations.xml
(added)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejb-annotations.xml
Tue May 10 13:32:29 2005
@@ -0,0 +1,19 @@
+<?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>Ejb Control Annotations</title>
+ </header>
+ <body>
+ <section>
+ <title>Ejb Control Annotations</title>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/ejb/EJBControl.EJBHome.html">@EJBControl.EJBHome</a></p>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/ejb/EJBControl.JNDIContextEnv/EJBControl.JNDIContextEnv.html">@EJBControl.JNDIContextEnv</a></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/>
+ © 2005, Apache Software Foundation
+ </legal>
+ </footer>
+</document>
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbControlTutorial.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbControlTutorial.xml?rev=169518&view=auto
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbControlTutorial.xml
(added)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbControlTutorial.xml
Tue May 10 13:32:29 2005
@@ -0,0 +1,75 @@
+<?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>EJB Control Tutorial</title>
+ </header>
+ <body>
+ <section>
+ <title>Tutorial Overview</title>
+
+ <p>The EJB Control is an extensible control, and you do not use it
directly. To create an EJB control
+ for an EJB, you would create a control extending the EJB
Control. An extended EJB control can
+ only represent one EJB, so you must create one for each
EJB.
+ </p>
+ </section>
+ <section>
+ <title>Extending the EJB control</title>
+
+ <ol>
+ <li>Create a Java interface extending the appropriate EJB
Control interface. If the EJB is a
+ session bean, you must extend
org.apache.beehive.controls.system.ejb.SessionEJBControl, or if it is an
+ entity bean, extend
org.apache.beehive.controls.system.ejb.EntityEJBControl.</li>
+
+ <li>Annotate the Java interface with @ControlExtension
+
(org.apache.beehive.controls.api.bean.ControlExtension), so the Control
Annotation
+ Processor will know that the Java interface is a
control extension.</li>
+
+ <li>Change the file extension of the Java interface from
.java to .jcx.</li>
+
+ <li>Have the Java interface also extend the EJB's home and
business interfaces. The
+ business interface may either by the EJB's local
interface or the remote interface.</li>
+
+ <li>Specifiy how the EJB control should lookup the EJB. To
lookup the EJB by its JNDI name,
+ set the EJB control's @EJBHome.jndiName annotation
to the EJB's JNDI name. To lookup
+ the EJB using an EJB link, set the EJB control's
@EJBHome.ejbLink annotation to the name
+ of the EJB link. (see Annotation).</li>
+
+ <li>If the EJB control uses JNDI to look up an EJB, you
may optionally specify the JNDI context
+ environment properties using the @JNDIContextEnv
annotation (see Annotation).</li>
+ </ol>
+ </section>
+ <section>
+ <title>EJB Control Extension Example</title>
+
+ <source>
+package org.apache.beehive.controls.system.ejb.sample.control;
+
+import org.apache.beehive.controls.api.bean.ControlExtension;
+import org.apache.beehive.controls.system.ejb.SessionEJBControl;
+import org.apache.beehive.controls.system.ejb.EJBControl.EJBHome;
+import org.apache.beehive.controls.system.ejb.EJBControl.JNDIContextEnv;
+import org.apache.beehive.controls.system.ejb.sample.bean.HelloHome;
+import org.apache.beehive.controls.system.ejb.sample.bean.HelloRemote;
+
[EMAIL PROTECTED]
[EMAIL PROTECTED](
+ jndiName="org.apache.beehive.controls.system.ejb.sample.HelloHome")
[EMAIL PROTECTED](
+ contextFactory="weblogic.jndi.WLInitialContextFactory",
+ providerURL="t3://localhost:7001",
+ principal="weblogic",
+ credentials="weblogic")
+public interface HelloEJBControl
+ extends SessionEJBControl, HelloHome, HelloRemote
+{
+}
+ </source>
+
+
+ <p>This code is part of the EJB Control samples that is available
in the samples directory of
+ the Beehive source tree.</p>
+
+ </section>
+ </body>
+</document>
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbDoc.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbDoc.xml?rev=169518&view=auto
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbDoc.xml
(added)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/ejb/ejbDoc.xml
Tue May 10 13:32:29 2005
@@ -0,0 +1,102 @@
+<?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>EJB Control Overview</title>
+ </header>
+ <body>
+ <section>
+ <title>Overview</title>
+
+ <p>The EJB control makes it easy for you to use an existing,
deployed EJB from within an application
+ by relieving you of all the preparatory work prior to
invoking a method on an EJB's interface
+ to perform tasks. The EJB control automatically manages
locating and referencing the EJB
+ instance, and directs method invocations to the correct
instance of the target EJB.</p>
+
+ <p>Here is an example of the code required to invoke a single
method on an exposed EJB using standard
+ J2EE APIs:</p>
+
+ <source>
+Trader trader = null;
+try
+{
+ InitialContext ic = new InitialContext();
+ TraderHome home = (TraderHome)ic.lookup("MyTraderBean");
+ Trader trader = home.create();
+ TradeResult tradeResult = trader.buy(stock, shares);
+ return tradeResult;
+}
+catch (NamingException ne)
+{
+ ...
+}
+catch (CreateException ce)
+{
+ ...
+}
+catch (RemoteException re)
+{
+ ...
+}
+finally
+{
+ if (trader != null)
+ trader.remove();
+}
+ </source>
+
+ <p>The code can be reduced to the following using the EJB
Control:</p>
+
+ <source>
[EMAIL PROTECTED]
+TraderControlBean traderControl;
+
+try
+{
+ TradeResult tradeResult = traderControl.buy(stock, shares);
+ return tradeResult;
+}
+catch (RemoteException re)
+{
+ ...
+}
+finally
+{
+ if (traderControl != null)
+ traderControl.remove();
+}
+ </source>
+
+ <p>You can access EJBs on a different server with an EJB control,
provided the server hosting
+ the EJB control and the server to which the target EJB is
deployed are in the same domain.</p>
+ </section>
+ <section>
+ <title>Annotations</title>
+
+ <p>The EJB control contains the following TYPE/FIELD level
annotation:</p>
+ <p><strong>@EJBHome</strong></p>
+
+ <p>Specifies the target EJB's home interface for the EJB
control.</p>
+ <table>
+
<tr><th>Attribute</th><th>Value</th><th>Description</th></tr>
+ <tr><td>jndiName</td><td>String</td><td>Specifies the
JNDI name of the target EJB's home interface (e.g. EJBNameHome) The JNDI name
specified may be an URL using the JNDI protocol (e.g. jndi://username:[EMAIL
PROTECTED]:7001/my.resource.jndi.object).</td></tr>
+
+ <tr><td>ejbLink</td><td>String</td><td>Specifies the
name of the target EJB using the application relative path to the EJB JAR. This
syntax causes the runtime to use an application scoped name rather than a
global JNDI name when locating the referenced EJB. The naming syntax is
EJBJAR#BeanName (e.g. CustomerData.jar#CreditCard).</td></tr>
+ </table>
+
+ <p>Note: A value must be specified for exactly one of the
attributes.</p>
+
+ <p><strong>@JNDIContextEnv</strong></p>
+ <p>Specifies the environment properties for the JNDI context
that will be used to lookup the target EJB. This attribute is optional. If you
are using an URL with the JNDI protocol or if you want to use a JNDI context
with the default envirnoment properties, you do not need a specify any values
for this attribute.</p>
+
+ <table>
+
<tr><th>Attribute</th><th>Value</th><th>Description</th></tr>
+
<tr><td>contextFactory</td><td>String</td><td>Specifies the name of the initial
context factory class (e.g. weblogic.jndi.WLInitialContextFactory)</td></tr>
+ <tr><td>providerURL</td><td>String</td><td>Specifies
the URL of the service provider (e.g. t3://localhost:7001)</td></tr>
+ <tr><td>principal</td><td>String</td><td>Specifies the
identity of the principal for authenticating the caller to the service (e.g.
username)</td></tr>
+ <tr><td>credentials</td><td>String</td><td>Specifies
the credentials of the principal for authenticating the caller to the service
(e.g. password)</td></tr>
+ </table>
+ </section>
+
+ </body>
+</document>
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbc-annotations.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbc-annotations.xml?rev=169518&view=auto
==============================================================================
---
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbc-annotations.xml
(added)
+++
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/system-controls/jdbc/jdbc-annotations.xml
Tue May 10 13:32:29 2005
@@ -0,0 +1,22 @@
+<?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>Jdbc Control Annotations</title>
+ </header>
+ <body>
+ <section>
+ <title>Jdbc Control Annotations</title>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/jdbc/JdbcControl.ConnectionDataSource.html">@JdbcControl.ConnectionDataSource</a></p>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/jdbc/JdbcControl.ConnectionDriver.html">@JdbcControl.ConnectionDriver</a></p>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/jdbc/JdbcControl.ConnectionOptions.html">@JdbcControl.ConnectionOptions</a></p>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/jdbc/JdbcControl.SQL.html">@JdbcControl.SQL</a></p>
+ <p><a
href="../../apidocs/classref_systemcontrols/org/apache/beehive/controls/system/jdbc/JdbcControl.TypeMapper.html">@JdbcControl.TypeMapper</a></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/>
+ © 2005, Apache Software Foundation
+ </legal>
+ </footer>
+</document>
