X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=system%2Fgeneral%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsystem%2Fcore%2FProvidedInterface.java;h=46bf5f24528d143b9c1b488b32c56456f55d0631;hb=32a8562695029cf13d915bc7941a61fe07ff0005;hp=349197d0f2b8a450ee39ea5e21a6c4dfc10f2ffa;hpb=4845c677310814de4c98e22aad483e49b9dfc594;p=utils 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 349197d0..46bf5f24 100644 --- 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); }