This project has retired. For details please refer to its Attic page.

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:

Disposable, Initializable, Instrumentable, LogEnabled, Loggable

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 inherited from interface org.apache.excalibur.instrument.Instrumentable

EMPTY_INSTRUMENT_ARRAY, EMPTY_INSTRUMENTABLE_ARRAY

Constructor Summary

protected	ThreadSafeComponentHandler(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, 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, Configuration config, ComponentManager manager, 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

void	dispose() Deprecated. Dispose of the ComponentHandler and any associated Pools and Factories.
protected Component	doGet() Deprecated. Get a reference of the desired Component
protected void	doPut(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

Constructor Detail

ThreadSafeComponentHandler

protected ThreadSafeComponentHandler(java.lang.String role,
                                     java.lang.Class componentClass,
                                     Configuration config,
                                     ComponentManager manager,
                                     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.

ThreadSafeComponentHandler

public ThreadSafeComponentHandler(DefaultComponentFactory factory,
                                  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.

ThreadSafeComponentHandler

protected ThreadSafeComponentHandler(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.

Method Detail

initialize

public void initialize()
                throws java.lang.Exception

Deprecated.

Initialize the ComponentHandler.

Throws:

java.lang.Exception - if an error occurs

doGet

protected 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(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.