org.apache.avalon.fortress.impl.lookup
Class FortressServiceManager

java.lang.Object
  extended byorg.apache.avalon.fortress.impl.lookup.FortressServiceManager
All Implemented Interfaces:
ServiceManager

public class FortressServiceManager
extends java.lang.Object
implements ServiceManager

This is the Default ServiceManager for the Container. It provides a very simple abstraction, and makes it easy for the Container to manage the references.

Version:
CVS $Revision: 1.22 $ $Date: 2004/03/13 17:57:59 $
Author:
Avalon Development Team

Constructor Summary
FortressServiceManager(Container container, ServiceManager parent)
          This constructor is for a ContainerComponentManager with a parent ComponentLocator
 
Method Summary
 boolean hasService(java.lang.String role)
          Check to see if a Object exists for a key.
 java.lang.Object lookup(java.lang.String role)
          Get the Object associated with the given key.
 void release(java.lang.Object component)
          Return the Object 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

FortressServiceManager

public FortressServiceManager(Container container,
                              ServiceManager parent)
                       throws java.lang.NullPointerException
This constructor is for a ContainerComponentManager with a parent ComponentLocator

Parameters:
container - the impl
parent - the parent service manager
Throws:
java.lang.NullPointerException - if the supplied impl is null
Method Detail

lookup

public java.lang.Object lookup(java.lang.String role)
                        throws ServiceException
Description copied from interface: ServiceManager
Get the Object associated with the given key. For instance, If the ServiceManager had a LoggerComponent stored and referenced by key, the following could be used:
 try
 {
     LoggerComponent log;
     myComponent = (LoggerComponent) manager.lookup( LoggerComponent.ROLE );
 }
 catch (...)
 {
     ...
 }
 

Specified by:
lookup in interface ServiceManager
Parameters:
role - The lookup key of the Object to retrieve.
Returns:
an Object value
Throws:
ServiceException - if an error occurs

hasService

public boolean hasService(java.lang.String role)
Description copied from interface: ServiceManager
Check to see if a Object exists for a key.

Specified by:
hasService in interface ServiceManager
Parameters:
role - a string identifying the key to check.
Returns:
True if the object exists, False if it does not.

release

public void release(java.lang.Object component)
Description copied from interface: ServiceManager
Return the Object when you are finished with it. This allows the ServiceManager to handle the End-Of-Life Lifecycle events associated with the Object. Please note, that no Exception should be thrown at this point. This is to allow easy use of the ServiceManager system without having to trap Exceptions on a release.

Specified by:
release in interface ServiceManager
Parameters:
component - The Object we are releasing, may also be a null reference


Copyright © 1997-2005 The Apache Software Foundation. All Rights Reserved.