Package org.picocontainer.containers
Class AbstractDelegatingPicoContainer
- java.lang.Object
-
- org.picocontainer.containers.AbstractDelegatingPicoContainer
-
- All Implemented Interfaces:
java.io.Serializable
,Converting
,PicoContainer
- Direct Known Subclasses:
AbstractDelegatingMutablePicoContainer
,CommandLinePicoContainer
,PropertiesPicoContainer
public abstract class AbstractDelegatingPicoContainer extends java.lang.Object implements PicoContainer, Converting, java.io.Serializable
Abstract base class for immutable delegation to a PicoContainer- Author:
- Konstantin Pribluda
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description AbstractDelegatingPicoContainer(PicoContainer delegate)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
accept(PicoVisitor visitor)
Accepts a visitor that should visit the child containers, component adapters and component instances.boolean
equals(java.lang.Object obj)
<T> T
getComponent(java.lang.Class<T> componentType)
Retrieve a component keyed by the component type.<T> T
getComponent(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Retrieve a component keyed by the component type and binding type.java.lang.Object
getComponent(java.lang.Object componentKeyOrType)
Retrieve a component instance registered with a specific key or type.java.lang.Object
getComponent(java.lang.Object componentKeyOrType, java.lang.reflect.Type into)
<T> ComponentAdapter<T>
getComponentAdapter(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Find a component adapter associated with the specified type and binding type.<T> ComponentAdapter<T>
getComponentAdapter(java.lang.Class<T> componentType, NameBinding componentNameBinding)
Find a component adapter associated with the specified type and binding name.ComponentAdapter<?>
getComponentAdapter(java.lang.Object componentKey)
Find a component adapter associated with the specified key.java.util.Collection<ComponentAdapter<?>>
getComponentAdapters()
Retrieve all the component adapters inside this container.<T> java.util.List<ComponentAdapter<T>>
getComponentAdapters(java.lang.Class<T> componentType)
Retrieve all component adapters inside this container that are associated with the specified type.<T> java.util.List<ComponentAdapter<T>>
getComponentAdapters(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Retrieve all component adapters inside this container that are associated with the specified type and binding type.java.util.List<java.lang.Object>
getComponents()
Retrieve all the registered component instances in the container, (not including those in the parent container).<T> java.util.List<T>
getComponents(java.lang.Class<T> type)
Returns a List of components of a certain componentType.Converters
getConverters()
Retrieve the set of converters for transforming string parameters into objects.PicoContainer
getDelegate()
PicoContainer
getParent()
Retrieve the parent container of this container.java.lang.String
toString()
-
-
-
Constructor Detail
-
AbstractDelegatingPicoContainer
public AbstractDelegatingPicoContainer(PicoContainer delegate)
-
-
Method Detail
-
accept
public final void accept(PicoVisitor visitor)
Description copied from interface:PicoContainer
Accepts a visitor that should visit the child containers, component adapters and component instances.- Specified by:
accept
in interfacePicoContainer
- Parameters:
visitor
- the visitor
-
equals
public boolean equals(java.lang.Object obj)
- Overrides:
equals
in classjava.lang.Object
-
getComponent
public <T> T getComponent(java.lang.Class<T> componentType)
Description copied from interface:PicoContainer
Retrieve a component keyed by the component type.- Specified by:
getComponent
in interfacePicoContainer
- Parameters:
componentType
- the type of the component- Returns:
- the typed resulting object instance or null if the object does not exist.
-
getComponent
public <T> T getComponent(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Description copied from interface:PicoContainer
Retrieve a component keyed by the component type and binding type.- Specified by:
getComponent
in interfacePicoContainer
- Parameters:
componentType
- the type of the componentbinding
- the binding type of the component- Returns:
- the typed resulting object instance or null if the object does not exist.
-
getComponent
public java.lang.Object getComponent(java.lang.Object componentKeyOrType)
Description copied from interface:PicoContainer
Retrieve a component instance registered with a specific key or type. If a component cannot be found in this container, the parent container (if one exists) will be searched.- Specified by:
getComponent
in interfacePicoContainer
- Parameters:
componentKeyOrType
- the key or Type that the component was registered with.- Returns:
- an instantiated component, or
null
if no component has been registered for the specified key.
-
getComponent
public java.lang.Object getComponent(java.lang.Object componentKeyOrType, java.lang.reflect.Type into)
- Specified by:
getComponent
in interfacePicoContainer
-
getComponentAdapter
public <T> ComponentAdapter<T> getComponentAdapter(java.lang.Class<T> componentType, NameBinding componentNameBinding)
Description copied from interface:PicoContainer
Find a component adapter associated with the specified type and binding name. If a component adapter cannot be found in this container, the parent container (if one exists) will be searched.- Specified by:
getComponentAdapter
in interfacePicoContainer
- Parameters:
componentType
- the type of the component.componentNameBinding
- the name binding to use- Returns:
- the component adapter associated with this class, or
null
if no component has been registered for the specified key.
-
getComponentAdapter
public <T> ComponentAdapter<T> getComponentAdapter(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Description copied from interface:PicoContainer
Find a component adapter associated with the specified type and binding type. If a component adapter cannot be found in this container, the parent container (if one exists) will be searched.- Specified by:
getComponentAdapter
in interfacePicoContainer
- Parameters:
componentType
- the type of the component.binding
- the typed binding to use- Returns:
- the component adapter associated with this class, or
null
if no component has been registered for the specified key.
-
getComponentAdapter
public ComponentAdapter<?> getComponentAdapter(java.lang.Object componentKey)
Description copied from interface:PicoContainer
Find a component adapter associated with the specified key. If a component adapter cannot be found in this container, the parent container (if one exists) will be searched.- Specified by:
getComponentAdapter
in interfacePicoContainer
- Parameters:
componentKey
- the key that the component was registered with.- Returns:
- the component adapter associated with this key, or
null
if no component has been registered for the specified key.
-
getComponentAdapters
public java.util.Collection<ComponentAdapter<?>> getComponentAdapters()
Description copied from interface:PicoContainer
Retrieve all the component adapters inside this container. The component adapters from the parent container are not returned.- Specified by:
getComponentAdapters
in interfacePicoContainer
- Returns:
- a collection containing all the
ComponentAdapter
s inside this container. The collection will not be modifiable. - See Also:
a variant of this method which returns the component adapters inside this container that are associated with the specified type.
-
getComponentAdapters
public <T> java.util.List<ComponentAdapter<T>> getComponentAdapters(java.lang.Class<T> componentType)
Description copied from interface:PicoContainer
Retrieve all component adapters inside this container that are associated with the specified type. The addComponent adapters from the parent container are not returned.- Specified by:
getComponentAdapters
in interfacePicoContainer
- Parameters:
componentType
- the type of the components.- Returns:
- a collection containing all the
ComponentAdapter
s inside this container that are associated with the specified type. Changes to this collection will not be reflected in the container itself.
-
getComponentAdapters
public <T> java.util.List<ComponentAdapter<T>> getComponentAdapters(java.lang.Class<T> componentType, java.lang.Class<? extends java.lang.annotation.Annotation> binding)
Description copied from interface:PicoContainer
Retrieve all component adapters inside this container that are associated with the specified type and binding type. The addComponent adapters from the parent container are not returned.- Specified by:
getComponentAdapters
in interfacePicoContainer
- Parameters:
componentType
- the type of the components.binding
- the typed binding to use- Returns:
- a collection containing all the
ComponentAdapter
s inside this container that are associated with the specified type. Changes to this collection will not be reflected in the container itself.
-
getComponents
public java.util.List<java.lang.Object> getComponents()
Description copied from interface:PicoContainer
Retrieve all the registered component instances in the container, (not including those in the parent container). The components are returned in their order of instantiation, which depends on the dependency order between them.- Specified by:
getComponents
in interfacePicoContainer
- Returns:
- all the components.
-
getComponents
public <T> java.util.List<T> getComponents(java.lang.Class<T> type) throws PicoException
Description copied from interface:PicoContainer
Returns a List of components of a certain componentType. The list is ordered by instantiation order, starting with the components instantiated first at the beginning.- Specified by:
getComponents
in interfacePicoContainer
- Parameters:
type
- the searched type.- Returns:
- a List of components.
- Throws:
PicoException
- if the instantiation of a component fails
-
getDelegate
public PicoContainer getDelegate()
-
getParent
public PicoContainer getParent()
Description copied from interface:PicoContainer
Retrieve the parent container of this container.- Specified by:
getParent
in interfacePicoContainer
- Returns:
- a
PicoContainer
instance, ornull
if this container does not have a parent.
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
getConverters
public Converters getConverters()
Description copied from interface:Converting
Retrieve the set of converters for transforming string parameters into objects.- Specified by:
getConverters
in interfaceConverting
- Returns:
- converter set instance.
-
-