org.opendaylight.mdsal.binding.javav2.dom.adapter.impl.transaction

Class BindingDOMTransactionChainAdapter

java.lang.Object

org.opendaylight.mdsal.binding.javav2.dom.adapter.impl.transaction.BindingDOMTransactionChainAdapter

All Implemented Interfaces:

AutoCloseable, BindingTransactionChain, TransactionFactory, AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>, TransactionChain<InstanceIdentifier<?>,TreeNode>, org.opendaylight.yangtools.concepts.Delegator<DOMTransactionChain>

@Beta
public final class BindingDOMTransactionChainAdapter
extends Object
implements BindingTransactionChain, org.opendaylight.yangtools.concepts.Delegator<DOMTransactionChain>

Transaction chain adapter.

Constructor Summary

Constructors

Constructor and Description
BindingDOMTransactionChainAdapter(DOMDataBroker chainFactory, BindingToNormalizedNodeCodec codec, TransactionChainListener listener)

Method Summary

Modifier and Type	Method and Description
void	close()
DOMTransactionChain	getDelegate()
ReadTransaction	newReadOnlyTransaction() Allocates a new read-only transaction which provides an immutable snapshot of the data tree.
AsyncReadWriteTransaction<InstanceIdentifier<?>,TreeNode>	newReadWriteTransaction() Allocates new read-write transaction which provides a mutable view of the data tree.
WriteTransaction	newWriteOnlyTransaction() Allocates new write-only transaction based on latest state of data tree.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BindingDOMTransactionChainAdapter

public BindingDOMTransactionChainAdapter(DOMDataBroker chainFactory,
                                         BindingToNormalizedNodeCodec codec,
                                         TransactionChainListener listener)

Method Detail

getDelegate

public DOMTransactionChain getDelegate()

Specified by:

getDelegate in interface org.opendaylight.yangtools.concepts.Delegator<DOMTransactionChain>

newReadOnlyTransaction

public ReadTransaction newReadOnlyTransaction()

Description copied from interface: AsyncDataTransactionFactory

Allocates a new read-only transaction which provides an immutable snapshot of the data tree.

The view of data tree is an immutable snapshot of current data tree state when transaction was allocated.

Specified by:

newReadOnlyTransaction in interface BindingTransactionChain

Specified by:

newReadOnlyTransaction in interface TransactionFactory

Specified by:

newReadOnlyTransaction in interface AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>

Specified by:

newReadOnlyTransaction in interface TransactionChain<InstanceIdentifier<?>,TreeNode>

Returns:

new read-only transaction

newWriteOnlyTransaction

public WriteTransaction newWriteOnlyTransaction()

Description copied from interface: AsyncDataTransactionFactory

Allocates new write-only transaction based on latest state of data tree.

Preconditions for mutation of data tree are captured from the snapshot of data tree state, when the transaction is allocated. If data was changed during transaction in an incompatible way then the commit of this transaction will fail. See AsyncWriteTransaction.submit() for more details about conflicting and not-conflicting changes and failure scenarios.

Since this transaction does not provide a view of the data it SHOULD BE used only by callers which are exclusive writers (exporters of data) to the subtree they modify. This prevents optimistic lock failures as described in AsyncWriteTransaction.submit().

Exclusivity of writers to particular subtree SHOULD BE enforced by external locking mechanism.

Specified by:

newWriteOnlyTransaction in interface BindingTransactionChain

Specified by:

newWriteOnlyTransaction in interface TransactionFactory

Specified by:

newWriteOnlyTransaction in interface AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>

Specified by:

newWriteOnlyTransaction in interface TransactionChain<InstanceIdentifier<?>,TreeNode>

Returns:

new write-only transaction

newReadWriteTransaction

public AsyncReadWriteTransaction<InstanceIdentifier<?>,TreeNode> newReadWriteTransaction()

Description copied from interface: AsyncDataTransactionFactory

Allocates new read-write transaction which provides a mutable view of the data tree.

Preconditions for mutation of data tree are captured from the snapshot of data tree state, when the transaction is allocated. If data was changed during transaction in an incompatible way then the commit of this transaction will fail. See AsyncWriteTransaction.submit() for more details about conflicting and not-conflicting changes and failure scenarios.

Specified by:

newReadWriteTransaction in interface AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>

Specified by:

newReadWriteTransaction in interface TransactionChain<InstanceIdentifier<?>,TreeNode>

Returns:

new read-write transaction

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface TransactionChain<InstanceIdentifier<?>,TreeNode>