(no commit message)
[utils] / system / general / src / main / java / org / wamblee / system / RequiredInterface.java
1 /*
2  * Copyright 2007 the original author or authors.
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  * 
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  * 
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */ 
16 package org.wamblee.system;
17
18 public interface RequiredInterface {
19
20         /**
21          * Name for the interface. 
22          */
23         public String getName(); 
24         
25         /**
26          * Checks if the service is provided by a given provided interface. 
27          * @param aInterface Provided interface. 
28          * @return
29          */
30         boolean implementedBy(ProvidedInterface aInterface);
31         
32         /**
33          * Sets the provider of this interface. 
34          * @param aProvider Provider. 
35          */
36         void setProvider(ProvidedInterface aProvider);
37         
38         /**
39          * Getst the provider interface. 
40          * @return Provider or null if not set. 
41          */
42         ProvidedInterface getProvider(); 
43         
44         /**
45          * Gets the implementation of the required interface. 
46          * @param <T>
47          * @param aClass Interface type. 
48          * @return Interface implementation or null if not known yet. 
49          */
50         <T> T getImplementation(Class<T> aClass); 
51 }