X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-dom-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fmd%2Fsal%2Fdom%2Fapi%2FDOMRpcService.java;h=c84e2d3ad0a6216d1def8b687f5e003f8effe031;hb=refs%2Fchanges%2F34%2F51034%2F4;hp=e0c95a197bfc08709a79a97ff05cf276834e7e3d;hpb=a81d98f692b80c45bce3fe6a87e731abfb012a9f;p=controller.git diff --git a/opendaylight/md-sal/sal-dom-api/src/main/java/org/opendaylight/controller/md/sal/dom/api/DOMRpcService.java b/opendaylight/md-sal/sal-dom-api/src/main/java/org/opendaylight/controller/md/sal/dom/api/DOMRpcService.java index e0c95a197b..c84e2d3ad0 100644 --- a/opendaylight/md-sal/sal-dom-api/src/main/java/org/opendaylight/controller/md/sal/dom/api/DOMRpcService.java +++ b/opendaylight/md-sal/sal-dom-api/src/main/java/org/opendaylight/controller/md/sal/dom/api/DOMRpcService.java @@ -31,17 +31,22 @@ public interface DOMRpcService extends DOMService { * or report a subclass of {@link DOMRpcException} reporting a transport * error. */ - @Nonnull CheckedFuture invokeRpc(@Nonnull SchemaPath type, @Nullable NormalizedNode input); + @Nonnull CheckedFuture invokeRpc(@Nonnull SchemaPath type, + @Nullable NormalizedNode input); /** * Register a {@link DOMRpcAvailabilityListener} with this service to receive notifications * about RPC implementations becoming (un)available. The listener will be invoked with the * current implementations reported and will be kept uptodate as implementations come and go. * - * Users should note that using a listener does not necessarily mean that {@link #invokeRpc(SchemaPath, NormalizedNode)} - * will not report a failure due to {@link DOMRpcImplementationNotAvailableException} and - * need to be ready to handle it. Implementations are encouraged to take reasonable precautions - * to prevent this scenario from occurring. + *

+ * Users should note that using a listener does not necessarily mean that + * {@link #invokeRpc(SchemaPath, NormalizedNode)} will not report a failure due to + * {@link DOMRpcImplementationNotAvailableException} and need to be ready to handle it. + * + *

+ * Implementations of this interface are encouraged to take reasonable precautions to prevent this scenario from + * occurring. * * @param listener {@link DOMRpcAvailabilityListener} instance to register * @return A {@link ListenerRegistration} representing this registration. Performing