X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=controller.git;a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-binding-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fsal%2Fbinding%2Fapi%2FNotificationService.java;h=015988e3d951327a519a4474afc5bfe7be48ebfa;hp=dd66aa67f8a78451e9c31b851987455678306ea7;hb=a81d98f692b80c45bce3fe6a87e731abfb012a9f;hpb=9c34ce103df5efac991297dc25a64c9b8d6019f3 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 dd66aa67f8..015988e3d9 100644 --- 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 @@ -20,6 +20,7 @@ import org.opendaylight.yangtools.yang.binding.Notification; *
  • Dispatch listener - listener, which implements {ModelName}Listener interface, * which has dispatch methods for each defined notification. Methods are invoked based on notification type (class). *
  • + * * *

    Generic Listener

    *

    @@ -47,11 +48,11 @@ import org.opendaylight.yangtools.yang.binding.Notification; * are registered using {@link #registerNotificationListener(org.opendaylight.yangtools.yang.binding.NotificationListener)} * method. * - *

    Dispatch Listener Example
    + *

    Dispatch Listener Example

    *

    * Lets assume we have following YANG model: * - *

    + * {@code
      * module example {
      *      ...
      *
    @@ -63,17 +64,17 @@ import org.opendaylight.yangtools.yang.binding.Notification;
      *           ...
      *      }
      * }
    - * 
    + * } * * The generated interface will be: - *
    + * {@code
      *  public interface ExampleListener extends NotificationListener {
      *      void onStart(Start notification);
      *      void onStop(Stop notification);
      *  }
    - * 
    + * } * The following defines an implementation of the generated interface: - *
    + * {@code
      *  public class MyExampleListener implements ExampleListener {
      *      public void onStart(Start notification) {
      *          // do something
    @@ -83,12 +84,12 @@ import org.opendaylight.yangtools.yang.binding.Notification;
      *          // do something
      *      }
      *  }
    - * 
    + * } * The implementation is registered as follows: - *
    + * {@code
      *  MyExampleListener listener = new MyExampleListener();
      *  ListenerRegistration reg = service.registerNotificationListener( listener );
    - * 
    + * } * The onStart method will be invoked when someone publishes a Start notification and * the onStop method will be invoked when someone publishes a Stop notification. *