Package org.apache.avalon.framework.component

Class 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

      All Methods Instance Methods Concrete Methods 
      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.