Class ContainerUtil

java.lang.Object
org.apache.avalon.framework.container.ContainerUtil

public final class ContainerUtil extends Object
Utility class that makes it easier to transfer a component throught it's lifecycle stages.
Version:
CVS $Revision: 1.16 $ $Date: 2004/02/11 14:34:26 $
Author:
Avalon Development Team
  • Method Details

    • shutdown

      public static void shutdown(Object object) throws Exception
      Run specified object through shutdown lifecycle stages (Stop and Dispose).
      Parameters:
      object - the object to shutdown
      Throws:
      Exception - if there is a problem stoppping object
    • enableLogging

      public static void enableLogging(Object object, Logger logger)
      Supply specified object with Logger if it implements the LogEnabled interface.
      Parameters:
      object - the object to Start
      logger - the logger to enable component with. May be null in which case the specified object must not implement LogEnabled.
      Throws:
      IllegalArgumentException - if the object is LogEnabled but Logger is null
    • contextualize

      public static void contextualize(Object object, Context context) throws ContextException
      Supply specified object with a Context object if it implements the Contextualizable interface.
      Parameters:
      object - the object to contextualize
      context - the context object to use for object. May be null in which case the specified object must not implement Contextualizable.
      Throws:
      ContextException - if there is a problem contextualizing object
      IllegalArgumentException - if the object is Contextualizable but context is null
    • service

      public static void service(Object object, ServiceManager serviceManager) throws ServiceException
      Supply specified object with ServiceManager if it implements the Serviceable interface.
      Parameters:
      object - the object to service
      serviceManager - the serviceManager object to use for object. May be null in which case the specified object must not implement Serviceable.
      Throws:
      ServiceException - if there is a problem servicing object
      IllegalArgumentException - if the object is Servicable but ServiceManager is null
    • compose

      public static void compose(Object object, ComponentManager componentManager) throws ComponentException
      Deprecated.
      compose() is no longer the preferred method via which components will be supplied with Components. Please Use service() from Composable instead.
      Supply specified object with ComponentManager if it implements the Composable interface.
      Parameters:
      object - the object to compose
      componentManager - the ComponentManager object to use for object. May be null in which case the specified object must not implement Composable.
      Throws:
      ComponentException - if there is a problem composing object
      IllegalArgumentException - if the object is Composable but ComponentManager is null
    • configure

      public static void configure(Object object, Configuration configuration) throws ConfigurationException
      Configure specified object if it implements the Configurable interface.
      Parameters:
      object - the object to Start
      configuration - the configuration object to use during configuration. May be null in which case the specified object must not implement Configurable
      Throws:
      ConfigurationException - if there is a problem Configuring object, or the object is Configurable but Configuration is null
      IllegalArgumentException - if the object is Configurable but Configuration is null
    • parameterize

      public static void parameterize(Object object, Parameters parameters) throws ParameterException
      Parameterize specified object if it implements the Parameterizable interface.
      Parameters:
      object - the object to Parameterize.
      parameters - the parameters object to use during Parameterization. May be null in which case the specified object must not implement Parameterizable.
      Throws:
      ParameterException - if there is a problem Parameterizing object
      IllegalArgumentException - if the object is Parameterizable but parameters is null
    • initialize

      public static void initialize(Object object) throws Exception
      Initialize specified object if it implements the Initializable interface.
      Parameters:
      object - the object to Initialize
      Throws:
      Exception - if there is a problem Initializing object
    • start

      public static void start(Object object) throws Exception
      Start specified object if it implements the Startable interface.
      Parameters:
      object - the object to Start
      Throws:
      Exception - if there is a problem Starting object
    • execute

      public static void execute(Object object) throws Exception
      Execute the specified object if it implements the Executable interface.
      Parameters:
      object - the object to execute
      Throws:
      Exception - if there is a problem executing object
    • stop

      public static void stop(Object object) throws Exception
      Stop specified object if it implements the Startable interface.
      Parameters:
      object - the object to stop
      Throws:
      Exception - if there is a problem stoppping object
    • dispose

      public static void dispose(Object object)
      Dispose specified object if it implements the Disposable interface.
      Parameters:
      object - the object to dispose