import java.util.Collection;
import java.util.EventListener;
-import javax.annotation.Nonnull;
+import org.eclipse.jdt.annotation.NonNull;
import org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidate;
/**
* Interface implemented by classes interested in receiving notifications about
- * data tree changes. This interface differs from {@link DOMDataChangeListener}
- * in that it provides a cursor-based view of the change, which has potentially
+ * data tree changes. This interface provides a cursor-based view of the change, which has potentially
* lower overhead.
+ *
+ * <p>
+ * Note: this interface enables notifications only at the leader of the data store, if clustered. If you want
+ * notifications on all instances in a cluster, use the {@link ClusteredDOMDataTreeChangeListener}.
*/
public interface DOMDataTreeChangeListener extends EventListener {
/**
* to recover from such events. Event producers are expected to exert reasonable
* effort to suppress such events.
*
+ * <p>
* In other words, it is completely acceptable to observe
* a {@link org.opendaylight.yangtools.yang.data.api.schema.tree.DataTreeCandidateNode},
* which reports a {@link org.opendaylight.yangtools.yang.data.api.schema.tree.ModificationType}
*
* @param changes Collection of change events, may not be null or empty.
*/
- void onDataTreeChanged(@Nonnull Collection<DataTreeCandidate> changes);
+ void onDataTreeChanged(@NonNull Collection<DataTreeCandidate> changes);
}