Removed DOCUMENT ME comments that were generated and applied source code
[utils] / system / general / src / main / java / org / wamblee / system / core / ProvidedInterface.java
index f717535cf71f0369f9a3595ffa1c3d962422d998..1b6b921d89580329b2afb829fac11b7f5898e026 100644 (file)
@@ -1,57 +1,46 @@
 /*
  * Copyright 2007 the original author or authors.
- * 
+ *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ 
+ */
 package org.wamblee.system.core;
 
 import java.util.Collection;
 
 /**
- * Represents an interface provided by a component.
- * Different component objects should never share ProvidedInterface instances!
- *  
+ * 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();
-       
-       /**
-        * Returns the service type. 
-        * @return Service type. 
-        */
-       Class[] getInterfaceTypes();
+public interface ProvidedInterface extends NamedInterface {
+    /**
+     * Returns the service type.
+     * 
+     * @return Service type.
+     */
+    Class[] getInterfaceTypes();
 
-       /**
-        * 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, Scope aScope);
-       
-       
-       /**
-        * 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. 
-        */
-       boolean covers(ProvidedInterface aInterface); 
+    /**
+     * 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.
+     */
+    boolean covers(ProvidedInterface aInterface);
 }