Cleanup imports/whitespace in MD-SAL

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

diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationService.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationService.java
index 3723c70e8c371115e44b1bf5f0bbeaa9e7da225a..24ca2a3de7e13073b0e61e2be930ebabf04d9436 100644 (file)
--- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationService.java
+++ b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/NotificationService.java
@@ -7,11 +7,62 @@
  */
 package org.opendaylight.controller.sal.binding.api;
 
+import org.opendaylight.yangtools.concepts.Registration;
 import org.opendaylight.yangtools.yang.binding.Notification;
 
 public interface NotificationService extends BindingAwareService {
-
+    /**
+     *
+     * Deprecated: use {@link #addNotificationListener(Class, NotificationListener)} istead.
+     *
+     * @param listener
+     */
+    @Deprecated
     <T extends Notification> void addNotificationListener(Class<T> notificationType, NotificationListener<T> listener);
 
+    /**
+     *
+     * Deprecated: use {@link #addNotificationListener(org.opendaylight.yangtools.yang.binding.NotificationListener)} istead.
+     *
+     * @param listener
+     */
+    @Deprecated
+    void addNotificationListener(org.opendaylight.yangtools.yang.binding.NotificationListener listener);
+
+    /**
+     * Deprecated: use {@link Registration#close()} istead.
+     * @param listener
+     */
+    @Deprecated
+    void removeNotificationListener(org.opendaylight.yangtools.yang.binding.NotificationListener listener);
+
+    /**
+     * Deprecated: use {@link Registration#close()} istead.
+     * @param listener
+     */
+    @Deprecated
     <T extends Notification> void removeNotificationListener(Class<T> notificationType, NotificationListener<T> listener);
+
+
+    /**
+     * Register a generic listener for specified notification type only.
+     *
+     * @param notificationType
+     * @param listener
+     * @return Registration for listener. To unregister listener invoke {@link Registration#close()} method.
+     */
+    <T extends Notification> Registration<NotificationListener<T>> registerNotificationListener(
+            Class<T> notificationType, NotificationListener<T> listener);
+
+
+    /**
+     * Register a listener which implements generated notification interfaces derived from
+     * {@link org.opendaylight.yangtools.yang.binding.NotificationListener}.
+     * Listener is registered for all notifications present in implemented interfaces.
+     *
+     * @param listener
+     * @return Registration for listener. To unregister listener invoke {@link Registration#close()} method.
+     */
+    Registration<org.opendaylight.yangtools.yang.binding.NotificationListener> registerNotificationListener(
+            org.opendaylight.yangtools.yang.binding.NotificationListener listener);
 }