org.picocontainer.adapters
Class AbstractAdapter

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

All Implemented Interfaces:

Serializable, ComponentAdapter, ComponentMonitorStrategy

Direct Known Subclasses:

AbstractInjector, InstanceAdapter

public abstract class AbstractAdapter
extends Object
implements ComponentAdapter, ComponentMonitorStrategy, Serializable

Base class for a ComponentAdapter with general functionality. This implementation provides basic checks for a healthy implementation of a ComponentAdapter. It does not allow to use null for the component key or the implementation, ensures that the implementation is a concrete class and that the key is assignable from the implementation if the key represents a type.

Author:

Paul Hammant, Aslak Hellesøy, Jon Tirsén

See Also:

Serialized Form

Constructor Summary

AbstractAdapter(Object componentKey, Class componentImplementation)
Constructs a new ComponentAdapter for the given key and implementation.

AbstractAdapter(Object componentKey, Class componentImplementation, ComponentMonitor monitor)
Constructs a new ComponentAdapter for the given key and implementation.

Method Summary

void	accept(PicoVisitor visitor) Accepts a visitor for this ComponentAdapter.
void	changeMonitor(ComponentMonitor monitor) Changes the component monitor used
protected void	checkTypeCompatibility()
ComponentMonitor	currentMonitor() Returns the monitor currently used
ComponentAdapter	findAdapterOfType(Class componentAdapterType)
Class	getComponentImplementation() Retrieve the class of the component.
Object	getComponentKey() Retrieve the key associated with the component.
ComponentAdapter	getDelegate()
String	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, verify

Constructor Detail

AbstractAdapter

public AbstractAdapter(Object componentKey,
                       Class componentImplementation)

Constructs a new ComponentAdapter for the given key and implementation.

Parameters:

componentKey - the search key for this implementation

componentImplementation - the concrete implementation

AbstractAdapter

public AbstractAdapter(Object componentKey,
                       Class componentImplementation,
                       ComponentMonitor monitor)

Constructs a new ComponentAdapter for the given key and implementation.

Parameters:

componentKey - the search key for this implementation

componentImplementation - the concrete implementation

monitor - the component monitor used by this ComponentAdapter

Method Detail

getComponentKey

public Object getComponentKey()

Retrieve the key associated with the component.

Specified by:

getComponentKey in interface ComponentAdapter

Returns:

the component's key. Should either be a class type (normally an interface) or an identifier that is unique (within the scope of the current PicoContainer).

See Also:

ComponentAdapter.getComponentKey()

getComponentImplementation

public Class getComponentImplementation()

Retrieve the class of the component.

Specified by:

getComponentImplementation in interface ComponentAdapter

Returns:

the component's implementation class. Should normally be a concrete class (ie, a class that can be instantiated).

See Also:

ComponentAdapter.getComponentImplementation()

checkTypeCompatibility

protected void checkTypeCompatibility()

toString

public String toString()

Overrides:

toString in class Object

Returns:

Returns the ComponentAdapter's class name and the component's key.

See Also:

Object.toString()

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

Parameters:

visitor - the visitor.

changeMonitor

public void changeMonitor(ComponentMonitor monitor)

Description copied from interface: ComponentMonitorStrategy

Changes the component monitor used

Specified by:

changeMonitor in interface ComponentMonitorStrategy

Parameters:

monitor - the new ComponentMonitor to use

currentMonitor

public ComponentMonitor currentMonitor()

Returns the monitor currently used

Specified by:

currentMonitor in interface ComponentMonitorStrategy

Returns:

The ComponentMonitor currently used

getDelegate

public final ComponentAdapter getDelegate()

Specified by:

getDelegate in interface ComponentAdapter

findAdapterOfType

public final ComponentAdapter findAdapterOfType(Class componentAdapterType)

Specified by:

findAdapterOfType in interface ComponentAdapter