org.picocontainer
Interface ComponentFactory

All Known Subinterfaces:

BehaviorFactory, InjectionFactory

All Known Implementing Classes:

AbstractBehaviorFactory, AdaptiveBehavior, AdaptiveInjection, AnnotatedFieldInjection, AnnotatedMethodInjection, Automatic, Caching, ConstructorInjection, ImplementationHiding, Interception, Locking, MethodInjection, MultiInjection, OptInCaching, PropertyApplying, SetterInjection, Storing, Synchronizing, ThreadCaching

public interface ComponentFactory

A component factory is responsible for creating ComponentAdapter component adapters. The main use of the component factory is inside DefaultPicoContainer.DefaultPicoContainer(ComponentFactory), where it can be used to customize the default component adapter that is used when none is specified explicitly.

Author:

Paul Hammant, Mauro Talevi, Jon Tirsén

Method Summary

<T> ComponentAdapter<T>

createComponentAdapter(ComponentMonitor componentMonitor, LifecycleStrategy lifecycleStrategy, Properties componentProperties, Object componentKey, Class<T> componentImplementation, Parameter... parameters) Create a new component adapter based on the specified arguments.

Method Detail

createComponentAdapter

<T> ComponentAdapter<T> createComponentAdapter(ComponentMonitor componentMonitor,
                                               LifecycleStrategy lifecycleStrategy,
                                               Properties componentProperties,
                                               Object componentKey,
                                               Class<T> componentImplementation,
                                               Parameter... parameters)
                                           throws PicoCompositionException

Create a new component adapter based on the specified arguments.

Parameters:

componentMonitor - the component monitor

lifecycleStrategy - te lifecycle strategy

componentProperties - 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.