Package org.picocontainer.monitors

Class AbstractComponentMonitor

java.lang.Object

org.picocontainer.monitors.AbstractComponentMonitor

All Implemented Interfaces:

java.io.Serializable, ComponentMonitor, ComponentMonitorStrategy

Direct Known Subclasses:

ComposingMonitor

public class AbstractComponentMonitor
extends java.lang.Object
implements ComponentMonitor, ComponentMonitorStrategy, java.io.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

Field Summary

Fields inherited from interface org.picocontainer.ComponentMonitor

KEEP

Constructor Summary

Constructors

Constructor	Description
AbstractComponentMonitor()	Creates a AbstractComponentMonitor with an instance of NullComponentMonitor.
AbstractComponentMonitor(ComponentMonitor delegate)	Creates a AbstractComponentMonitor with a given delegate

Method Summary

Modifier and Type	Method	Description
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
<T> void	instantiated(PicoContainer container, ComponentAdapter<T> componentAdapter, java.lang.reflect.Constructor<T> constructor, java.lang.Object instantiated, java.lang.Object[] injected, long duration)	Event thrown after the component has been instantiated using the given constructor.
<T> java.lang.reflect.Constructor<T>	instantiating(PicoContainer container, ComponentAdapter<T> componentAdapter, java.lang.reflect.Constructor<T> constructor)	Event thrown as the component is being instantiated using the given constructor
<T> void	instantiationFailed(PicoContainer container, ComponentAdapter<T> componentAdapter, java.lang.reflect.Constructor<T> constructor, java.lang.Exception e)	Event thrown if the component instantiation failed using the given constructor
void	invocationFailed(java.lang.reflect.Member member, java.lang.Object instance, java.lang.Exception e)	Event thrown if the component method invocation failed on the given instance
void	invoked(PicoContainer container, ComponentAdapter<?> componentAdapter, java.lang.reflect.Member member, java.lang.Object instance, long duration, java.lang.Object[] args, java.lang.Object retVal)	Event thrown after the component method has been invoked on the given instance
java.lang.Object	invoking(PicoContainer container, ComponentAdapter<?> componentAdapter, java.lang.reflect.Member member, java.lang.Object instance, java.lang.Object[] args)	Event thrown as the component method is being invoked on the given instance
void	lifecycleInvocationFailed(MutablePicoContainer container, ComponentAdapter<?> componentAdapter, java.lang.reflect.Method method, java.lang.Object instance, java.lang.RuntimeException cause)	Event thrown if a lifecycle method invocation - start, stop or dispose - failed on the given instance
Behavior	newBehavior(Behavior behavior)	A mechanism to monitor or override the Behaviors being made for components.
Injector	newInjector(Injector injector)	A mechanism to monitor or override the Injectors being made for components.
java.lang.Object	noComponentFound(MutablePicoContainer container, java.lang.Object componentKey)	No Component has been found for the key in question.

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 <T> java.lang.reflect.Constructor<T> instantiating(PicoContainer container,
                                                          ComponentAdapter<T> componentAdapter,
                                                          java.lang.reflect.Constructor<T> 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 <T> void instantiated(PicoContainer container,
                             ComponentAdapter<T> componentAdapter,
                             java.lang.reflect.Constructor<T> constructor,
                             java.lang.Object instantiated,
                             java.lang.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 milliseconds of the instantiation

instantiationFailed

public <T> void instantiationFailed(PicoContainer container,
                                    ComponentAdapter<T> componentAdapter,
                                    java.lang.reflect.Constructor<T> constructor,
                                    java.lang.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 java.lang.Object invoking(PicoContainer container,
                                 ComponentAdapter<?> componentAdapter,
                                 java.lang.reflect.Member member,
                                 java.lang.Object instance,
                                 java.lang.Object[] args)

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,
                    java.lang.reflect.Member member,
                    java.lang.Object instance,
                    long duration,
                    java.lang.Object[] args,
                    java.lang.Object retVal)

Description copied from interface: ComponentMonitor

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

Specified by:

invoked in interface ComponentMonitor

instance - the component instance

invocationFailed

public void invocationFailed(java.lang.reflect.Member member,
                             java.lang.Object instance,
                             java.lang.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,
                                      java.lang.reflect.Method method,
                                      java.lang.Object instance,
                                      java.lang.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 java.lang.Object noComponentFound(MutablePicoContainer container,
                                         java.lang.Object componentKey)

Description copied from interface: ComponentMonitor

No Component has been found for the key in question. Implementers of this have a last chance opportunity to specify something for the need. This is only relevant to component dependencies, and not to container.getComponent() in your user code.

Specified by:

noComponentFound in interface ComponentMonitor

newInjector

public Injector newInjector(Injector injector)

Description copied from interface: ComponentMonitor

A mechanism to monitor or override the Injectors being made for components.

Specified by:

newInjector in interface ComponentMonitor

Returns:

an Injector. For most implementations, the same one as was passed in.

newBehavior

public Behavior newBehavior(Behavior behavior)

Description copied from interface: ComponentMonitor

A mechanism to monitor or override the Behaviors being made for components.

Specified by:

newBehavior in interface ComponentMonitor

Returns:

an Behavior. For most implementations, the same one as was passed in.

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