Remove deprecated controller EOS APIs and impl

[controller.git] / opendaylight / md-sal / sal-common-api / src / main / java / org / opendaylight / controller / md / sal / common / api / data / AsyncDataChangeEvent.java

diff --git a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncDataChangeEvent.java b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncDataChangeEvent.java
index 29c9bae31f76e2b1a1269116c2b3438cfa572172..8d5e347b173f146eeffc9896475bb0c4a5255f83 100644 (file)
--- a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncDataChangeEvent.java
+++ b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncDataChangeEvent.java
@@ -9,26 +9,26 @@ package org.opendaylight.controller.md.sal.common.api.data;
 
 import java.util.Map;
 import java.util.Set;
-
 import org.opendaylight.yangtools.concepts.Immutable;
 import org.opendaylight.yangtools.concepts.Path;
 
 /**
- *
- * An event which contains a capture of changes in a data subtree
+ * An event which contains a capture of changes in a data subtree.
  *
  * <p>
  * Represents a notification indicating that some data at or under a particular
  * path has changed. The notification contains a capture of the changes in the data
  * subtree. This event is triggered by successful application of modifications
  * from a transaction on the global data tree. Use the
- * {@link AsyncDataBroker#registerDataChangeListener(LogicalDatastoreType, Path, AsyncDataChangeListener, AsyncDataBroker.DataChangeScope)}
+ * {@link AsyncDataBroker#registerDataChangeListener(LogicalDatastoreType, Path, AsyncDataChangeListener,
+ *     AsyncDataBroker.DataChangeScope)}
  * method to register a listener for data change events.
  *
  * <p>
  * A listener will only receive notifications for changes to data under the path
  * they register for. See
- * {@link AsyncDataBroker#registerDataChangeListener(LogicalDatastoreType, Path, AsyncDataChangeListener, AsyncDataBroker.DataChangeScope)}
+ * {@link AsyncDataBroker#registerDataChangeListener(LogicalDatastoreType, Path, AsyncDataChangeListener,
+ *     AsyncDataBroker.DataChangeScope)}
  * to learn more about registration scopes.
  *
  * <p>
@@ -50,7 +50,8 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
      * Returns a map of paths and newly created objects, which were introduced by
      * this change into conceptual data tree, if no new objects were introduced
      * this map will be empty.
-     *<p>
+     *
+     * <p>
      * This map contains all data tree nodes (and paths to them) which were created
      * and are in  the scope of listener registration. The data tree nodes
      * contain their whole subtree with their current state.
@@ -63,14 +64,17 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
      * Returns a map of paths and objects which were updated by this change in the
      * conceptual data tree if no existing objects were updated
      * this map will be empty.
-     *<p>
+     *
+     * <p>
      * This map contains all data tree nodes (and paths to them) which were updated
      * and are in the scope of listener registration. The data tree nodes
      * contain their whole subtree with their current state.
-     *<p>
+     *
+     * <p>
      * A Node is considered updated if it contents were replaced or one of its
      * children was created, removed or updated.
-     *<p>
+     *
+     * <p>
      * Original state of the updated data tree nodes is in
      * {@link #getOriginalData()} stored with same path.
      *
@@ -80,10 +84,12 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
 
     /**
      * Returns an immutable set of removed paths.
-     *<p>
+     *
+     * <p>
      * This set contains the paths to the data tree nodes which are in the scope
      * of the listener registration that have been removed.
-     *<p>
+     *
+     * <p>
      * Original state of the removed data tree nodes is in
      * {@link #getOriginalData()} stored with same path.
      *
@@ -101,7 +107,7 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
      *
      * @return map of paths and original state of updated and removed objects.
      */
-    Map<P, ? extends D> getOriginalData();
+    Map<P, D> getOriginalData();
 
     /**
      * Returns an immutable stable view of data state, which captures the state of
@@ -110,7 +116,8 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
      *<p>
      * The view is rooted at the point where the listener, to which the event is
      * being delivered, was registered.
-     *<p>
+     *
+     * <p>
      * If listener used a wildcarded path (if supported by path type) during
      * registration for change listeners this method returns null, and original
      * state can be accessed only via {@link #getOriginalData()}
@@ -124,10 +131,12 @@ public interface AsyncDataChangeEvent<P extends Path<P>, D> extends Immutable {
     /**
      * Returns an immutable stable view of data, which captures the state of data
      * store after the reported change.
-     *<p>
+     *
+     * <p>
      * The view is rooted at the point where the listener, to which the event is
      * being delivered, was registered.
-     *<p>
+     *
+     * <p>
      * If listener used a wildcarded path (if supported by path type) during
      * registration for change listeners this method returns null, and state
      * can be accessed only via {@link #getCreatedData()},