01: /**
02: * EasyBeans
03: * Copyright (C) 2007 Bull S.A.S.
04: * Contact: easybeans@ow2.org
05: *
06: * This library is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation; either
09: * version 2.1 of the License, or any later version.
10: *
11: * This library is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: *
16: * You should have received a copy of the GNU Lesser General Public
17: * License along with this library; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19: * USA
20: *
21: * --------------------------------------------------------------------------
22: * $Id: EZBComponentRegistry.java 1970 2007-10-16 11:49:25Z benoitf $
23: * --------------------------------------------------------------------------
24: */package org.ow2.easybeans.api.components;
25:
26: import java.util.List;
27:
28: import org.ow2.easybeans.component.api.EZBComponent;
29: import org.ow2.easybeans.component.api.EZBComponentException;
30:
31: /**
32: * This interface is the registry of the EasyBeans Components.
33: * @author Florent Benoit
34: */
35: public interface EZBComponentRegistry {
36:
37: /**
38: * Allow to get a reference on another component.
39: * @param componentName the name of the component
40: * @return the component.
41: */
42: EZBComponent getComponent(final String componentName);
43:
44: /**
45: * @param component EZBComponent instance.
46: * @return Returns the component name from the EZBComponent instance.
47: */
48: String getComponentName(final EZBComponent component);
49:
50: /**
51: * Get the components that implements the given interface.
52: * @param itf the given interface
53: * @return an array of components implementing the given interface
54: * @param <T> an interface extending EZBComponent.
55: */
56: <T extends EZBComponent> List<T> getComponents(final Class<T> itf);
57:
58: /**
59: * Register a component.
60: * @param componentName the name of the component to register
61: * @param component the component to register.
62: * @throws EZBComponentException if registering fails.
63: */
64: void register(final String componentName,
65: final EZBComponent component) throws EZBComponentException;
66:
67: /**
68: * Unregister a component.
69: * @param componentName the component name to unregister.
70: * @throws EZBComponentException if unregistering fails.
71: */
72: void unregister(final String componentName)
73: throws EZBComponentException;
74:
75: /**
76: * Unregister a component.
77: * @param component the instance of the component to unregister.
78: * @throws EZBComponentException if unregistering fails.
79: */
80: void unregister(final EZBComponent component)
81: throws EZBComponentException;
82: }
|