/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.cocoon.components;
import org.apache.avalon.framework.activity.Disposable;
import org.apache.avalon.framework.activity.Initializable;
import org.apache.avalon.framework.activity.Startable;
import org.apache.avalon.framework.configuration.Configurable;
import org.apache.avalon.framework.configuration.Configuration;
import org.apache.avalon.framework.context.Context;
import org.apache.avalon.framework.context.Contextualizable;
import org.apache.avalon.framework.logger.LogEnabled;
import org.apache.avalon.framework.logger.Logger;
import org.apache.avalon.framework.parameters.Parameterizable;
import org.apache.avalon.framework.parameters.Parameters;
import org.apache.avalon.framework.service.ServiceManager;
import org.apache.avalon.framework.service.Serviceable;
import org.apache.commons.logging.Log;
import org.apache.cocoon.util.avalon.CLLoggerWrapper;
/**
* Utility class for setting up Avalon components. Similar to Excalibur's
* <code>DefaultComponentFactory</code>, but on existing objects.
* <p>
* @deprecated
* @version $Id: LifecycleHelper.java 587751 2007-10-24 02:41:36Z vgritsenko $
*/
public class LifecycleHelper {
/** The Logger for the component
*/
final private Logger logger;
/** The Context for the component
*/
final private Context context;
/** The service manager for this component.
*/
final private ServiceManager serviceManager;
/** The configuration for this component.
*/
final private Configuration configuration;
/**
* Construct a new <code>LifecycleHelper</code> that can be used repeatedly to
* setup several components.
* <p>
* <b>Note</b> : if a parameter is <code>null</code>,
* the corresponding method isn't called (e.g. if <code>configuration</code> is
* <code>null</code>, <code>configure()</code> isn't called).
*
* @param logger the <code>Logger</code> to pass to <code>LogEnabled</code>s, unless there is
* a <code>LogKitManager</code> and the configuration specifies a logger name.
* @param context the <code>Context</code> to pass to <code>Contexutalizable</code>s.
* @param serviceManager the service manager to pass to <code>Serviceable</code>s.
* @param configuration the <code>Configuration</code> object to pass to new instances.
*/
public LifecycleHelper(final Logger logger,
final Context context,
final ServiceManager serviceManager,
final Configuration configuration) {
this.logger = logger;
this.context = context;
this.serviceManager = serviceManager;
this.configuration = configuration;
}
/**
* Setup a component, including initialization and start.
*
* @param component the component to setup.
* @return the component passed in, to allow function chaining.
* @throws Exception if something went wrong.
*/
public Object setupComponent(Object component) throws Exception {
return setupComponent(component, true);
}
/**
* Setup a component, and optionnaly initializes (if it's <code>Initializable</code>)
* and starts it (if it's <code>Startable</code>).
*
* @param component the component to setup.
* @param initializeAndStart if true, <code>intialize()</code> and <code>start()</code>
* will be called.
* @return the component passed in, to allow function chaining.
* @throws Exception if something went wrong.
*/
public Object setupComponent(Object component, boolean initializeAndStart)
throws Exception {
return setupComponent(component,
this.logger,
this.context,
this.serviceManager,
this.configuration,
initializeAndStart);
}
// --------------------------------------------------------- static
public static Object setupComponent(final Object component,
final Logger logger,
final Context context,
final ServiceManager serviceManager,
final Configuration configuration)
throws Exception {
return setupComponent(component,
logger,
context,
serviceManager,
configuration,
true);
}
/**
* Alternative setupComponent method that uses Commons Logging logger.
*/
public static Object setupComponent(final Object component,
final Log logger,
final Context context,
final ServiceManager serviceManager,
final Configuration configuration)
throws Exception {
return setupComponent(component,
logger,
context,
serviceManager,
configuration,
true);
}
public static Object setupComponent(final Object component,
final Logger logger,
final Context context,
final ServiceManager serviceManager,
final Configuration configuration,
final boolean initializeAndStart)
throws Exception {
if (component instanceof LogEnabled) {
((LogEnabled) component).enableLogging(logger);
}
if (context != null && component instanceof Contextualizable) {
((Contextualizable) component).contextualize(context);
}
if (serviceManager != null && component instanceof Serviceable) {
((Serviceable) component).service(serviceManager);
}
if (configuration != null && component instanceof Configurable) {
((Configurable) component).configure(configuration);
}
if (configuration != null && component instanceof Parameterizable) {
((Parameterizable) component).parameterize(
Parameters.fromConfiguration(configuration));
}
if (initializeAndStart && component instanceof Initializable) {
((Initializable) component).initialize();
}
if (initializeAndStart && component instanceof Startable) {
((Startable) component).start();
}
return component;
}
/**
* Alternative setupComponent method that uses Commons Logging logger.
*/
public static Object setupComponent(final Object component,
final Log logger,
final Context context,
final ServiceManager manager,
final Configuration configuration,
final boolean initializeAndStart)
throws Exception {
if (component instanceof LogEnabled) {
((LogEnabled) component).enableLogging(new CLLoggerWrapper(logger));
}
if (context != null && component instanceof Contextualizable) {
((Contextualizable) component).contextualize(context);
}
if (manager != null && component instanceof Serviceable) {
((Serviceable) component).service(manager);
}
if (configuration != null && component instanceof Configurable) {
((Configurable) component).configure(configuration);
}
if (configuration != null && component instanceof Parameterizable) {
((Parameterizable) component).parameterize(
Parameters.fromConfiguration(configuration));
}
if (initializeAndStart && component instanceof Initializable) {
((Initializable) component).initialize();
}
if (initializeAndStart && component instanceof Startable) {
((Startable) component).start();
}
return component;
}
/**
* Decomission a component, by stopping (if it's <code>Startable</code>) and
* disposing (if it's <code>Disposable</code>) a component.
*/
public static void decommission(final Object component)
throws Exception {
if (component instanceof Startable) {
((Startable) component).stop();
}
dispose(component);
}
/**
* Dispose a component if it's <code>Disposable</code>. Otherwhise, do nothing.
*/
public static void dispose(final Object component) {
if (component instanceof Disposable) {
((Disposable) component).dispose();
}
}
}