svn commit: r426726 - in /geronimo/sandbox/svkmerge/trunk: ./ modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java

[jd...@apache.org]

Author: jdillon
Date: Fri Jul 28 17:40:17 2006
New Revision: 426726

URL: http://svn.apache.org/viewvc?rev=426726&view=rev
Log:
 r592@Bliss (orig r426617):  ammulder | 2006-07-28 10:47:58 -0700
 Merge ConfigurationManager JavaDoc addition to trunk
 

Modified:
    geronimo/sandbox/svkmerge/trunk/   (props changed)
    geronimo/sandbox/svkmerge/trunk/modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java

Propchange: geronimo/sandbox/svkmerge/trunk/
------------------------------------------------------------------------------
--- svk:merge (original)
+++ svk:merge Fri Jul 28 17:40:17 2006
@@ -1,2 +1,2 @@
 13f79535-47bb-0310-9956-ffa450edef68:/geronimo/sandbox/svkmerge/m2migration:419395
-13f79535-47bb-0310-9956-ffa450edef68:/geronimo/trunk:426378
+13f79535-47bb-0310-9956-ffa450edef68:/geronimo/trunk:426617

Modified: geronimo/sandbox/svkmerge/trunk/modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java
URL: http://svn.apache.org/viewvc/geronimo/sandbox/svkmerge/trunk/modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java?rev=426726&r1=426725&r2=426726&view=diff
==============================================================================
--- geronimo/sandbox/svkmerge/trunk/modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java (original)
+++ geronimo/sandbox/svkmerge/trunk/modules/kernel/src/java/org/apache/geronimo/kernel/config/ConfigurationManager.java Fri Jul 28 17:40:17 2006
@@ -26,6 +26,29 @@
 /**
  * Encapsulates logic for dealing with configurations.
  *
+ * Configurations have a lifecycle with three states: installed, loaded, and
+ * running.  Installed means that the configuration is present in the server's
+ * repository.  Loaded means that the Configuration GBean (including the
+ * configuration's ClassLoader) is running.  Running means that all the GBeans
+ * in the Configuration are running.
+ *
+ * From a user perspective, there's not much difference between installed and
+ * loaded if the configuration has not been started (it still shows up as not
+ * running).  However, certain operations will cause a configuration to be
+ * loaded but not started.  For example, if ModuleA depends on ModuleB, then
+ * when ModuleA is distributed ModuleB will normally be loaded (to fire up the
+ * ClassLoader and validate ModuleA).  But ModuleB will not be started at that
+ * point.  It can be started manually or it will be started automatically when
+ * ModuleA is started.
+ *
+ * When a Configuration is not loaded, only its ConfigurationData is available
+ * for inspection.  It's normally not possible to inspect the GBeans in the
+ * configuration because there's no ClassLoader that could be used to load the
+ * classes needed by the GBeanDatas in the configuration.  Once the
+ * configuration has been loaded, it's ClassLoader is available so the
+ * GBeanDatas can be loaded and inspected.  But the GBean instances are not
+ * instantiated and started until the configuration is started. 
+ *
  * @version $Rev$ $Date$
  */
 public interface ConfigurationManager {