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 00db80c19f7fd3fc9399dd303df74f7987eb2ce7..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
@@ -9,7 +9,6 @@ package org.opendaylight.controller.sal.binding.api;
 
 import java.util.EventListener;
 import java.util.concurrent.ExecutorService;
-
 import org.opendaylight.controller.md.sal.common.api.notify.NotificationPublishService;
 import org.opendaylight.yangtools.concepts.ListenerRegistration;
 import org.opendaylight.yangtools.yang.binding.Notification;
@@ -18,18 +17,15 @@ import org.opendaylight.yangtools.yang.binding.Notification;
  * Interface for a notification service that provides publish/subscribe capabilities for YANG
  * modeled notifications. This interface is a combination of the {@link NotificationService} and
  * {@link NotificationPublishService} interfaces.
+ *
+ * @deprecated Please use {@link org.opendaylight.mdsal.binding.api.NotificationPublishService}.
  */
+@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);
 
@@ -37,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
@@ -54,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