Migrate OSGI compendium reference

[controller.git] / opendaylight / md-sal / sal-binding-api / src / main / java / org / opendaylight / controller / sal / binding / api / NotificationProviderService.java

diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationProviderService.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationProviderService.java
index 4b06e77c44b7c7b3ff061623d4e16003f17fb8f2..ac2bb6477696cd25083edecf7ff2a74de0b381ab 100644 (file)
--- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationProviderService.java
+++ b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationProviderService.java
@@ -18,20 +18,14 @@ import org.opendaylight.yangtools.yang.binding.Notification;
  * modeled notifications. This interface is a combination of the {@link NotificationService} and
  * {@link NotificationPublishService} interfaces.
  *
- * @deprecated Please use {@link org.opendaylight.controller.md.sal.binding.api.NotificationPublishService}.
+ * @deprecated Please use {@link org.opendaylight.mdsal.binding.api.NotificationPublishService}.
  */
-@Deprecated
+@Deprecated(forRemoval = true)
 public interface NotificationProviderService extends NotificationService, NotificationPublishService<Notification> {
 
-    /**
-     * {@inheritDoc}
-     */
     @Override
-    public void publish(Notification notification);
+    void publish(Notification notification);
 
-    /**
-     * {@inheritDoc}
-     */
     @Override
     void publish(Notification notification, ExecutorService executor);
 
@@ -39,6 +33,7 @@ public interface NotificationProviderService extends NotificationService, Notifi
      * Registers a listener to be notified about notification subscriptions. This
      * enables a component to know when there is a notification listener subscribed
      * for a particular notification type.
+     *
      * <p>
      * On registration of this listener, the
      * {@link NotificationInterestListener#onNotificationSubscribtion(Class)} method
@@ -56,15 +51,16 @@ public interface NotificationProviderService extends NotificationService, Notifi
     /**
      * Interface for a listener interested in being notified about notification subscriptions.
      */
-    public interface NotificationInterestListener extends EventListener {
+    interface NotificationInterestListener extends EventListener {
 
         /**
-         * Callback that is invoked when a notification listener subscribes for a
-         * particular notification type.
+         * Callback that is invoked when a notification listener subscribes for a particular notification type.
+         *
          * <p>
          * This method is only called for the first subscription that occurs for a
          * particular notification type. Subsequent subscriptions for the same
          * notification type do not trigger invocation of this method.
+         *
          * <p>
          * <b>Note:</b>This callback is delivered from thread not owned by this listener,
          * all processing should be as fast as possible and implementations should