org.apache.avalon.excalibur.component

Class ThreadSafeComponentHandler

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.apache.avalon.excalibur.component.AbstractDualLogEnabled

org.apache.avalon.excalibur.component.AbstractDualLogEnabledInstrumentable

org.apache.avalon.excalibur.component.ComponentHandler

org.apache.avalon.excalibur.component.ThreadSafeComponentHandler

All Implemented Interfaces:

org.apache.avalon.framework.activity.Disposable, org.apache.avalon.framework.activity.Initializable, org.apache.avalon.framework.logger.LogEnabled, org.apache.avalon.framework.logger.Loggable, org.apache.excalibur.instrument.Instrumentable

Deprecated.

ECM is no longer supported

public class ThreadSafeComponentHandler
extends ComponentHandler

The ThreadSafeComponentHandler to make sure components are initialized and destroyed correctly.

Since:

4.0

Version:

CVS $Revision: 1.4 $ $Date: 2004/02/28 11:47:14 $

Author:

Avalon Development Team

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	m_disposed Deprecated.
private DefaultComponentFactory	m_factory Deprecated.
private boolean	m_initialized Deprecated.
private org.apache.avalon.framework.component.Component	m_instance Deprecated.

Fields inherited from interface org.apache.excalibur.instrument.Instrumentable

EMPTY_INSTRUMENT_ARRAY, EMPTY_INSTRUMENTABLE_ARRAY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ThreadSafeComponentHandler(org.apache.avalon.framework.component.Component component) Deprecated. Create a ComponentHandler that takes care of hiding the details of whether a Component is ThreadSafe, Poolable, or SingleThreaded.
	ThreadSafeComponentHandler(DefaultComponentFactory factory, org.apache.avalon.framework.configuration.Configuration config) Deprecated. Create a ThreadSafeComponentHandler which manages a pool of Components created by the specified factory object.
protected	ThreadSafeComponentHandler(java.lang.String role, java.lang.Class componentClass, org.apache.avalon.framework.configuration.Configuration config, org.apache.avalon.framework.component.ComponentManager manager, org.apache.avalon.framework.context.Context context, RoleManager roles, LogkitLoggerManager logkit) Deprecated. Create a ComponentHandler that takes care of hiding the details of whether a Component is ThreadSafe, Poolable, or SingleThreaded.

Method Summary

Methods

Modifier and Type	Method and Description
void	dispose() Deprecated. Dispose of the ComponentHandler and any associated Pools and Factories.
protected org.apache.avalon.framework.component.Component	doGet() Deprecated. Get a reference of the desired Component
protected void	doPut(org.apache.avalon.framework.component.Component component) Deprecated. Return a reference of the desired Component
void	initialize() Deprecated. Initialize the ComponentHandler.

Methods inherited from class org.apache.avalon.excalibur.component.ComponentHandler

canBeDisposed, get, getComponentHandler, getComponentHandler, getComponentHandler, getComponentHandler, getComponentHandler, put

Methods inherited from class org.apache.avalon.excalibur.component.AbstractDualLogEnabledInstrumentable

addChildInstrumentable, addInstrument, getChildInstrumentables, getInstrumentableName, getInstruments, setInstrumentableName

Methods inherited from class org.apache.avalon.excalibur.component.AbstractDualLogEnabled

getLogkitLogger, setLogger

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_instance

private org.apache.avalon.framework.component.Component m_instance

Deprecated.

m_factory

private final DefaultComponentFactory m_factory

Deprecated.

m_initialized

private boolean m_initialized

Deprecated.

m_disposed

private boolean m_disposed

Deprecated.

Constructor Detail

ThreadSafeComponentHandler

protected ThreadSafeComponentHandler(java.lang.String role,
                          java.lang.Class componentClass,
                          org.apache.avalon.framework.configuration.Configuration config,
                          org.apache.avalon.framework.component.ComponentManager manager,
                          org.apache.avalon.framework.context.Context context,
                          RoleManager roles,
                          LogkitLoggerManager logkit)
                              throws java.lang.Exception

Deprecated.

Create a ComponentHandler that takes care of hiding the details of whether a Component is ThreadSafe, Poolable, or SingleThreaded. It falls back to SingleThreaded if not specified.

Throws:

java.lang.Exception

ThreadSafeComponentHandler

public ThreadSafeComponentHandler(DefaultComponentFactory factory,
                          org.apache.avalon.framework.configuration.Configuration config)
                           throws java.lang.Exception

Deprecated.

Create a ThreadSafeComponentHandler which manages a pool of Components created by the specified factory object.

Parameters:

factory - The factory object which is responsible for creating the components managed by the ComponentHandler.

config - The configuration to use to configure the pool.

Throws:

java.lang.Exception

ThreadSafeComponentHandler

protected ThreadSafeComponentHandler(org.apache.avalon.framework.component.Component component)
                              throws java.lang.Exception

Deprecated.

Create a ComponentHandler that takes care of hiding the details of whether a Component is ThreadSafe, Poolable, or SingleThreaded. It falls back to SingleThreaded if not specified.

Throws:

java.lang.Exception

Method Detail

initialize

public void initialize()
                throws java.lang.Exception

Deprecated.

Initialize the ComponentHandler.

Throws:

java.lang.Exception

doGet

protected org.apache.avalon.framework.component.Component doGet()
                                                         throws java.lang.Exception

Deprecated.

Get a reference of the desired Component

Overrides:

doGet in class ComponentHandler

Returns:

a Component value

Throws:

java.lang.Exception - if an error occurs

doPut

protected void doPut(org.apache.avalon.framework.component.Component component)

Deprecated.

Return a reference of the desired Component

Overrides:

doPut in class ComponentHandler

Parameters:

component - a Component value

dispose

public void dispose()

Deprecated.

Dispose of the ComponentHandler and any associated Pools and Factories.