Package org.picocontainer.containers

Class ImmutablePicoContainer

java.lang.Object

org.picocontainer.containers.ImmutablePicoContainer

All Implemented Interfaces:

java.io.Serializable, Converting, PicoContainer

public final class ImmutablePicoContainer
extends java.lang.Object
implements PicoContainer, Converting, java.io.Serializable

wrap pico container to achieve immutability Typically its used to mock a parent container.

Author:

Konstantin Pribluda

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
ImmutablePicoContainer(PicoContainer delegate)

Method Summary

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	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> componentType)	Returns a List of components of a certain componentType.
Converters	getConverters()	Retrieve the set of converters for transforming string parameters into objects.
PicoContainer	getParent()	Retrieve the parent container of this container.
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ImmutablePicoContainer

public ImmutablePicoContainer(PicoContainer delegate)

Method Detail

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 interface PicoContainer

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 interface PicoContainer

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 interface PicoContainer

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 interface PicoContainer

Parameters:

componentType - the type of the component

binding - the binding type of the component

Returns:

the typed resulting object instance or null if the object does not exist.

getComponents

public java.util.List 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 interface PicoContainer

Returns:

all the components.

getParent

public PicoContainer getParent()

Description copied from interface: PicoContainer

Retrieve the parent container of this container.

Specified by:

getParent in interface PicoContainer

Returns:

a PicoContainer instance, or null if this container does not have a parent.

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 interface PicoContainer

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.

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 interface PicoContainer

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 interface PicoContainer

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.

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 interface PicoContainer

Returns:

a collection containing all the ComponentAdapters 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 interface PicoContainer

Parameters:

componentType - the type of the components.

Returns:

a collection containing all the ComponentAdapters 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 interface PicoContainer

Parameters:

componentType - the type of the components.

binding - the typed binding to use

Returns:

a collection containing all the ComponentAdapters inside this container that are associated with the specified type. Changes to this collection will not be reflected in the container itself.

getComponents

public <T> java.util.List<T> getComponents(java.lang.Class<T> componentType)

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 interface PicoContainer

Parameters:

componentType - the searched type.

Returns:

a List of components.

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 interface PicoContainer

Parameters:

visitor - the visitor

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.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 interface Converting

Returns:

converter set instance.