org.picocontainer.injectors
Class AbstractInjector

java.lang.Object
  org.picocontainer.adapters.AbstractAdapter
      org.picocontainer.injectors.AbstractInjector

All Implemented Interfaces:

Serializable, ComponentAdapter, ComponentMonitorStrategy, LifecycleStrategy

Direct Known Subclasses:

IterativeInjector, MultiInjector, SingleMemberInjector

public abstract class AbstractInjector
extends AbstractAdapter
implements LifecycleStrategy

This ComponentAdapter will instantiate a new object for each call to ComponentAdapter.getComponentInstance(PicoContainer). That means that when used with a PicoContainer, getComponent will return a new object each time.

Author:

Aslak Hellesøy, Paul Hammant, Jörg Schaible, Mauro Talevi

See Also:

Serialized Form

Nested Class Summary

static class	AbstractInjector.AmbiguousComponentResolutionException Exception that is thrown as part of the introspection.
static class	AbstractInjector.CyclicDependencyException
static class	AbstractInjector.NotConcreteRegistrationException
static class	AbstractInjector.UnsatisfiableDependenciesException Exception thrown when some of the component's dependencies are not satisfiable.

Field Summary

protected LifecycleStrategy	lifecycleStrategy The strategy used to control the lifecycle
protected Parameter[]	parameters The parameters to use for initialization.
protected org.picocontainer.injectors.AbstractInjector.ThreadLocalCyclicDependencyGuard	verifyingGuard The cycle guard for the verification.

Constructor Summary

protected

AbstractInjector(Object componentKey, Class componentImplementation, Parameter[] parameters, ComponentMonitor monitor, LifecycleStrategy lifecycleStrategy) Constructs a new ComponentAdapter for the given key and implementation.

Method Summary

void	accept(PicoVisitor visitor) Accepts a visitor for this ComponentAdapter.
protected Object	caughtIllegalAccessException(ComponentMonitor componentMonitor, Constructor constructor, IllegalAccessException e, PicoContainer container)
protected Object	caughtIllegalAccessException(ComponentMonitor componentMonitor, Member member, Object componentInstance, IllegalAccessException e)
protected Object	caughtInstantiationException(ComponentMonitor componentMonitor, Constructor constructor, InstantiationException e, PicoContainer container)
protected Object	caughtInvocationTargetException(ComponentMonitor componentMonitor, Member member, Object componentInstance, InvocationTargetException e)
protected Parameter[]	createDefaultParameters(Class[] parameters) Create default parameters for the given types.
void	dispose(Object component) Invoke the "dispose" method on the component instance if this is disposable.
boolean	hasLifecycle(Class type) Test if a component instance has a lifecycle.
protected Object	newInstance(Constructor constructor, Object[] parameters) Instantiate an object with given parameters and respect the accessible flag.
void	start(Object component) Invoke the "start" method on the component instance if this is startable.
void	stop(Object component) Invoke the "stop" method on the component instance if this is stoppable.
abstract void	verify(PicoContainer container) Verify that all dependencies for this adapter can be satisifed.

Methods inherited from class org.picocontainer.adapters.AbstractAdapter

changeMonitor, checkTypeCompatibility, currentMonitor, findAdapterOfType, getComponentImplementation, getComponentKey, getDelegate, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.picocontainer.ComponentAdapter

getComponentInstance

Field Detail

verifyingGuard

protected transient org.picocontainer.injectors.AbstractInjector.ThreadLocalCyclicDependencyGuard verifyingGuard

The cycle guard for the verification.

parameters

protected transient Parameter[] parameters

The parameters to use for initialization.

lifecycleStrategy

protected LifecycleStrategy lifecycleStrategy

The strategy used to control the lifecycle

Constructor Detail

AbstractInjector

protected AbstractInjector(Object componentKey,
                           Class componentImplementation,
                           Parameter[] parameters,
                           ComponentMonitor monitor,
                           LifecycleStrategy lifecycleStrategy)

Constructs a new ComponentAdapter for the given key and implementation.

Parameters:

componentKey - the search key for this implementation

componentImplementation - the concrete implementation

parameters - the parameters to use for the initialization

monitor - the component monitor used by this ComponentAdapter

lifecycleStrategy - the lifecycle strategy used by this ComponentAdapter

Throws:

AbstractInjector.NotConcreteRegistrationException - if the implementation is not a concrete class

NullPointerException - if one of the parameters is null

Method Detail

createDefaultParameters

protected Parameter[] createDefaultParameters(Class[] parameters)

Create default parameters for the given types.

Parameters:

parameters - the parameter types

Returns:

the array with the default parameters.

verify

public abstract void verify(PicoContainer container)
                     throws PicoCompositionException

Description copied from interface: ComponentAdapter

Verify that all dependencies for this adapter can be satisifed. Normally, the adapter should verify this by checking that the associated PicoContainer contains all the needed dependnecies.

Specified by:

verify in interface ComponentAdapter

Parameters:

container - the PicoContainer, that is used to resolve any possible dependencies of the instance.

Throws:

PicoCompositionException - if one or more dependencies cannot be resolved.

accept

public void accept(PicoVisitor visitor)

Description copied from interface: ComponentAdapter

Accepts a visitor for this ComponentAdapter. The method is normally called by visiting a PicoContainer, that cascades the visitor also down to all its ComponentAdapter instances.

Specified by:

accept in interface ComponentAdapter

Overrides:

accept in class AbstractAdapter

Parameters:

visitor - the visitor.

start

public void start(Object component)

Description copied from interface: LifecycleStrategy

Invoke the "start" method on the component instance if this is startable. It is up to the implementation of the strategy what "start" and "startable" means.

Specified by:

start in interface LifecycleStrategy

Parameters:

component - the instance of the component to start

stop

public void stop(Object component)

Description copied from interface: LifecycleStrategy

Invoke the "stop" method on the component instance if this is stoppable. It is up to the implementation of the strategy what "stop" and "stoppable" means.

Specified by:

stop in interface LifecycleStrategy

Parameters:

component - the instance of the component to stop

dispose

public void dispose(Object component)

Description copied from interface: LifecycleStrategy

Invoke the "dispose" method on the component instance if this is disposable. It is up to the implementation of the strategy what "dispose" and "disposable" means.

Specified by:

dispose in interface LifecycleStrategy

Parameters:

component - the instance of the component to dispose

hasLifecycle

public boolean hasLifecycle(Class type)

Description copied from interface: LifecycleStrategy

Test if a component instance has a lifecycle.

Specified by:

hasLifecycle in interface LifecycleStrategy

Parameters:

type - the component's type

Returns:

true if the component has a lifecycle

newInstance

protected Object newInstance(Constructor constructor,
                             Object[] parameters)
                      throws InstantiationException,
                             IllegalAccessException,
                             InvocationTargetException

Instantiate an object with given parameters and respect the accessible flag.

Parameters:

constructor - the constructor to use

parameters - the parameters for the constructor

Returns:

the new object.

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

caughtInstantiationException

protected Object caughtInstantiationException(ComponentMonitor componentMonitor,
                                              Constructor constructor,
                                              InstantiationException e,
                                              PicoContainer container)

caughtIllegalAccessException

protected Object caughtIllegalAccessException(ComponentMonitor componentMonitor,
                                              Constructor constructor,
                                              IllegalAccessException e,
                                              PicoContainer container)

caughtInvocationTargetException

protected Object caughtInvocationTargetException(ComponentMonitor componentMonitor,
                                                 Member member,
                                                 Object componentInstance,
                                                 InvocationTargetException e)

caughtIllegalAccessException

protected Object caughtIllegalAccessException(ComponentMonitor componentMonitor,
                                              Member member,
                                              Object componentInstance,
                                              IllegalAccessException e)