org.apache.avalon.fortress.impl.handler

Class AbstractComponentHandler

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.apache.excalibur.instrument.AbstractLogEnabledInstrumentable

org.apache.avalon.fortress.impl.handler.AbstractComponentHandler

All Implemented Interfaces:

ComponentHandler, org.apache.avalon.framework.activity.Disposable, org.apache.avalon.framework.activity.Initializable, org.apache.avalon.framework.logger.LogEnabled, org.apache.avalon.framework.service.Serviceable, org.apache.excalibur.instrument.Instrumentable

Direct Known Subclasses:

FactoryComponentHandler, PerThreadComponentHandler, PoolableComponentHandler, ThreadSafeComponentHandler

public abstract class AbstractComponentHandler
extends org.apache.excalibur.instrument.AbstractLogEnabledInstrumentable
implements org.apache.avalon.framework.service.Serviceable, org.apache.avalon.framework.activity.Initializable, org.apache.avalon.framework.activity.Disposable, ComponentHandler

AbstractComponentHandler class, ensures components are initialized and destroyed correctly.

Since:

4.0

Version:

CVS $Revision: 1.19 $ $Date: 2004/03/13 13:56:51 $

Author:

Avalon Development Team

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	m_disposed State management boolean stating whether the Handler is disposed or not
protected org.d_haven.mpool.ObjectFactory	m_factory The instance of the ComponentFactory that creates and disposes of the Component
protected org.apache.avalon.framework.logger.Logger	m_logger Logger for factory
protected org.apache.avalon.excalibur.logger.LoggerManager	m_loggerManager Logger Manager
protected boolean	m_prepared State management boolean stating whether the Handler is initialized or not
private org.apache.excalibur.instrument.CounterInstrument	m_release
private org.apache.excalibur.instrument.CounterInstrument	m_request

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

EMPTY_INSTRUMENT_ARRAY, EMPTY_INSTRUMENTABLE_ARRAY

Constructor Summary

Constructors

Constructor and Description
AbstractComponentHandler()

Method Summary

Methods

Modifier and Type	Method and Description
void	dispose() Dispose of the ComponentHandler and any associated Pools and Factories.
protected void	disposeComponent(java.lang.Object component) Dispose of the specified component.
protected void	doDispose() Dispose handler specific resources.
protected abstract java.lang.Object	doGet() Subclasses should actually overide this to do the work of retrieving a service.
protected void	doPrepare() Initialize the ComponentHandler.
protected void	doPut(java.lang.Object component) Subclasses should overide this to return component to handler.
java.lang.Object	get() Get a reference of the desired Component
java.lang.Class	getComponentClass() Return the component's class that this handler is trying to create.
void	initialize()
protected java.lang.Object	newComponent() Create a new component for handler.
void	prepareHandler() Actually prepare the handler and make it ready to handle component access.
void	put(java.lang.Object component) Return a reference of the desired Component
void	service(org.apache.avalon.framework.service.ServiceManager manager)
java.lang.String	toString() Represents the handler as a string.

Methods inherited from class org.apache.excalibur.instrument.AbstractLogEnabledInstrumentable

addChildInstrumentable, addInstrument, getChildInstrumentables, getInstrumentableName, getInstruments, setInstrumentableName

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, wait, wait, wait

Field Detail

m_request

private org.apache.excalibur.instrument.CounterInstrument m_request

m_release

private org.apache.excalibur.instrument.CounterInstrument m_release

m_factory

protected org.d_haven.mpool.ObjectFactory m_factory

The instance of the ComponentFactory that creates and disposes of the Component

m_prepared

protected boolean m_prepared

State management boolean stating whether the Handler is initialized or not

m_disposed

protected boolean m_disposed

State management boolean stating whether the Handler is disposed or not

m_logger

protected org.apache.avalon.framework.logger.Logger m_logger

Logger for factory

m_loggerManager

protected org.apache.avalon.excalibur.logger.LoggerManager m_loggerManager

Logger Manager

Constructor Detail

AbstractComponentHandler

public AbstractComponentHandler()

Method Detail

service

public void service(org.apache.avalon.framework.service.ServiceManager manager)
             throws org.apache.avalon.framework.service.ServiceException

Specified by:

service in interface org.apache.avalon.framework.service.Serviceable

Throws:

org.apache.avalon.framework.service.ServiceException

initialize

public void initialize()
                throws java.lang.Exception

Specified by:

initialize in interface org.apache.avalon.framework.activity.Initializable

Throws:

java.lang.Exception

getComponentClass

public java.lang.Class getComponentClass()

Return the component's class that this handler is trying to create. Used for deubug information.

Specified by:

getComponentClass in interface ComponentHandler

Returns:

the Class object for the component

prepareHandler

public void prepareHandler()
                    throws java.lang.Exception

Actually prepare the handler and make it ready to handle component access.

Specified by:

prepareHandler in interface ComponentHandler

Throws:

java.lang.Exception - if unable to prepare handler

doPrepare

protected void doPrepare()
                  throws java.lang.Exception

Initialize the ComponentHandler. Subclasses should overide this to do their own initialization.

Throws:

java.lang.Exception - if there is a problem

get

public java.lang.Object get()
                     throws java.lang.Exception

Get a reference of the desired Component

Specified by:

get in interface ComponentHandler

Returns:

the component

Throws:

java.lang.Exception - if unable to ge tthe compoennt reference

doGet

protected abstract java.lang.Object doGet()
                                   throws java.lang.Exception

Subclasses should actually overide this to do the work of retrieving a service.

Returns:

the service

Throws:

java.lang.Exception - if unable to aquire service

put

public void put(java.lang.Object component)

Return a reference of the desired Component

Specified by:

put in interface ComponentHandler

Parameters:

component - the component

doPut

protected void doPut(java.lang.Object component)

Subclasses should overide this to return component to handler.

Parameters:

component - the component

newComponent

protected java.lang.Object newComponent()
                                 throws java.lang.Exception

Create a new component for handler.

Returns:

the new component

Throws:

java.lang.Exception - if unable to create new component

disposeComponent

protected void disposeComponent(java.lang.Object component)

Dispose of the specified component.

Parameters:

component - the component

dispose

public void dispose()

Dispose of the ComponentHandler and any associated Pools and Factories.

Specified by:

dispose in interface org.apache.avalon.framework.activity.Disposable

doDispose

protected void doDispose()

Dispose handler specific resources. Subclasses should overide this to provide their own funcitonality.

toString

public java.lang.String toString()

Represents the handler as a string.

Overrides:

toString in class java.lang.Object

Returns:

the string representation of the handler