/**
* 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);
}