Mark DataTreeChangeListener for evolution

We should consider making convergence explicit, because people
routinely ignore this capability, which was retrofitted.

Change-Id: I361181b95a61c1beb8047b2497481a44e19fcd92
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

diff --git a/binding/mdsal-binding-api/src/main/java/org/opendaylight/mdsal/binding/api/DataTreeChangeListener.java b/binding/mdsal-binding-api/src/main/java/org/opendaylight/mdsal/binding/api/DataTreeChangeListener.java
index 95f9c03afd2e293b56303e0ad0a3c51d51ed3cf4..6a0a26568f12cb8dbf6a992c39c093b529fa3b0d 100644 (file)
--- a/binding/mdsal-binding-api/src/main/java/org/opendaylight/mdsal/binding/api/DataTreeChangeListener.java
+++ b/binding/mdsal-binding-api/src/main/java/org/opendaylight/mdsal/binding/api/DataTreeChangeListener.java
@@ -54,6 +54,7 @@ public interface DataTreeChangeListener<T extends DataObject> extends EventListe
      * Default implementation does nothing and is appropriate for users who do not care about ascertaining
      * initial state.
      */
+    // FIXME: 8.0.0: this method should be non-default
     default void onInitialData() {
         //no-op
     }

diff --git a/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeListener.java b/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeListener.java
index 0c0aeb23e6a07277d5bd67458978396142d7e526..a6991110d813bc862ab5954ce33ea3edbb0c44bc 100644 (file)
--- a/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeListener.java
+++ b/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeListener.java
@@ -49,6 +49,7 @@ public interface DOMDataTreeChangeListener extends EventListener {
      * Default implementation does nothing and is appropriate for users who do not care about ascertaining
      * initial stat.
      */
+    // FIXME: 8.0.0: this method should be non-default
     default void onInitialData() {
         //no-op
     }