org.apache.avalon.framework.component
Class WrapperComponentManager

java.lang.Object
  extended byorg.apache.avalon.framework.component.WrapperComponentManager
All 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.

Since:
4.1.4
Version:
$Id: WrapperComponentManager.java 30977 2004-07-30 08:57:54Z niclas $
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(java.lang.String key)
          Check to see if a Component exists for a key.
 Component lookup(java.lang.String key)
          Retrieve a component via a key.
 void release(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
 

Constructor Detail

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 Detail

lookup

public Component lookup(java.lang.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

hasComponent

public boolean hasComponent(java.lang.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.

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 © 1997-2005 The Apache Software Foundation. All Rights Reserved.