Package org.apache.avalon.framework.component

Class WrapperComponentManager

java.lang.Object

org.apache.avalon.framework.component.WrapperComponentManager

All Implemented Interfaces:

org.apache.avalon.framework.component.ComponentManager

public class WrapperComponentManager
extends java.lang.Object
implements org.apache.avalon.framework.component.ComponentManager

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

Since:

4.1.4

Version:

$Id: WrapperComponentManager.java 30977 2004-07-30 03:57:54 -0500 (Fri, 30 Jul 2004) niclas $

Author:

Avalon Development Team

Field Summary

Fields

Modifier and Type	Field	Description
private org.apache.avalon.framework.service.ServiceManager	m_manager	The service manager we are adapting.

Constructor Summary

Constructors

Constructor	Description
WrapperComponentManager(org.apache.avalon.framework.service.ServiceManager manager)	Creation of a new wrapper component manger using a supplied service manager as a source backing the wrapped.

Method Summary

Modifier and Type	Method	Description
boolean	hasComponent(java.lang.String key)	Check to see if a Component exists for a key.
org.apache.avalon.framework.component.Component	lookup(java.lang.String key)	Retrieve a component via a key.
void	release(org.apache.avalon.framework.component.Component component)	Return the Component when you are finished with it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_manager

private final org.apache.avalon.framework.service.ServiceManager m_manager

The service manager we are adapting.

Constructor Detail

WrapperComponentManager

public WrapperComponentManager(org.apache.avalon.framework.service.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 Detail

lookup

public org.apache.avalon.framework.component.Component lookup(java.lang.String key)
                                                       throws org.apache.avalon.framework.component.ComponentException

Retrieve a component via a key.

Specified by:

lookup in interface org.apache.avalon.framework.component.ComponentManager

Parameters:

key - the key

Returns:

the component

Throws:

org.apache.avalon.framework.component.ComponentException - if unable to aquire component

hasComponent

public boolean hasComponent(java.lang.String key)

Check to see if a Component exists for a key.

Specified by:

hasComponent in interface org.apache.avalon.framework.component.ComponentManager

Parameters:

key - a string identifying the key to check.

Returns:

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

release

public void release(org.apache.avalon.framework.component.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 org.apache.avalon.framework.component.ComponentManager

Parameters:

component - The Component we are releasing.