org.picocontainer.monitors
Class AbstractComponentMonitor

java.lang.Object
  org.picocontainer.monitors.AbstractComponentMonitor

All Implemented Interfaces:

Serializable, ComponentMonitor, ComponentMonitorStrategy

public class AbstractComponentMonitor
extends Object
implements ComponentMonitor, ComponentMonitorStrategy, Serializable

A monitor which delegates to another monitor. It provides a default ComponentMonitor, but does not allow to use null for the delegate.

It also supports a monitor strategy that allows to change the delegate.

Author:

Mauro Talevi

See Also:

Serialized Form

Constructor Summary

AbstractComponentMonitor()
Creates a AbstractComponentMonitor with an instance of NullComponentMonitor.

AbstractComponentMonitor(ComponentMonitor delegate)
Creates a AbstractComponentMonitor with a given delegate

Method Summary

void	changeMonitor(ComponentMonitor monitor) If the delegate supports a monitor strategy, this is used to changed the monitor while keeping the same delegate.
ComponentMonitor	currentMonitor() Returns the monitor currently used
void	instantiated(PicoContainer container, ComponentAdapter componentAdapter, Constructor constructor, Object instantiated, Object[] injected, long duration) Event thrown after the component has been instantiated using the given constructor.
Constructor	instantiating(PicoContainer container, ComponentAdapter componentAdapter, Constructor constructor) Event thrown as the component is being instantiated using the given constructor
void	instantiationFailed(PicoContainer container, ComponentAdapter componentAdapter, Constructor constructor, Exception e) Event thrown if the component instantiation failed using the given constructor
void	invocationFailed(Member member, Object instance, Exception e) Event thrown if the component method invocation failed on the given instance
void	invoked(PicoContainer container, ComponentAdapter componentAdapter, Method method, Object instance, long duration) Event thrown after the component method has been invoked on the given instance
void	invoking(PicoContainer container, ComponentAdapter componentAdapter, Member member, Object instance) Event thrown as the component method is being invoked on the given instance
void	lifecycleInvocationFailed(MutablePicoContainer container, ComponentAdapter componentAdapter, Method method, Object instance, RuntimeException cause) Event thrown if a lifecycle method invocation - start, stop or dispose - failed on the given instance
Object	noComponentFound(MutablePicoContainer container, Object componentKey)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractComponentMonitor

public AbstractComponentMonitor(ComponentMonitor delegate)

Creates a AbstractComponentMonitor with a given delegate

Parameters:

delegate - the ComponentMonitor to which this monitor delegates

AbstractComponentMonitor

public AbstractComponentMonitor()

Creates a AbstractComponentMonitor with an instance of NullComponentMonitor.

Method Detail

instantiating

public Constructor instantiating(PicoContainer container,
                                 ComponentAdapter componentAdapter,
                                 Constructor constructor)

Description copied from interface: ComponentMonitor

Event thrown as the component is being instantiated using the given constructor

Specified by:

instantiating in interface ComponentMonitor

constructor - the Constructor used to instantiate the addComponent @return the constructor to use in instantiation (nearly always the same one as passed in)

instantiated

public void instantiated(PicoContainer container,
                         ComponentAdapter componentAdapter,
                         Constructor constructor,
                         Object instantiated,
                         Object[] injected,
                         long duration)

Description copied from interface: ComponentMonitor

Event thrown after the component has been instantiated using the given constructor. This should be called for both Constructor and Setter DI.

Specified by:

instantiated in interface ComponentMonitor

constructor - the Constructor used to instantiate the addComponent

instantiated - the component that was instantiated by PicoContainer

injected - the components during instantiation.

duration - the duration in millis of the instantiation

instantiationFailed

public void instantiationFailed(PicoContainer container,
                                ComponentAdapter componentAdapter,
                                Constructor constructor,
                                Exception e)

Description copied from interface: ComponentMonitor

Event thrown if the component instantiation failed using the given constructor

Specified by:

instantiationFailed in interface ComponentMonitor

constructor - the Constructor used to instantiate the addComponent

e - the Exception detailing the cause of the failure

invoking

public void invoking(PicoContainer container,
                     ComponentAdapter componentAdapter,
                     Member member,
                     Object instance)

Description copied from interface: ComponentMonitor

Event thrown as the component method is being invoked on the given instance

Specified by:

invoking in interface ComponentMonitor

instance - the component instance

invoked

public void invoked(PicoContainer container,
                    ComponentAdapter componentAdapter,
                    Method method,
                    Object instance,
                    long duration)

Description copied from interface: ComponentMonitor

Event thrown after the component method has been invoked on the given instance

Specified by:

invoked in interface ComponentMonitor

method - the Method invoked on the component instance

instance - the component instance

duration - the duration in millis of the invocation

invocationFailed

public void invocationFailed(Member member,
                             Object instance,
                             Exception e)

Description copied from interface: ComponentMonitor

Event thrown if the component method invocation failed on the given instance

Specified by:

invocationFailed in interface ComponentMonitor

instance - the component instance

e - the Exception detailing the cause of the failure

lifecycleInvocationFailed

public void lifecycleInvocationFailed(MutablePicoContainer container,
                                      ComponentAdapter componentAdapter,
                                      Method method,
                                      Object instance,
                                      RuntimeException cause)

Description copied from interface: ComponentMonitor

Event thrown if a lifecycle method invocation - start, stop or dispose - failed on the given instance

Specified by:

lifecycleInvocationFailed in interface ComponentMonitor

method - the lifecycle Method invoked on the component instance

instance - the component instance

cause - the RuntimeException detailing the cause of the failure

noComponentFound

public Object noComponentFound(MutablePicoContainer container,
                               Object componentKey)

Specified by:

noComponentFound in interface ComponentMonitor

changeMonitor

public void changeMonitor(ComponentMonitor monitor)

If the delegate supports a monitor strategy, this is used to changed the monitor while keeping the same delegate. Else the delegate is replaced by the new monitor. Changes the component monitor used

Specified by:

changeMonitor in interface ComponentMonitorStrategy

Parameters:

monitor - the new ComponentMonitor to use

currentMonitor

public ComponentMonitor currentMonitor()

Description copied from interface: ComponentMonitorStrategy

Returns the monitor currently used

Specified by:

currentMonitor in interface ComponentMonitorStrategy

Returns:

The ComponentMonitor currently used