org.apache.avalon.excalibur.component

Class AbstractDualLogEnabledInstrumentable

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.apache.avalon.excalibur.component.AbstractDualLogEnabled

org.apache.avalon.excalibur.component.AbstractDualLogEnabledInstrumentable

All Implemented Interfaces:

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

Direct Known Subclasses:

ComponentHandler

Deprecated.

ECM is no longer supported

public abstract class AbstractDualLogEnabledInstrumentable
extends AbstractDualLogEnabled
implements org.apache.excalibur.instrument.Instrumentable

Utility class to ease the construction of components that can be instrumented but must also extend AbstractDualLogEnabled.

Subclasses should call addInstrument or addChildInstrumentable as part of the component's initialization.

Author:

Avalon Development Team

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.ArrayList	m_childList Deprecated. Stores the child instrumentables during initialization.
private java.lang.String	m_instrumentableName Deprecated. Name of the instrumentable.
private java.util.ArrayList	m_instrumentList Deprecated. Stores the instruments during initialization.
private boolean	m_registered Deprecated. Flag which is to used to keep track of when the Instrumentable has been registered.

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

EMPTY_INSTRUMENT_ARRAY, EMPTY_INSTRUMENTABLE_ARRAY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDualLogEnabledInstrumentable() Deprecated. Creates a new AbstractLogEnabledInstrumentable.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addChildInstrumentable(org.apache.excalibur.instrument.Instrumentable child) Deprecated. Adds a child Instrumentable to the list of child Instrumentables published by the component.
protected void	addInstrument(org.apache.excalibur.instrument.Instrument instrument) Deprecated. Adds an Instrument to the list of Instruments published by the component.
org.apache.excalibur.instrument.Instrumentable[]	getChildInstrumentables() Deprecated. Any Object which implements Instrumentable can also make use of other Instrumentable child objects.
java.lang.String	getInstrumentableName() Deprecated. Gets the name of the Instrumentable.
org.apache.excalibur.instrument.Instrument[]	getInstruments() Deprecated. Obtain a reference to all the Instruments that the Instrumentable object wishes to expose.
void	setInstrumentableName(java.lang.String name) Deprecated. Sets the name for the Instrumentable.

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_instrumentableName

private java.lang.String m_instrumentableName

Deprecated.

Name of the instrumentable.

m_instrumentList

private java.util.ArrayList m_instrumentList

Deprecated.

Stores the instruments during initialization.

m_childList

private java.util.ArrayList m_childList

Deprecated.

Stores the child instrumentables during initialization.

m_registered

private boolean m_registered

Deprecated.

Flag which is to used to keep track of when the Instrumentable has been registered.

Constructor Detail

AbstractDualLogEnabledInstrumentable

protected AbstractDualLogEnabledInstrumentable()

Deprecated.

Creates a new AbstractLogEnabledInstrumentable.

Method Detail

addInstrument

protected void addInstrument(org.apache.excalibur.instrument.Instrument instrument)

Deprecated.

Adds an Instrument to the list of Instruments published by the component. This method may not be called after the Instrumentable has been registered with the InstrumentManager.

Parameters:

instrument - Instrument to publish.

addChildInstrumentable

protected void addChildInstrumentable(org.apache.excalibur.instrument.Instrumentable child)

Deprecated.

Adds a child Instrumentable to the list of child Instrumentables published by the component. This method may not be called after the Instrumentable has been registered with the InstrumentManager.

Note that Child Instrumentables must be named by the caller using the setInstrumentableName method.

Parameters:

child - Child Instrumentable to publish.

getInstrumentableName

public final java.lang.String getInstrumentableName()

Deprecated.

Gets the name of the Instrumentable.

Specified by:

getInstrumentableName in interface org.apache.excalibur.instrument.Instrumentable

Returns:

The name used to identify a Instrumentable.

setInstrumentableName

public final void setInstrumentableName(java.lang.String name)

Deprecated.

Sets the name for the Instrumentable. The Instrumentable Name is used to uniquely identify the Instrumentable during the configuration of the InstrumentManager and to gain access to an InstrumentableDescriptor through the InstrumentManager. The value should be a string which does not contain spaces or periods.

This value may be set by a parent Instrumentable, or by the InstrumentManager using the value of the 'instrumentable' attribute in the configuration of the component.

Specified by:

setInstrumentableName in interface org.apache.excalibur.instrument.Instrumentable

Parameters:

name - The name used to identify a Instrumentable.

getChildInstrumentables

public final org.apache.excalibur.instrument.Instrumentable[] getChildInstrumentables()

Deprecated.

Any Object which implements Instrumentable can also make use of other Instrumentable child objects. This method is used to tell the InstrumentManager about them.

Specified by:

getChildInstrumentables in interface org.apache.excalibur.instrument.Instrumentable

Returns:

An array of child Instrumentables. This method should never return null. If there are no child Instrumentables, then EMPTY_INSTRUMENTABLE_ARRAY can be returned.

getInstruments

public final org.apache.excalibur.instrument.Instrument[] getInstruments()

Deprecated.

Obtain a reference to all the Instruments that the Instrumentable object wishes to expose. All sampling is done directly through the Instruments as opposed to the Instrumentable interface.

Specified by:

getInstruments in interface org.apache.excalibur.instrument.Instrumentable

Returns:

An array of the Instruments available for profiling. Should never be null. If there are no Instruments, then EMPTY_INSTRUMENT_ARRAY can be returned. This should never be the case though unless there are child Instrumentables with Instruments.