Interface ComponentManager
-
- All Known Implementing Classes:
DefaultComponentManager
,WrapperComponentManager
public interface ComponentManager
AComponentManager
selectsComponent
s based on a role. The contract is that all theComponent
s implement the differing roles and there is oneComponent
per role. If you need to select on of manyComponent
s that implement the same role, then you need to use aComponentSelector
. Roles are usually the full interface name.A role is better understood by the analogy of a play. There are many different roles in a script. Any actor or actress can play any given part and you get the same results (phrases said, movements made, etc.). The exact nuances of the performance is different.
Below is a list of things that might be considered the different roles:
- InputAdapter and OutputAdapter
- Store and Spool
The
ComponentManager
does not specify the methodology of getting theComponent
, merely the interface used to get it. Therefore theComponentManager
can be implemented with a factory pattern, an object pool, or a simple Hashtable.Deprecated: Use
ServiceManager
instead.- Version:
- CVS $Revision: 1.19 $ $Date: 2003/02/11 15:58:38 $
- Author:
- Avalon Development Team
- See Also:
Component
,Composable
,ComponentSelector
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
hasComponent(java.lang.String key)
Check to see if aComponent
exists for a key.Component
lookup(java.lang.String key)
Get theComponent
associated with the given key.void
release(Component component)
Return theComponent
when you are finished with it.
-
-
-
Method Detail
-
lookup
Component lookup(java.lang.String key) throws ComponentException
Get theComponent
associated with the given key. For instance, If theComponentManager
had aLoggerComponent
stored and referenced by key, I would use the following call:try { LoggerComponent log; myComponent = (LoggerComponent) m_manager.lookup(LoggerComponent.ROLE); } catch (...) { ... }
- Parameters:
key
- The key name of theComponent
to retrieve.- Returns:
- the desired component
- Throws:
ComponentException
- if an error occurs
-
hasComponent
boolean hasComponent(java.lang.String key)
Check to see if aComponent
exists for a key.- Parameters:
key
- a string identifying the key to check.- Returns:
- True if the component exists, False if it does not.
-
release
void release(Component component)
Return theComponent
when you are finished with it. This allows theComponentManager
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.- Parameters:
component
- The Component we are releasing.
-
-