mcconnell 2002/09/09 07:35:40
Modified: assembly/src/java/org/apache/excalibur/merlin/activation
package.html
Log:
Activation package javadoc overview page.
Revision Changes Path
1.4 +41 -0
jakarta-avalon-excalibur/assembly/src/java/org/apache/excalibur/merlin/activation/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/assembly/src/java/org/apache/excalibur/merlin/activation/package.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- package.html 8 Sep 2002 16:59:36 -0000 1.3
+++ package.html 9 Sep 2002 14:35:40 -0000 1.4
@@ -5,4 +5,45 @@
service activation over a CORBA IIOP protocol.
</p>
+<table border="1" cellpadding="3" cellspacing="0" width="100%">
+<tr bgcolor="#ccccff">
+<td colspan="2"><font size="+2"><b>Services</b></font></td>
+<tr><td width="20%" valign="top"><strong>{@link
org.apache.excalibur.merlin.activation.Directory}</strong></td>
+<td>The <code>Directory</code> component is a container that implements corbaloc
URL protocol support. Clients can access the directory using corbaloc URL similar to
<code>corbaloc:iiop:[EMAIL PROTECTED]:2056/public/demo</code>. The corbaloc URL handler
on the client uses the JDK ORB to establish to request to the container. The container
provides support for service location and mapping between corbaloc URLs and local
service protocol URLs. Object references passed back to the client are established
using meta information associated with the server-side resource. Activation of the
server will occur if and when the client invokes a an operation against a object
reference returned from the URL.</td>
+</td></tr>
+<tr><td width="20%" valign="top"><strong>{@link
org.apache.excalibur.merlin.activation.DefaultRemoteResourceFactory}</strong></td>
+<td><p>This resource factory extends the standard resource factory through the
addition of the CORBA POA machinery required to establish a CORBA Servant. Servants
are created either via delagation or by extension of a generated POA class. The
factory and the related DefaultRemoteResource handler leverage attributs contained
within a component to automate the establishment of the POA servant management model.
Component atttributes regignized by the handler are listed in the following table.</p>
+
+ <table border="0" cellpadding="3" cellspacing="0" width="100%">
+ <tr>
+ <td valign="top"><b>Key</b></td><td><b>Value</b></td>
+ </tr>
+ <tr>
+ <td valign="top"><code>merlin:resource-factory</code></td>
+ <td><p>Declaration of a resource factory interface that specifices the type
of factory that the container shall use when generating a resource for the component
type.</p></td>
+ </tr>
+ <tr>
+ <td valign="top"><code>corba:poa.implementation</code></td>
+ <td><p>Declaration of the servant creation policy (either "delegate" or
"servant").
+ With the delegate policy a POA is created using the tie mechanism. If the
+ policy is servant based then the implemetation class must be derived from
+ the Servant interface (classic POA types).</p></td>
+ </tr>
+ <tr>
+ <td valign="top"><code>corba:poa.delegate</code></td>
+ <td><p>When building a delegate the resource implementation needs a
+ reference to the POA tie class. The POA tie object will be created
+ at the time of invocation of an operation by a client holding an
+ object reference to the service.</p></td>
+ </tr>
+ <tr>
+ <td valign="top"><code>corba:poa.servant.id</code></td>
+ <td><p>The servant id attribute is used to construct an object reference to
+ a POA backed by the component without requiring component instantiation. The
+ attribute value is a IDL URI.</p></td>
+ </tr>
+ </table>
+</td>
+</table>
+
</body>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
