X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-common-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fmd%2Fsal%2Fcommon%2Fapi%2Fdata%2FAsyncReadTransaction.java;h=3396b61f28412f20b041a51b32c182780c8dffc9;hb=21775f1de8552c3be584735ea179ce87e0929986;hp=6cf5a5b532d41725ce76f45299536de76c63ece2;hpb=00c362a353f1a7e6145f4c50811fa8b7a6c871d2;p=controller.git diff --git a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadTransaction.java b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadTransaction.java index 6cf5a5b532..3396b61f28 100644 --- a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadTransaction.java +++ b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadTransaction.java @@ -9,12 +9,8 @@ package org.opendaylight.controller.md.sal.common.api.data; import org.opendaylight.yangtools.concepts.Path; -import com.google.common.base.Optional; -import com.google.common.util.concurrent.ListenableFuture; - /** - * - * Provides a stateful read-only view of the data tree. + * Marker interface for stateful read view of the data tree. * *

* View of the data tree is a stable point-in-time snapshot of the current data tree state when @@ -25,8 +21,8 @@ import com.google.common.util.concurrent.ListenableFuture; * Implementation Note: This interface is not intended to be implemented * by users of MD-SAL, but only to be consumed by them. * - *

Transaction isolation example

Lest assume initial state of data tree - * for PATH is A. + *

Transaction isolation example

+ * Lets assume initial state of data tree for PATH is A. * *
  * txRead = broker.newReadOnlyTransaction();   // read Transaction is snapshot of data
@@ -47,9 +43,10 @@ import com.google.common.util.concurrent.ListenableFuture;
  * 

* Note: example contains blocking calls on future only to illustrate * that action happened after other asynchronous action. Use of blocking call - * {@link ListenableFuture#get()} is discouraged for most uses and you should - * use - * {@link com.google.common.util.concurrent.Futures#addCallback(ListenableFuture, com.google.common.util.concurrent.FutureCallback)} + * {@link com.google.common.util.concurrent.ListenableFuture#get()} is discouraged for most + * uses and you should use + * {@link com.google.common.util.concurrent.Futures#addCallback(com.google.common.util.concurrent.ListenableFuture, + * com.google.common.util.concurrent.FutureCallback, java.util.concurrent.Executor)} * or other functions from {@link com.google.common.util.concurrent.Futures} to * register more specific listeners. * @@ -61,27 +58,4 @@ import com.google.common.util.concurrent.ListenableFuture; */ public interface AsyncReadTransaction

, D> extends AsyncTransaction { - /** - * - * Reads data from provided logical data store located at the provided path. - *

- * If the target is a subtree, then the whole subtree is read (and will be - * accessible from the returned data object). - * - * @param store - * Logical data store from which read should occur. - * @param path - * Path which uniquely identifies subtree which client want to - * read - * @return Listenable Future which contains read result - *

- */ - ListenableFuture> read(LogicalDatastoreType store, P path); - }