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=5babd8c78f70b08100ecc49178bede267c5b657e;hp=16b4ed4fe2ed14d7cf7db8e5e88621df801d9f1c;hb=aaea3e9a92ae9d6fac04c4a065db4b35cbca9ed0;hpb=bd165724c2279b280cb6ff20543f899f68e551c7 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..5babd8c78f 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; * *
* 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, java.util.concurrent.Executor)}
* or other functions from {@link com.google.common.util.concurrent.Futures} to
* register more specific listeners.
*
@@ -133,6 +135,7 @@ import org.opendaylight.yangtools.concepts.Path;
* @param , D> extends AsyncReadTransaction ,
AsyncWriteTransaction {