CVS: jcontainer/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle AbstractResourceProvider.java,1.5,1.6 LifecycleHelper.java,1.2,1.3 ResourceProvider.java,1.1,1.2

Peter Donald <pdonald-yCVjj/[email protected]> Sat, 29 Nov 2003 07:45:00 -0600
Newsgroups gmane.comp.java.jcontainer.cvs
Message-ID <[email protected]>
Update of /cvsroot/jcontainer/jcontainer/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle
In directory hogshead.codehaus.org:/tmp/cvs-serv31016/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle

Modified Files:
	AbstractResourceProvider.java LifecycleHelper.java 
	ResourceProvider.java 
Log Message:
Remove email addie

Index: AbstractResourceProvider.java
===================================================================
RCS file: /cvsroot/jcontainer/jcontainer/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle/AbstractResourceProvider.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- AbstractResourceProvider.java	3 Nov 2003 06:43:15 -0000	1.5
+++ AbstractResourceProvider.java	29 Nov 2003 13:44:26 -0000	1.6
@@ -108,18 +108,15 @@
 import org.realityforge.salt.i18n.Resources;
 
 /**
- * This is a base object via which the
- * {@link org.jcontainer.loom.components.util.lifecycle.LifecycleHelper}
- * aquires resources for each component. This base implementation
- * will aquire components and make sure that all required
- * components are present. It will also make sure that the types
- * of values returned from context are valid.
+ * This is a base object via which the {@link org.jcontainer.loom.components.util.lifecycle.LifecycleHelper}
+ * aquires resources for each component. This base implementation will aquire
+ * components and make sure that all required components are present. It will
+ * also make sure that the types of values returned from context are valid.
  *
- * <p>Note that this class assumes that the dependency graph
- * has been validated (presumably via
- * {@link org.jcontainer.loom.components.util.verifier.AssemblyVerifier}</p>
+ * <p>Note that this class assumes that the dependency graph has been validated
+ * (presumably via {@link org.jcontainer.loom.components.util.verifier.AssemblyVerifier}</p>
  *
- * @author <a href="mailto:peter at realityforge.org">Peter Donald</a>
+ * @author Peter Donald
  * @version $Revision$ $Date$
  */
 public abstract class AbstractResourceProvider
@@ -146,8 +143,8 @@
     }
 
     /**
-     * Utility method via which the provider aquires services to place
-     * in ServiceManager for a particular component.
+     * Utility method via which the provider aquires services to place in
+     * ServiceManager for a particular component.
      *
      * <p>Must be implemented in subclass.</p>
      *
@@ -158,8 +155,8 @@
     protected abstract Object getService( String name, Object entry );
 
     /**
-     * Utility method via which the provider aquires a context value
-     * to place in Context for a particular component.
+     * Utility method via which the provider aquires a context value to place in
+     * Context for a particular component.
      *
      * <p>Must be implemented in subclass.</p>
      *
@@ -170,10 +167,8 @@
     protected abstract Object getContextValue( String name, Object entry );
 
     /**
-     * Create a component for a particular entry.
-     * This implementation uses the associated
-     * ComponentFactory to create instance of
-     * component.
+     * Create a component for a particular entry. This implementation uses the
+     * associated ComponentFactory to create instance of component.
      *
      * @param entry the entry
      * @return the newly created component
@@ -188,7 +183,8 @@
     }
 
     /**
-     * Create a Parameters object by Creating configuration object and converting that.
+     * Create a Parameters object by Creating configuration object and
+     * converting that.
      *
      * @param entry the entry
      * @return a new Parameters object for component
@@ -222,7 +218,8 @@
     {
         final ComponentTemplate component = getMetaData( entry );
         final Configuration configuration =
-            ConfigurationConverter.toConfiguration( component.getConfiguration() );
+            ConfigurationConverter.toConfiguration(
+                component.getConfiguration() );
         if( null == configuration )
         {
             final String message =
@@ -234,9 +231,10 @@
     }
 
     /**
-     * Create a Context object that contains values specified in map.
-     * The default implementation creates a basic Context object but different
-     * containers may choose to overide this to provide their own subclass of context.
+     * Create a Context object that contains values specified in map. The
+     * default implementation creates a basic Context object but different
+     * containers may choose to overide this to provide their own subclass of
+     * context.
      *
      * @param contextData the data to place in context
      * @return the Context object
@@ -249,9 +247,10 @@
     }
 
     /**
-     * Return the ComponentTemplate for specified component entry.
-     * This implementation assumes that entry is instance of ComponentTemplate
-     * but subclasses should overide this method if this assumption does not hold true.
+     * Return the ComponentTemplate for specified component entry. This
+     * implementation assumes that entry is instance of ComponentTemplate but
+     * subclasses should overide this method if this assumption does not hold
+     * true.
      *
      * @param entry the component entry
      * @return the ComponentTemplate
@@ -266,7 +265,8 @@
      *
      * @param componentEntry the entry representing component
      * @return the created Context
-     * @throws java.lang.Exception if unable to create context or entrys in context
+     * @throws java.lang.Exception if unable to create context or entrys in
+     * context
      */
     public final Context createContext( final Object componentEntry )
         throws Exception
@@ -345,8 +345,8 @@
     }
 
     /**
-     * Create a Map of services for specified component.
-     * The map maps key name to service provider.
+     * Create a Map of services for specified component. The map maps key name
+     * to service provider.
      *
      * @param entry the component entry creating map for
      * @return the map

Index: LifecycleHelper.java
===================================================================
RCS file: /cvsroot/jcontainer/jcontainer/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle/LifecycleHelper.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- LifecycleHelper.java	16 Oct 2003 14:45:46 -0000	1.2
+++ LifecycleHelper.java	29 Nov 2003 13:44:26 -0000	1.3
@@ -115,7 +115,7 @@
  * The implementation provides support for the processing of a component through
  * each lifecycle stage, and manage errors in a consistent way.
  *
- * @author <a href="mailto:peter at realityforge.org">Peter Donald</a>
+ * @author Peter Donald
  * @author <a href="mailto:[email protected]">Stephen McConnell</a>
  */
 public class LifecycleHelper
@@ -140,16 +140,16 @@
     private static final int STAGE_DESTROY = 12;
 
     /**
-     * Method to run a component through it's startup phase.
-     * Errors that occur during startup will be logged appropriately and
-     * cause exceptions with useful messages to be raised.
+     * Method to run a component through it's startup phase. Errors that occur
+     * during startup will be logged appropriately and cause exceptions with
+     * useful messages to be raised.
      *
      * @param name the name of the component
      * @param entry the entry representing object
      * @param provider the resource provider
      * @return the newly created component
      * @throws LoomException if an error occurs when the component passes
-     *     through a specific lifecycle stage
+     * through a specific lifecycle stage
      */
     public Object startup( final String name,
                            final Object entry,
@@ -163,7 +163,8 @@
             stage = STAGE_CREATE;
             notice( name, stage );
             final Object object = provider.createObject( entry );
-            final InstrumentManager instrumentManager = provider.createInstrumentManager( entry );
+            final InstrumentManager instrumentManager = provider.createInstrumentManager(
+                entry );
 
             //LogEnabled stage
             stage = STAGE_LOGGER;
@@ -180,7 +181,8 @@
             {
                 notice( name, stage );
 
-                ( (InstrumentManageable)object ).setInstrumentManager( instrumentManager );
+                ( (InstrumentManageable)object ).setInstrumentManager(
+                    instrumentManager );
             }
 
             //Contextualize stage
@@ -242,10 +244,12 @@
             if( object instanceof Instrumentable )
             {
                 notice( name, stage );
-                final String instrumentableName = provider.createInstrumentableName( entry );
+                final String instrumentableName = provider.createInstrumentableName(
+                    entry );
                 final Instrumentable instrumentable = (Instrumentable)object;
                 instrumentable.setInstrumentableName( instrumentableName );
-                instrumentManager.registerInstrumentable( instrumentable, instrumentableName );
+                instrumentManager.registerInstrumentable( instrumentable,
+                                                          instrumentableName );
             }
 
             //Start stage
@@ -269,8 +273,8 @@
     }
 
     /**
-     * Method to run a component through it's shutdown phase.
-     * Errors that occur during shutdown will be logged appropraitely.
+     * Method to run a component through it's shutdown phase. Errors that occur
+     * during shutdown will be logged appropraitely.
      *
      * @param name the name of the component
      * @param object the component to shutdown
@@ -327,7 +331,8 @@
     }
 
     /**
-     * Utility method to report that a lifecycle stage is about to be processed.
+     * Utility method to report that a lifecycle stage is about to be
+     * processed.
      *
      * @param name the name of component that is the subject of the notice
      * @param stage the lifecycle processing stage
@@ -345,8 +350,8 @@
     }
 
     /**
-     * Utility method to report that there was an error processing
-     * specified lifecycle stage.
+     * Utility method to report that there was an error processing specified
+     * lifecycle stage.
      *
      * @param name the name of component that caused failure
      * @param stage the lefecycle stage
@@ -367,9 +372,9 @@
     }
 
     /**
-     * Utility method to report that there was an error processing
-     * specified lifecycle stage. It will also re-throw an exception
-     * with a better error message.
+     * Utility method to report that there was an error processing specified
+     * lifecycle stage. It will also re-throw an exception with a better error
+     * message.
      *
      * @param name the name of block that caused failure
      * @param stage the stage

Index: ResourceProvider.java
===================================================================
RCS file: /cvsroot/jcontainer/jcontainer/loom/engine/src/java/org/jcontainer/loom/components/util/lifecycle/ResourceProvider.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- ResourceProvider.java	16 Oct 2003 05:40:46 -0000	1.1
+++ ResourceProvider.java	29 Nov 2003 13:44:26 -0000	1.2
@@ -95,10 +95,9 @@
 import org.apache.excalibur.instrument.InstrumentManager;
 
 /**
- * The interface via which resources required for a component
- * are aquired.
+ * The interface via which resources required for a component are aquired.
  *
- * @author <a href="mailto:peter at realityforge.org">Peter Donald</a>
+ * @author Peter Donald
  * @version $Revision$ $Date$
  */
 public interface ResourceProvider