org.picocontainer.injectors
Class ConstructorInjection

java.lang.Object
  extended by org.picocontainer.injectors.AbstractInjectionFactory
      extended by org.picocontainer.injectors.ConstructorInjection
All Implemented Interfaces:
Serializable, ComponentFactory, InjectionFactory
Direct Known Subclasses:
ForgetfulConstructorInjection

public class ConstructorInjection
extends AbstractInjectionFactory

A InjectionFactory for constructor injection. The factory creates ConstructorInjector. If there is more than one constructor for the component, the one with the most satisfiable parameters will be used. By default, the choice of constructor for the component in question will be remembered between usages.

Author:
Paul Hammant, Jon Tirsén
See Also:
Serialized Form

Constructor Summary
ConstructorInjection()
          Will remember which constructor to use between usages on the associated Injector.
ConstructorInjection(boolean rememberChosenConstructor)
           
 
Method Summary
<T> ComponentAdapter<T>
createComponentAdapter(ComponentMonitor monitor, LifecycleStrategy lifecycleStrategy, Properties properties, Object componentKey, Class<T> componentImplementation, Parameter... parameters)
          Create a new component adapter based on the specified arguments.
 
Methods inherited from class org.picocontainer.injectors.AbstractInjectionFactory
accept, verify, wrapLifeCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConstructorInjection

public ConstructorInjection(boolean rememberChosenConstructor)
Parameters:
rememberChosenConstructor - whether 'which constructor?' should be remembered from use to use for the associated injector.

ConstructorInjection

public ConstructorInjection()
Will remember which constructor to use between usages on the associated Injector.

Method Detail

createComponentAdapter

public <T> ComponentAdapter<T> createComponentAdapter(ComponentMonitor monitor,
                                                      LifecycleStrategy lifecycleStrategy,
                                                      Properties properties,
                                                      Object componentKey,
                                                      Class<T> componentImplementation,
                                                      Parameter... parameters)
                                           throws PicoCompositionException
Description copied from interface: ComponentFactory
Create a new component adapter based on the specified arguments.

Parameters:
monitor - the component monitor
lifecycleStrategy - te lifecycle strategy
properties - the component properties
componentKey - the key to be associated with this adapter. This value should be returned from a call to ComponentAdapter.getComponentKey() on the created adapter.
componentImplementation - the implementation class to be associated with this adapter. This value should be returned from a call to ComponentAdapter.getComponentImplementation() on the created adapter. Should not be null.
parameters - additional parameters to use by the component adapter in constructing component instances. These may be used, for example, to make decisions about the arguments passed into the component constructor. These should be considered hints; they may be ignored by some implementations. May be null, and may be of zero length.
Returns:
a new component adapter based on the specified arguments. Should not return null.
Throws:
PicoCompositionException - if the creation of the component adapter results in a PicoCompositionException.


Copyright © 2003-2010 Codehaus. All Rights Reserved.