knut 2005/04/29 06:29:22
Modified: framework/src/descriptor/META-INF hivemodule.xml
framework/src/java/org/apache/hivemind/impl StartupImpl.java
Log:
provide clearer documentation for hivemind.Startup service (see HIVEMIND-111).
Revision Changes Path
1.28 +3 -2
jakarta-hivemind/framework/src/descriptor/META-INF/hivemodule.xml
Index: hivemodule.xml
===================================================================
RCS file:
/home/cvs/jakarta-hivemind/framework/src/descriptor/META-INF/hivemodule.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- hivemodule.xml 31 Mar 2005 00:24:20 -0000 1.27
+++ hivemodule.xml 29 Apr 2005 13:29:21 -0000 1.28
@@ -569,7 +569,7 @@
<configuration-point id="Startup">
A configuration to which startup objects may be contributed (as objects
or services).
- Startup object must implement the java.lang.Runnable interface. Order of
execution is expliclitly NOT defined.
+ Startup objects must implement the java.lang.Runnable interface. Order
of execution is expliclitly NOT defined.
<schema>
<element name="startup">
@@ -591,7 +591,8 @@
<service-point id="Startup" interface="java.lang.Runnable">
A service which is used to bootstrap HiveMind; it obtains the
hivemind.Startup configuration and runs each
- Runnable object or service within.
+ Runnable object or service within as the last step of the Registry
construction phase.
+ Note that the execution order is arbitrary and the startup objects are
NOT executed in separate threads.
<invoke-factory>
<construct class="impl.StartupImpl">
1.4 +11 -4
jakarta-hivemind/framework/src/java/org/apache/hivemind/impl/StartupImpl.java
Index: StartupImpl.java
===================================================================
RCS file:
/home/cvs/jakarta-hivemind/framework/src/java/org/apache/hivemind/impl/StartupImpl.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- StartupImpl.java 6 Jan 2005 01:45:12 -0000 1.3
+++ StartupImpl.java 29 Apr 2005 13:29:21 -0000 1.4
@@ -18,10 +18,17 @@
import java.util.List;
/**
- * Startup service for HiveMind. This implementation uses the
- * <code>hivemind.Startup</code> configuration point to start other
- * services.
- *
+ * Startup service for the HiveMind Registry. This service is invoked as the
+ * [EMAIL PROTECTED]
org.apache.hivemind.internal.RegistryInfrastructure#startup() last step} of the
+ * [EMAIL PROTECTED]
org.apache.hivemind.impl.RegistryBuilder#constructRegistry(Locale) registry
construction}.
+ * All contributions (java.lang.Runnable objects) to the
<code>hivemind.Startup</code>
+ * configuration point are executed serially in an arbitrary order. Note
that the contributions are
+ * <em>not</em> executed in separate Threads.
+ * <p>
+ * HiveMind contributes the <code>hivemind.EagerLoad</code> (see
+ * [EMAIL PROTECTED] org.apache.hivemind.service.impl.EagerLoader}) service
to the
+ * <code>hivemind.Startup</code> configuration.
+ *
* @author Howard Lewis Ship
*/
public class StartupImpl extends BaseLocatable implements Runnable
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
