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=1bb700a3909b31b7b86f5fe7a4e327300c9f2af2;hp=5876c50d51380a865afead594618627e7347bf3f;hb=aaea3e9a92ae9d6fac04c4a065db4b35cbca9ed0;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..1bb700a390 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 @@ -13,18 +13,21 @@ package org.opendaylight.controller.sal.core.spi.data; * as if they happened. A chain makes no guarantees of atomicity, in fact * transactions are committed as soon as possible. * - * + * @deprecated Use {@link org.opendaylight.mdsal.dom.spi.store.DOMStoreTransactionChain} instead. */ +@Deprecated(forRemoval = true) public interface DOMStoreTransactionChain extends DOMStoreTransactionFactory, AutoCloseable { /** * 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 +38,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 +60,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 +73,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(); }