org.picocontainer
Interface ComponentMonitor

All Known Implementing Classes:

AbstractComponentMonitor, ConsoleComponentMonitor, DefaultComponentMonitor, DelegatingComponentMonitor, LifecycleComponentMonitor, NullComponentMonitor, WriterComponentMonitor

public interface ComponentMonitor

A component monitor is responsible for monitoring the component instantiation and method invocation.

Since:

1.2

Version:

$Revision: 2971 $

Author:

Paul Hammant, Obie Fernandez, Aslak Hellesøy, Mauro Talevi

Method Summary

void	instantiated(java.lang.reflect.Constructor constructor, long duration) Deprecated. since 1.3
void	instantiated(java.lang.reflect.Constructor constructor, java.lang.Object instantiated, java.lang.Object[] injected, long duration) Event thrown after the component has been instantiated using the given constructor.
void	instantiating(java.lang.reflect.Constructor constructor) Event thrown as the component is being instantiated using the given constructor
void	instantiationFailed(java.lang.reflect.Constructor constructor, java.lang.Exception cause) Event thrown if the component instantiation failed using the given constructor
void	invocationFailed(java.lang.reflect.Method method, java.lang.Object instance, java.lang.Exception cause) Event thrown if the component method invocation failed on the given instance
void	invoked(java.lang.reflect.Method method, java.lang.Object instance, long duration) Event thrown after the component method has been invoked on the given instance
void	invoking(java.lang.reflect.Method method, java.lang.Object instance) Event thrown as the component method is being invoked on the given instance
void	lifecycleInvocationFailed(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

Method Detail

instantiating

void instantiating(java.lang.reflect.Constructor constructor)

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

Parameters:

constructor - the Constructor used to instantiate the component

instantiated

void instantiated(java.lang.reflect.Constructor constructor,
                  long duration)

Deprecated. since 1.3

Event thrown after the component has been instantiated using the given constructor

Parameters:

constructor - the Constructor used to instantiate the component

duration - the duration in millis of the instantiation

instantiated

void instantiated(java.lang.reflect.Constructor constructor,
                  java.lang.Object instantiated,
                  java.lang.Object[] injected,
                  long duration)

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

Parameters:

constructor - the Constructor used to instantiate the component

instantiated - the component that was instantiated by PicoContainer

injected - the components during instantiation.

duration - the duration in millis of the instantiation

Since:

1.3

instantiationFailed

void instantiationFailed(java.lang.reflect.Constructor constructor,
                         java.lang.Exception cause)

Event thrown if the component instantiation failed using the given constructor

Parameters:

constructor - the Constructor used to instantiate the component

cause - the Exception detailing the cause of the failure

invoking

void invoking(java.lang.reflect.Method method,
              java.lang.Object instance)

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

Parameters:

method - the Method invoked on the component instance

instance - the component instance

invoked

void invoked(java.lang.reflect.Method method,
             java.lang.Object instance,
             long duration)

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

Parameters:

method - the Method invoked on the component instance

instance - the component instance

duration - the duration in millis of the invocation

invocationFailed

void invocationFailed(java.lang.reflect.Method method,
                      java.lang.Object instance,
                      java.lang.Exception cause)

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

Parameters:

method - the Method invoked on the component instance

instance - the component instance

cause - the Exception detailing the cause of the failure

lifecycleInvocationFailed

void lifecycleInvocationFailed(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

Parameters:

method - the lifecycle Method invoked on the component instance

instance - the component instance

cause - the RuntimeException detailing the cause of the failure