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>[EMAIL PROTECTED]
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>[EMAIL PROTECTED]
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]>
