You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by st...@apache.org on 2004/12/03 00:57:29 UTC

svn commit: r109597 - in incubator/beehive/site: build/site build/site/controls build/site/pageflow src/documentation/content src/documentation/content/xdocs src/documentation/content/xdocs/controls src/documentation/content/xdocs/pageflow

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=&rdquo;queue.orders&rdquo;)
 <strong>public interface OrderQueue extends JmsMessageControl</strong>
 {
@@ -1567,10 +1567,11 @@
      peerContext.addCallbackListener(
          new ControlBeanContext.LifeCycle()
           {
-              public void onCreate() {  &hellip;. };
-              public void onAcquire() { &hellip; };
-              public void onRelease() { &hellip; };
-          });</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
-@ConnectionDataSource(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 @@
 &lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%&gt;
 &lt;netui:html&gt;</strong>
   &lt;head&gt;
-    &lt;title&gt;...title&gt;
+    &lt;title&gt;...&lt;/title&gt;
     <strong>&lt;netui:base/&gt;</strong>
-  &lt;head&gt;
+  &lt;/head&gt;
   <strong>&lt;netui:body&gt;</strong>
     ..
     ..
     ..
-  <strong>&lt;netui:body&gt;
-&lt;netui:html&gt;</strong>
+  <strong>&lt;/netui:body&gt;
+&lt;/netui:html&gt;</strong>
 
 </pre>
 </div>
@@ -463,7 +463,7 @@
     
 </p>
 <pre class="code">
-&lt;<strong>netui:anchor action="login"</strong>&gt;Login!&lt;/a&gt;
+&lt;<strong>netui:anchor action="login"</strong>&gt;Login!&lt;/netui:anchor&gt;
 </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
-@ConnectionDataSource(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 @@
 &lt;%@ taglib uri="http://beehive.apache.org/netui/tags-html-1.0" prefix="netui"%&gt;
 &lt;netui:html&gt;</strong>
   &lt;head&gt;
-    &lt;title&gt;...title&gt;
+    &lt;title&gt;...&lt;/title&gt;
     <strong>&lt;netui:base/&gt;</strong>
-  &lt;head&gt;
+  &lt;/head&gt;
   <strong>&lt;netui:body&gt;</strong>
     ..
     ..
     ..
-  <strong>&lt;netui:body&gt;
-&lt;netui:html&gt;</strong>
+  <strong>&lt;/netui:body&gt;
+&lt;/netui:html&gt;</strong>
 </source>
 
   </section>
@@ -140,7 +140,7 @@
     </p>
 
 <source>
-&lt;<strong>netui:anchor action="login"</strong>&gt;Login!&lt;/a&gt;
+&lt;<strong>netui:anchor action="login"</strong>&gt;Login!&lt;/netui:anchor&gt;
 </source>
 
     <p>