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/09 20:27:55 UTC
svn commit: r111417 - in incubator/beehive/trunk/docs/forrest/src/documentation: content/xdocs/controls resources/images
Author: steveh
Date: Thu Dec 9 11:27:54 2004
New Revision: 111417
URL: http://svn.apache.org/viewcvs?view=rev&rev=111417
Log:
Integrating image changes from the "live site" to the v1 beta branch.
Added:
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver1.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver2.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver3.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver4.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg1.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg2.gif (contents, props changed)
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg3.gif (contents, props changed)
Removed:
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_1.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_2.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_3.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_4.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_1.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_2.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_3.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_1.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_2.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_3.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_4.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_1.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_2.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_3.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview1.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview2.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview3.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview4.gif
incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsProg1.gif
Modified:
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml
incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml
Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml?view=diff&rev=111417&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml&r1=111416&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml&r2=111417
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsOverview.xml Thu Dec 9 11:27:54 2004
@@ -155,7 +155,7 @@
<section>
<title>The Controls Architecture</title>
<p>The following picture shows the basic runtime architecture and the relationships between a resource client, the associated Control, and the accessed J2EE resource:</p>
-<p><img src="images/_ControlsOverview_1.gif" alt=""/></p>
+<p><img src="images/conOver1.gif" alt=""/></p>
<p>The Resource Client represents user code in a web application, service, or application that needs access to the J2EE resource. The Resource Client and supporting Control will always live in the same virtual machine and communicate directly using local Java method invocation. The accessed resource may or may not reside within the same virtual machine, depending upon the nature of the resource and the application server environment. </p>
<p>
Dynamic property accessors and resource operations are exposed on the Control and used by the client to initiate resource access. Data from the resource may be returned as return values from operations or fired as events on the bean event interface to registered listeners. </p>
@@ -205,10 +205,10 @@
<li>The Control Bean Wrapper class is the JavaBean wrapper around the implementation class that provides the property accessor implementation, per-instance storage of dynamic properties, and property resolution services. It performs event listener routing and initialization of contextual services and nested Controls.</li>
</ul>
<p>The relationship and functions of these classes is summarized in the following diagram: </p>
-<p><img src="images/_ControlsOverview_2.gif" alt=""/></p>
+<p><img src="images/conOver2.gif" alt=""/></p>
<p>The following picture shows how these 3 classes work together to fulfill the runtime responsibilities shown in the earlier architecture diagram:
</p>
-<p><img src="images/controlsOverview3.gif" alt=""/></p>
+<p><img src="images/conOver3.gif" alt=""/></p>
</section>
<section>
@@ -343,7 +343,7 @@
<p>
The following diagram shows the basic mechanics of this contract:
</p>
-<p><img src="images/controlsOverview4.gif" alt=""/></p>
+<p><img src="images/conOver4.gif" alt=""/></p>
<p>
The Client Container has two basic responsibilities: to maintain an accumulated list of Controls that have acquired resources, and to invoke releaseResources API on each of them at the end of the appropriate resource scope. The Control Bean is responsible for delivering the onAcquire event to the Control Implementation instance, for notifying the Client Container that resources have been obtained, and for delivering the onRelease event to the implementation when notified by the Client Container.
</p>
@@ -385,8 +385,8 @@
<p>
The programmatic client model follows the basic pattern of JavaBeans construction and event handling:
</p>
-<source>TimerControlBean myTimerBean = (TimerControlBean)ControlBean.instantiate(
- classloader, "com.myco.TimerControlBean");
+<source>TimerControlBean myTimerBean =
+ (TimerControlBean)ControlBean.instantiate(classloader, "com.myco.TimerControlBean");
myTimerBean.setTimeout("3 seconds");
myTimerBeans.addTimerControlEventListener(
new TimerControlEventListener() // anonymous event handler class
Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml?view=diff&rev=111417&p1=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml&r1=111416&p2=incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml&r2=111417
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml Thu Dec 9 11:27:54 2004
@@ -55,11 +55,11 @@
<li><strong>Consistency.</strong> Instead of trying to provide consistency through convention, the Control compiler provides both verification and code generation services to ensure that the resulting implementation provides consistent APIs and behaviors for clients, tools, and application deployers or administrators.</li>
</ul>
<p><strong>Diagram: Control Architecture Elements and Flow</strong></p>
-<p><img src="images/_ControlsProgramming_1.gif" alt=""/></p>
+<p><img src="images/conProg1.gif" alt=""/></p>
<p>The client will interact with the Control by invoking operations defined on the Control Public Interface or dynamic property accessor methods on a ControlBean instance. The client can also express interest in any events the Control might generate by registering a listener to receive them.</p>
<p>The following diagram represents the relationship between the Control Public Interface, the Control Implementation Class, and the ControlBean Generated Class:</p>
<p><strong>Diagram: Relationships between Control Interface and Classes</strong></p>
-<p><img src="images/_ControlsProgramming_2.gif" alt=""/></p>
+<p><img src="images/conProg2.gif" alt=""/></p>
<p>The Control Public Interface defines the operations on the Control and will be implemented by both the Control Implementation Class and the ControlBean Generated Class. The ControlBean Generated Class will also define property accessor methods and internally will maintain the state of property values. It will also maintain a reference to one (and only one) Control Implementation instance. The Control Implementation instance, wrapped by a bean instance, provides the actual implementation of resource semantics for the Control.</p>
<p>The subsequent sections will outline the various characteristics of Controls:</p>
<ul>
@@ -738,8 +738,8 @@
// Create a message of the appropriate type
//
Message msg = null;
- JMSMessageControl.Message msgProp = <strong>context.getMethodPropertySet(m,
- JMSMessageControl.Message.class);</strong>
+ JMSMessageControl.Message msgProp =
+ <strong>context.getMethodPropertySet(m, JMSMessageControl.Message.class);</strong>
switch(msgProp.value())
{
case MessageType.OBJECT:
@@ -860,10 +860,14 @@
public void context_onCreate()
{
ClassLoader cl = Thread.currentThread().getContextClassLoader();
- rushOrders = (OrderQueueBean)Beans.instantiate(cl, “org.apache.beehive.controls.examples.OrderQueueBean”);
+ rushOrders =
+ (OrderQueueBean)Beans.instantiate(cl,
+ “org.apache.beehive.controls.examples.OrderQueueBean”);
rushOrders.setDestinationName(“RushOrders”);
<strong>context.add(rushOrders);</strong>
- orders = (OrderQueueBean)Beans.instantiate(cl, “org.apache.beehive.controls.examples.OrderQueueBean”);
+ orders =
+ (OrderQueueBean)Beans.instantiate(cl,
+ “org.apache.beehive.controls.examples.OrderQueueBean”);
orders.setDestinationName(“RushOrders”);
<strong>context.add(orders);</strong>
}
@@ -881,7 +885,7 @@
<p>The JavaBeans Runtime Containment and Services Protocol provides the base composition model for Control composition and containment. In this model, JavaBeans are associated with a BeanContext that manages the composition hierarchy and also manages any contextual services requested by the contained beans.</p>
<p>In the Control architecture, a ControlBean will potentially be related to two different BeanContexts: a parent context that represents the outer container for the bean, and a peer context that provides containment and services to other beans nested within that Control.</p>
<p>These context relationships from the previous sample are shown in the following diagram:</p>
-<p><img src="images/_ControlsProgramming_3.gif" alt=""/></p>
+<p><img src="images/conProg3.gif" alt=""/></p>
<p>In the diagram, the two OrderQueueBean instances created by OrderRouterBean are nested within the ControlBeanContext; while not shown, these two beans would also have a peer ControlBeanContext providing them with contextual services.</p>
<p>The peer ControlBeanContext provides localized generic services to the associated Control Implementation instance, such as ability to resolve property values from the local bean instance or externalized configuration, and the delivery of lifecycle events. The ControlBean architecture uses a delegation model for service discovery. If an implementation instance requests a service that is not implemented by the peer BeanContext, it will delegate up to the parent context to find a provider for the service.</p>
<p>At the root of the bean composition hierarchy is an instance of a ContainerBeanContext. This context represents the external runtime environment, within which the ControlBean is running. This might represent an EJB, servlet, web service, Java application, or any ControlBean-capable container. The ContainerBeanContext is responsible for the initialization and provisioning of service providers that are specific to runtime environment with which it is associated.</p>
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_1.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_2.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_3.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_4.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsOverview_4.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_1.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_2.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/ControlsProgramming_3.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_1.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_2.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_3.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_4.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsOverview_4.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_1.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_2.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/_ControlsProgramming_3.gif?view=auto&rev=111416
==============================================================================
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver1.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver2.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver3.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver4.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conOver4.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg1.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg2.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Added: incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/conProg3.gif?view=auto&rev=111417
==============================================================================
Binary file. No diff available.
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview1.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview2.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview2.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview3.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview3.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview4.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsOverview4.gif?view=auto&rev=111416
==============================================================================
Deleted: /incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsProg1.gif
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/resources/images/controlsProg1.gif?view=auto&rev=111416
==============================================================================