X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=controller.git;a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-dom-spi%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fsal%2Fcore%2Fspi%2Fdata%2FDOMStoreTransactionChain.java;h=dfffd3ef401e2de1b3cd42eca99ffe4de9732345;hp=5876c50d51380a865afead594618627e7347bf3f;hb=356ac60051791b56cd28390356906810c0db6024;hpb=2e87ec417c4c268fc1ad5f66dd0a5c2b9224e6fc diff --git a/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/DOMStoreTransactionChain.java b/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/DOMStoreTransactionChain.java index 5876c50d51..dfffd3ef40 100644 --- a/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/DOMStoreTransactionChain.java +++ b/opendaylight/md-sal/sal-dom-spi/src/main/java/org/opendaylight/controller/sal/core/spi/data/DOMStoreTransactionChain.java @@ -12,8 +12,6 @@ package org.opendaylight.controller.sal.core.spi.data; * sequence and each transaction must see the effects of previous transactions * as if they happened. A chain makes no guarantees of atomicity, in fact * transactions are committed as soon as possible. - * - * */ public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, AutoCloseable { @@ -21,10 +19,12 @@ public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, Au * Create a new read only transaction which will continue the chain. The * previous write transaction has to be either READY or CANCELLED. * + *

* If previous write transaction was already commited to data store, new * read-only transaction is same as obtained via {@link DOMStore#newReadOnlyTransaction()} * and contains merged result of previous one and current state of data store. * + *

* Otherwise read-only transaction presents isolated view as if previous read-write * transaction was successful. State which was introduced by other transactions * outside this transaction chain after creation of previous transaction is not visible. @@ -35,16 +35,18 @@ public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, Au * if the chain has been closed. */ @Override - public DOMStoreReadTransaction newReadOnlyTransaction(); + DOMStoreReadTransaction newReadOnlyTransaction(); /** * Create a new read write transaction which will continue the chain. The * previous read-write transaction has to be either COMMITED or CANCELLED. * + *

* If previous write transaction was already commited to data store, new * read-write transaction is same as obtained via {@link DOMStore#newReadWriteTransaction()} * and contains merged result of previous one and current state of data store. * + *

* Otherwise read-write transaction presents isolated view as if previous read-write * transaction was successful. State which was introduced by other transactions * outside this transaction chain after creation of previous transaction is not visible. @@ -55,10 +57,10 @@ public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, Au * if the chain has been closed. */ @Override - public DOMStoreReadWriteTransaction newReadWriteTransaction(); + DOMStoreReadWriteTransaction newReadWriteTransaction(); /** - * Create a new read write transaction which will continue the chain. The + * Create a new write-only transaction which will continue the chain. The * previous read-write transaction has to be either READY or CANCELLED. * * @@ -68,18 +70,17 @@ public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, Au * if the chain has been closed. */ @Override - public DOMStoreWriteTransaction newWriteOnlyTransaction(); - + DOMStoreWriteTransaction newWriteOnlyTransaction(); /** * Closes Transaction Chain. * + *

* Close method of transaction chain does not guarantee that * last alocated transaction is ready or was submitted. * * @throws IllegalStateException If any of the outstanding created transactions was not canceled or ready. */ @Override - public void close(); - + void close(); }