X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=dom%2Fmdsal-dom-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fmdsal%2Fdom%2Fapi%2FDOMDataTreeChangeService.java;h=8585feae4e9e06440bf523e53449f6ddfb1f3b6f;hb=94d4f50d34d5b7c690d7fa92b33e7db7965f455c;hp=c43994156a310f990628293ef8c753586d08bdba;hpb=c91e0b5a57846dd86c2f979fa4d9f7825b03f639;p=mdsal.git diff --git a/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeService.java b/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeService.java index c43994156a..8585feae4e 100644 --- a/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeService.java +++ b/dom/mdsal-dom-api/src/main/java/org/opendaylight/mdsal/dom/api/DOMDataTreeChangeService.java @@ -7,12 +7,13 @@ */ package org.opendaylight.mdsal.dom.api; -import org.eclipse.jdt.annotation.NonNull; -import org.opendaylight.yangtools.concepts.ListenerRegistration; +import org.eclipse.jdt.annotation.NonNullByDefault; +import org.opendaylight.yangtools.concepts.Registration; /** * A {@link DOMDataBroker.Extension} which allows users to register for changes to a subtree. */ +@NonNullByDefault public interface DOMDataTreeChangeService extends DOMDataBroker.Extension { /** * Registers a {@link DOMDataTreeChangeListener} to receive notifications when data changes under a given path in @@ -31,8 +32,8 @@ public interface DOMDataTreeChangeService extends DOMDataBroker.Extension { * an initial data change event, which will contain all pre-existing data, marked as created. * *

- * This method returns a {@link ListenerRegistration} object. To "unregister" your listener for changes call - * the {@link ListenerRegistration#close()} method on the returned object. + * This method returns a {@link Registration} object. To "unregister" your listener for changes call + * the {@link Registration#close()} method on the returned object. * *

* You MUST explicitly unregister your listener when you no longer want to receive notifications. This is especially @@ -41,12 +42,9 @@ public interface DOMDataTreeChangeService extends DOMDataBroker.Extension { * * @param treeId Data tree identifier of the subtree which should be watched for changes. * @param listener Listener instance which is being registered - * @param Listener type - * @return Listener registration object, which may be used to unregister your listener using - * {@link ListenerRegistration#close()} to stop delivery of change events. - * @throws NullPointerException if any of the arguments is null + * @return A {@link Registration} object, which may be used to unregister your listener using + * {@link Registration#close()} to stop delivery of change events. + * @throws NullPointerException if any of the arguments is {@code null} */ - // FIXME: just Registration - @NonNull ListenerRegistration registerDataTreeChangeListener( - @NonNull DOMDataTreeIdentifier treeId, @NonNull L listener); + Registration registerDataTreeChangeListener(DOMDataTreeIdentifier treeId, DOMDataTreeChangeListener listener); }