org.apache.avalon.framework.component

Class WrapperComponentManager

Implemented Interfaces:
ComponentManager

public class WrapperComponentManager
extends java.lang.Object
implements ComponentManager

This is a ComponentManager implementation that can wrap around a ServiceManager object effectively adapting a ServiceManager interface to a ComponentManager interface.

Version:
CVS $Revision: 1.14 $ $Date: 2003/02/14 15:13:12 $

Author:
Avalon Development Team

Constructor Summary

WrapperComponentManager(ServiceManager manager)
Creation of a new wrapper component manger using a supplied service manager as a source backing the wrapped.

Method Summary

boolean
hasComponent(String key)
Check to see if a Component exists for a key.
Component
lookup(String key)
Retrieve a component via a key.
void
release(Component component)
Return the Component when you are finished with it.

Constructor Details

WrapperComponentManager

public WrapperComponentManager(ServiceManager manager)
Creation of a new wrapper component manger using a supplied service manager as a source backing the wrapped. This implementation redirects lookup requests to the supplied service manager provided under this constructor. No attempt is made to proxy object supplied by the primary manager as Component instances - as such, it is the responsibility of the application establishing the wrapper to ensure that objects accessed via the primary manager implement the Component interface.

Parameters:
manager - the service manager backing the wrapper.

Method Details

hasComponent

public boolean hasComponent(String key)
Check to see if a Component exists for a key.
Specified by:
hasComponent in interface ComponentManager

Parameters:
key - a string identifying the key to check.

Returns:
True if the component exists, False if it does not.


lookup

public Component lookup(String key)
            throws ComponentException
Retrieve a component via a key.
Specified by:
lookup in interface ComponentManager

Parameters:
key - the key

Returns:
the component

Throws:
ComponentException - if unable to aquire component


release

public void release(Component component)
Return the Component when you are finished with it. This allows the ComponentManager to handle the End-Of-Life Lifecycle events associated with the Component. Please note, that no Exceptions should be thrown at this point. This is to allow easy use of the ComponentManager system without having to trap Exceptions on a release.
Specified by:
release in interface ComponentManager

Parameters:
component - The Component we are releasing.


"Copyright B) 2001 Apache Jakarta Project. All Rights Reserved."