Author: steveh Date: Thu Dec 2 15:57:28 2004 New Revision: 109597 URL: http://svn.apache.org/viewcvs?view=rev&rev=109597 Log: BEEHIVE-114: ControlsProgramming.doc in multiple location BEEHIVE-119: Tutorial error - netui tags not closed properly Removed: incubator/beehive/site/build/site/ControlProgramming.pdf incubator/beehive/site/build/site/Controls.html incubator/beehive/site/build/site/ControlsOverview.html incubator/beehive/site/build/site/ControlsProgramming.html incubator/beehive/site/src/documentation/content/ControlProgramming.pdf incubator/beehive/site/src/documentation/content/ControlsOverview.html incubator/beehive/site/src/documentation/content/ControlsProgramming.html incubator/beehive/site/src/documentation/content/xdocs/controls.xml Modified: incubator/beehive/site/build/site/controls/controlsProgramming.html incubator/beehive/site/build/site/controls/sample_controls-db.html incubator/beehive/site/build/site/faq.html incubator/beehive/site/build/site/pageflow/pageflow_jsp.html incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml incubator/beehive/site/src/documentation/content/xdocs/faq.xml incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml
Deleted: /incubator/beehive/site/build/site/ControlProgramming.pdf Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/ControlProgramming.pdf?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/build/site/Controls.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/Controls.html?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/build/site/ControlsOverview.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/ControlsOverview.html?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/build/site/ControlsProgramming.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/ControlsProgramming.html?view=auto&rev=109596 ============================================================================== Modified: incubator/beehive/site/build/site/controls/controlsProgramming.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/controls/controlsProgramming.html?view=diff&rev=109597&p1=incubator/beehive/site/build/site/controls/controlsProgramming.html&r1=109596&p2=incubator/beehive/site/build/site/controls/controlsProgramming.html&r2=109597 ============================================================================== --- incubator/beehive/site/build/site/controls/controlsProgramming.html (original) +++ incubator/beehive/site/build/site/controls/controlsProgramming.html Thu Dec 2 15:57:28 2004 @@ -1178,7 +1178,7 @@ import org.apache.beehive.controls.api.bean.ControlExtension; -<strong>@ControlExtension</strong> +<strong>@ControlInterface</strong> @Destination(type=JmsMessageControl.QUEUE, name=”queue.orders”) <strong>public interface OrderQueue extends JmsMessageControl</strong> { @@ -1567,10 +1567,11 @@ peerContext.addCallbackListener( new ControlBeanContext.LifeCycle() { - public void onCreate() { …. }; - public void onAcquire() { … }; - public void onRelease() { … }; - });</pre> + public void onCreate() { ... }; + public void onAcquire() { ... }; + public void onRelease() { ... }; + } + );</pre> </div> </div> <a name="N10574"></a><a name="13.3+JavaBean+Context+Events"></a> Modified: incubator/beehive/site/build/site/controls/sample_controls-db.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/controls/sample_controls-db.html?view=diff&rev=109597&p1=incubator/beehive/site/build/site/controls/sample_controls-db.html&r1=109596&p2=incubator/beehive/site/build/site/controls/sample_controls-db.html&r2=109597 ============================================================================== --- incubator/beehive/site/build/site/controls/sample_controls-db.html (original) +++ incubator/beehive/site/build/site/controls/sample_controls-db.html Thu Dec 2 15:57:28 2004 @@ -377,36 +377,11 @@ </pre> <p>The Java source for EmployeeDBControl is available at <span class="codefrag">BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample/EmployeeDBControl.jcx</span>.</p> </div> - -<!-- </p> - <section> - <title>Structure of the Database Control</title> - </section> - <p>The Database Control is a <em>base control</em>: it is designed to be extented by a <em>control extension</em>. Base controls package the boilerplate code, the common routines that any code must execute in order to access a resource. Control extensions contain the interesting, variable aspects of accessing the resource. If this model were applied to the case of JMS access, the base control would contain the boilerplate tasks consisting of obtaining sessions, referencing queues, etc. The control extension configures the base control for access to a particular JMS resource. The control extension would anwser the questions: What the JNDI name of the JMS resources? What message should be sent? -</p><p> -In the case of a database resource, The boilerplate parts of the code are tasks such as making a JDBC connection with the database and handling the resultsets, tasks specified in the base control. An extension of the base database control configures the base control by setting the JNDI name the target database, the SQL statements used to communicate with the database, the maximum size of resultsets that the control will accept, etc. -</p><p> -Not all base controls need to extended to be used: they can be designed to be used directly by the client, without an control extension intermediary. But in the case of the database Database Control is designed in order to be extended by another class, which answers all of the parameter questions: the interesting parts of accessing the particular resource, whatever it is. An example of a control extention off of the base Database Control is EmployeeDBControl.jcx (located at BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample). The fragment below shows how the control extension configures the base control for a JDBC connection to a particular Derby database. - </p> -<p><strong>EmployeeDBControl.jcx</strong></p> -<source>@ControlExtension [EMAIL PROTECTED](jndiName="jdbc:derby:build/databaseControlTestDB;create=true") -public interface EmployeeDBControl extends DatabaseControl -{ - ... -} -</source> - <ul> - <li>Metadata annotations: reduces configuring the control for resource access to a matter of setting properties throught annotations. To a client, the control appears as a JavaBean that is instantiated and operated upon for resource access. Base controls configure the container using annotations. Control extensions configure the base.</li> ---> -<!-- <li>events (<link href="http://incubator.apache.org/beehive/ControlsOverview.html#Operations";>http://incubator.apache.org/beehive/ControlsOverview.html#Operations</link>)</li> - <li>resource management (<link href="http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management";>http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management</link>).... [todo]</li> - </ul>--> -<a name="N10090"></a><a name="Building+the+Database+Control"></a> +<a name="N1008C"></a><a name="Building+the+Database+Control"></a> <h3>Building the Database Control</h3> <div style="margin-left: 0 ; border: 2px"> <p>To build <span class="codefrag">dbControl.jar</span> run the following Ant command:</p> Modified: incubator/beehive/site/build/site/faq.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/faq.html?view=diff&rev=109597&p1=incubator/beehive/site/build/site/faq.html&r1=109596&p2=incubator/beehive/site/build/site/faq.html&r2=109597 ============================================================================== --- incubator/beehive/site/build/site/faq.html (original) +++ incubator/beehive/site/build/site/faq.html Thu Dec 2 15:57:28 2004 @@ -362,7 +362,7 @@ regular JavaBeans, with an enhanced authoring model, an extensibility model, and a configuration model using JSR 175 annotations. To find out more about controls look at - <a href="./Controls.html">Controls</a>.</dd> + <a href="controls/controlsOverview.html">Controls Overview</a>.</dd> </dl> <dl> Modified: incubator/beehive/site/build/site/pageflow/pageflow_jsp.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/build/site/pageflow/pageflow_jsp.html?view=diff&rev=109597&p1=incubator/beehive/site/build/site/pageflow/pageflow_jsp.html&r1=109596&p2=incubator/beehive/site/build/site/pageflow/pageflow_jsp.html&r2=109597 ============================================================================== --- incubator/beehive/site/build/site/pageflow/pageflow_jsp.html (original) +++ incubator/beehive/site/build/site/pageflow/pageflow_jsp.html Thu Dec 2 15:57:28 2004 @@ -405,15 +405,15 @@ <%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%> <netui:html></strong> <head> - <title>...title> + <title>...</title> <strong><netui:base/></strong> - <head> + </head> <strong><netui:body></strong> .. .. .. - <strong><netui:body> -<netui:html></strong> + <strong></netui:body> +</netui:html></strong> </pre> </div> @@ -463,7 +463,7 @@ </p> <pre class="code"> -<<strong>netui:anchor action="login"</strong>>Login!</a> +<<strong>netui:anchor action="login"</strong>>Login!</netui:anchor> </pre> <p> When the link is displayed on-screen, clicking it will cause control to Deleted: /incubator/beehive/site/src/documentation/content/ControlProgramming.pdf Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/ControlProgramming.pdf?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/src/documentation/content/ControlsOverview.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/ControlsOverview.html?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/src/documentation/content/ControlsProgramming.html Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/ControlsProgramming.html?view=auto&rev=109596 ============================================================================== Deleted: /incubator/beehive/site/src/documentation/content/xdocs/controls.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/xdocs/controls.xml?view=auto&rev=109596 ============================================================================== Modified: incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml?view=diff&rev=109597&p1=incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml&r1=109596&p2=incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml&r2=109597 ============================================================================== --- incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml (original) +++ incubator/beehive/site/src/documentation/content/xdocs/controls/controlsProgramming.xml Thu Dec 2 15:57:28 2004 @@ -625,7 +625,7 @@ import org.apache.beehive.controls.api.bean.ControlExtension; -<strong>@ControlExtension</strong> +<strong>@ControlInterface</strong> @Destination(type=JmsMessageControl.QUEUE, name=âqueue.ordersâ) <strong>public interface OrderQueue extends JmsMessageControl</strong> { @@ -975,10 +975,11 @@ peerContext.addCallbackListener( new ControlBeanContext.LifeCycle() { - public void onCreate() { â. }; - public void onAcquire() { â }; - public void onRelease() { â }; - });</source> + public void onCreate() { ... }; + public void onAcquire() { ... }; + public void onRelease() { ... }; + } + );</source> </section> </section> <section> Modified: incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml?view=diff&rev=109597&p1=incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml&r1=109596&p2=incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml&r2=109597 ============================================================================== --- incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml (original) +++ incubator/beehive/site/src/documentation/content/xdocs/controls/sample_controls-db.xml Thu Dec 2 15:57:28 2004 @@ -92,32 +92,7 @@ </source> <p>The Java source for EmployeeDBControl is available at <code>BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample/EmployeeDBControl.jcx</code>.</p> </section> - -<!-- </p> - <section> - <title>Structure of the Database Control</title> - </section> - <p>The Database Control is a <em>base control</em>: it is designed to be extented by a <em>control extension</em>. Base controls package the boilerplate code, the common routines that any code must execute in order to access a resource. Control extensions contain the interesting, variable aspects of accessing the resource. If this model were applied to the case of JMS access, the base control would contain the boilerplate tasks consisting of obtaining sessions, referencing queues, etc. The control extension configures the base control for access to a particular JMS resource. The control extension would anwser the questions: What the JNDI name of the JMS resources? What message should be sent? -</p><p> -In the case of a database resource, The boilerplate parts of the code are tasks such as making a JDBC connection with the database and handling the resultsets, tasks specified in the base control. An extension of the base database control configures the base control by setting the JNDI name the target database, the SQL statements used to communicate with the database, the maximum size of resultsets that the control will accept, etc. -</p><p> -Not all base controls need to extended to be used: they can be designed to be used directly by the client, without an control extension intermediary. But in the case of the database Database Control is designed in order to be extended by another class, which answers all of the parameter questions: the interesting parts of accessing the particular resource, whatever it is. An example of a control extention off of the base Database Control is EmployeeDBControl.jcx (located at BEEHIVE_HOME/samples/EmployeeWS/WEB-INF/src/org/apache/beehive/sample). The fragment below shows how the control extension configures the base control for a JDBC connection to a particular Derby database. - </p> -<p><strong>EmployeeDBControl.jcx</strong></p> -<source>@ControlExtension [EMAIL PROTECTED](jndiName="jdbc:derby:build/databaseControlTestDB;create=true") -public interface EmployeeDBControl extends DatabaseControl -{ - ... -} -</source> - <ul> - <li>Metadata annotations: reduces configuring the control for resource access to a matter of setting properties throught annotations. To a client, the control appears as a JavaBean that is instantiated and operated upon for resource access. Base controls configure the container using annotations. Control extensions configure the base.</li> ---> -<!-- <li>events (<link href="http://incubator.apache.org/beehive/ControlsOverview.html#Operations";>http://incubator.apache.org/beehive/ControlsOverview.html#Operations</link>)</li> - <li>resource management (<link href="http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management";>http://incubator.apache.org/beehive/ControlsOverview.html#Resource%20Management</link>).... [todo]</li> - </ul>--> <section> Modified: incubator/beehive/site/src/documentation/content/xdocs/faq.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/xdocs/faq.xml?view=diff&rev=109597&p1=incubator/beehive/site/src/documentation/content/xdocs/faq.xml&r1=109596&p2=incubator/beehive/site/src/documentation/content/xdocs/faq.xml&r2=109597 ============================================================================== --- incubator/beehive/site/src/documentation/content/xdocs/faq.xml (original) +++ incubator/beehive/site/src/documentation/content/xdocs/faq.xml Thu Dec 2 15:57:28 2004 @@ -41,7 +41,7 @@ regular JavaBeans, with an enhanced authoring model, an extensibility model, and a configuration model using JSR 175 annotations. To find out more about controls look at - <link href="./Controls.html">Controls</link>.</dd> + <link href="controls/controlsOverview.html">Controls Overview</link>.</dd> </dl> <dl> <dt>Does Beehive Support Commons Attributes?</dt> Modified: incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml Url: http://svn.apache.org/viewcvs/incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml?view=diff&rev=109597&p1=incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml&r1=109596&p2=incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml&r2=109597 ============================================================================== --- incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml (original) +++ incubator/beehive/site/src/documentation/content/xdocs/pageflow/pageflow_jsp.xml Thu Dec 2 15:57:28 2004 @@ -78,15 +78,15 @@ <%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0"; prefix="netui"%> <netui:html></strong> <head> - <title>...title> + <title>...</title> <strong><netui:base/></strong> - <head> + </head> <strong><netui:body></strong> .. .. .. - <strong><netui:body> -<netui:html></strong> + <strong></netui:body> +</netui:html></strong> </source> </section> @@ -140,7 +140,7 @@ </p> <source> -<<strong>netui:anchor action="login"</strong>>Login!</a> +<<strong>netui:anchor action="login"</strong>>Login!</netui:anchor> </source> <p>
