X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=controller.git;a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-common-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fmd%2Fsal%2Fcommon%2Fapi%2Fdata%2FAsyncReadWriteTransaction.java;h=4905e6bb1264d43314a42c87d54535201c512270;hp=16b4ed4fe2ed14d7cf7db8e5e88621df801d9f1c;hb=99f994b3e45963f6ef46bc2b71ab4dd8eea8b9ac;hpb=aa7b316a424f60fb1b5179e44924e9457147093a diff --git a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadWriteTransaction.java b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadWriteTransaction.java index 16b4ed4fe2..4905e6bb12 100644 --- a/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadWriteTransaction.java +++ b/opendaylight/md-sal/sal-common-api/src/main/java/org/opendaylight/controller/md/sal/common/api/data/AsyncReadWriteTransaction.java @@ -24,14 +24,14 @@ import org.opendaylight.yangtools.concepts.Path; * transactions. * *

- * Applications publish the changes proposed in the transaction by calling {@link #commit} + * Applications publish the changes proposed in the transaction by calling {@link #submit} * on the transaction. This seals the transaction * (preventing any further writes using this transaction) and submits it to be * processed and applied to global conceptual data tree. * *

* The transaction commit may fail due to a concurrent transaction modifying and committing data in - * an incompatible way. See {@link #commit()} for more concrete commit failure examples. + * an incompatible way. See {@link #submit()} for more concrete commit failure examples. * * Implementation Note: This interface is not intended to be implemented * by users of MD-SAL, but only to be consumed by them. @@ -40,6 +40,7 @@ import org.opendaylight.yangtools.concepts.Path; * *

Transaction local state

* + *

* Let assume initial state of data tree for PATH is A * . * @@ -56,6 +57,7 @@ import org.opendaylight.yangtools.concepts.Path; * tx1afterCommit.read(OPERATIONAL,PATH).get(); // returns Optional containing B * * + *

* As you could see read-write transaction provides capabilities as * {@link AsyncWriteTransaction} but also allows for reading proposed changes as * if they already happened. @@ -119,8 +121,8 @@ import org.opendaylight.yangtools.concepts.Path; * Note: examples contains blocking calls on future only to illustrate * that action happened after other asynchronous action. Use of blocking call * {@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)} + * use {@link com.google.common.util.concurrent.Futures#addCallback(com.google.common.util.concurrent.ListenableFuture, + * com.google.common.util.concurrent.FutureCallback)} * or other functions from {@link com.google.common.util.concurrent.Futures} to * register more specific listeners. *