jcarman 2005/02/28 04:37:54
Modified: src/documentation/content/xdocs descriptor.xml
Log:
Allow interceptors to be ordered by name rather than interceptor factory id
PR: HIVEMIND-96
Revision Changes Path
1.23 +10 -2
jakarta-hivemind/src/documentation/content/xdocs/descriptor.xml
Index: descriptor.xml
===================================================================
RCS file:
/home/cvs/jakarta-hivemind/src/documentation/content/xdocs/descriptor.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- descriptor.xml 19 Feb 2005 17:57:40 -0000 1.22
+++ descriptor.xml 28 Feb 2005 12:37:54 -0000 1.23
@@ -367,6 +367,14 @@
<td>A list of interceptors whose
behavior should come earlier in
execution than this
interceptor.</td>
</tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>no</td>
+ <td>The name to use for ordering this
interceptor. Defaults to the service-id. This
+ comes in handy when using the same
factory to create multiple unique interceptors which
+ should be able to be ordered with
respect to one another.</td>
+ </tr>
</table>
<p>Like a service implementation factory, a service
interceptor factory
may need parameters. As with &invoke-factory;,
parameters to the
@@ -374,7 +382,7 @@
service interceptor factory will decode the
parameters using the schema
identified by its
<code>parameters-schema-id</code> attribute.</p>
<p>Interceptor ordering is based on dependencies; each
interceptor can
- identify, by interceptor service id, other
interceptors. Interceptors in
+ identify, by name, other interceptors.
Interceptors in
the <code>before</code> list are deferred until
after this interceptor.
Likewise, this interceptor is deferred until
after all interceptors in
the <code>after</code> list.</p>
@@ -382,7 +390,7 @@
has used &Ant; or any version
of Make. <code>before</code> dependencies are
simply the opposite.</note>
<p>The value for <code>before</code> or
<code>after</code> is a list of
- service ids seperated by commas. Service ids
may be unqualified if they
+ interceptor names seperated by commas. Service
ids may be unqualified if they
are within the same module. Alternately, the
fixed value <code>*</code>
may be used instead of a list: this indicates
that the interceptor
should be ordered absolutely first or
absolutely last.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
