From: Ryan Goulding
Date: Thu, 31 Mar 2016 15:02:31 +0000 (-0400)
Subject: Deprecate DCL in favor of DTCL
X-Git-Tag: release/boron~249
X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=commitdiff_plain;ds=inline;h=11e16facd8ba32e307d634b6da13160d57597cce;p=controller.git
Deprecate DCL in favor of DTCL
The DataTreeChangeListener abstraction offers many performance and semantic
advantages over DataChangeListener. Although there is no concrete date for DCL
removal, @Deprecated annotations are added to DCL API and impl classes to
dissuade their use. An example of how to transition from DCL to DTCL is
included in this patch:
https://git.opendaylight.org/gerrit/#/c/35209/
Change-Id: Ie6d287224f572f157d41bf56c04b02e60ea8bf2a
Signed-off-by: Ryan Goulding
---
diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/ClusteredDataChangeListener.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/ClusteredDataChangeListener.java
index 511910de62..d9f0e08551 100644
--- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/ClusteredDataChangeListener.java
+++ b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/ClusteredDataChangeListener.java
@@ -19,7 +19,8 @@ package org.opendaylight.controller.md.sal.binding.api;
* to data change notifications on any node of clustered datastore. DataChangeListener enables data change notifications
* only at leader of the datastore shard.
*
+ * @Deprecated Replaced by {@link ClusteredDataTreeChangeListener}
*/
-
+@Deprecated
public interface ClusteredDataChangeListener extends DataChangeListener{
}
diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/DataChangeListener.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/DataChangeListener.java
index 2833f41f67..f6a13a3a79 100644
--- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/DataChangeListener.java
+++ b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/md/sal/binding/api/DataChangeListener.java
@@ -14,8 +14,10 @@ import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
/*
* DataChangeListener enables data change notifications only at leader of the datastore shard
+ *
+ * @Deprecated Replaced by {@link DataTreeChangeListener}
*/
-
+@Deprecated
public interface DataChangeListener extends AsyncDataChangeListener, DataObject> {
@Override
void onDataChanged(AsyncDataChangeEvent, DataObject> change);
diff --git a/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/DataChangeListener.java b/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/DataChangeListener.java
index 1bc835f1e3..cf3bdce331 100644
--- a/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/DataChangeListener.java
+++ b/opendaylight/md-sal/sal-distributed-datastore/src/main/java/org/opendaylight/controller/cluster/datastore/DataChangeListener.java
@@ -22,6 +22,10 @@ import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+/**
+ * @Deprecated Replaced by {@link DataTreeChangeListener}
+ */
+@Deprecated
public class DataChangeListener extends AbstractUntypedActor {
private static final Logger LOG = LoggerFactory.getLogger(DataChangeListener.class);