(no commit message)

[utils] / system / general / src / main / java / org / wamblee / system / core / ProvidedInterface.java

diff --git a/system/general/src/main/java/org/wamblee/system/core/ProvidedInterface.java b/system/general/src/main/java/org/wamblee/system/core/ProvidedInterface.java
index 349197d0f2b8a450ee39ea5e21a6c4dfc10f2ffa..46bf5f24528d143b9c1b488b32c56456f55d0631 100644 (file)
--- a/system/general/src/main/java/org/wamblee/system/core/ProvidedInterface.java
+++ b/system/general/src/main/java/org/wamblee/system/core/ProvidedInterface.java
@@ -19,32 +19,33 @@ import java.util.Collection;
 
 /**
  * Represents an interface provided by a component.
+ * Different component objects should never share ProvidedInterface instances!
  *  
  * @author Erik Brakkee
  */
-public interface ProvidedInterface {
-    
-       /**
-        * Symbolic name for the service as used by the subsystem.  
-        * @return Service name. 
-        */
-       String getName();
+public interface ProvidedInterface extends NamedInterface {
        
        /**
         * Returns the service type. 
         * @return Service type. 
         */
        Class[] getInterfaceTypes();
-       
+
        /**
-        * Publish an implementation of the interface. 
-        * @param aImplementation
+        * Publishes an implementation of the interface. The implementation must 
+        * call {@link Scope#publishInterface(ProvidedInterface, Object)} to publish the
+        * interface implementation in a given scope.  
+        * @param aImplementation Implementation to publish. 
+        * @param aScope Scope in which to publish the implementation. 
         */
-       void publish(Object aImplementation); 
+       void publish(Object aImplementation, Scope aScope);
+       
        
        /**
-        * Gets the implementation. 
-        * @return Implementation or null if not started. 
+        * Determines whether the current provided interface exceeds the given provided interface. 
+        * In other words if it can provide at least what the given provided interface can provide. 
+        * @param aInterface Interface to compare to. 
+        * @return True if the current interface exceeds the given provided interface. 
         */
-       Object getImplementation(); 
+       boolean covers(ProvidedInterface aInterface); 
 }