View Javadoc
1   package org.codehaus.plexus;
2   
3   /*
4    * Copyright 2001-2006 Codehaus Foundation.
5    *
6    * Licensed under the Apache License, Version 2.0 (the "License");
7    * you may not use this file except in compliance with the License.
8    * You may obtain a copy of the License at
9    *
10   *      http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  
19  import java.util.List;
20  import java.util.Map;
21  
22  import org.codehaus.plexus.classworlds.realm.ClassRealm;
23  import org.codehaus.plexus.component.composition.CycleDetectedInComponentGraphException;
24  import org.codehaus.plexus.component.manager.ComponentManagerFactory;
25  import org.codehaus.plexus.component.repository.ComponentDescriptor;
26  import org.codehaus.plexus.component.repository.exception.ComponentLifecycleException;
27  import org.codehaus.plexus.component.repository.exception.ComponentLookupException;
28  
29  /**
30   * @author Jason van Zyl
31   * @author Kenney Westerhof
32   * @author Dain Sundstrom
33   */
34  public interface ComponentRegistry
35  {
36      void registerComponentManagerFactory( ComponentManagerFactory componentManagerFactory );
37  
38      void addComponentDescriptor( ComponentDescriptor<?> componentDescriptor )
39          throws CycleDetectedInComponentGraphException;
40  
41      <T> ComponentDescriptor<T> getComponentDescriptor( Class<T> type, String role, String roleHint );
42  
43      @Deprecated
44      ComponentDescriptor<?> getComponentDescriptor( String role, String roleHint, ClassRealm realm );
45  
46      <T> List<ComponentDescriptor<T>> getComponentDescriptorList( Class<T> type, String role );
47  
48      <T> Map<String, ComponentDescriptor<T>> getComponentDescriptorMap( Class<T> type, String role );
49  
50      <T> T lookup( Class<T> type, String role, String roleHint )
51          throws ComponentLookupException;
52  
53      <T> T lookup( ComponentDescriptor<T> componentDescriptor )
54          throws ComponentLookupException;
55  
56      <T> List<T> lookupList( Class<T> type, String role, List<String> hints )
57          throws ComponentLookupException;
58  
59      <T> Map<String, T> lookupMap( Class<T> type, String role, List<String> hints )
60          throws ComponentLookupException;
61  
62      void release( Object component ) throws ComponentLifecycleException;
63  
64      void removeComponentRealm( ClassRealm classRealm ) throws PlexusContainerException;
65  
66      void dispose();
67  
68      <T> void addComponent( T component, String role, String roleHint );
69  }