@Beta public interface DataBroker extends AsyncDataBroker<InstanceIdentifier<?>,TreeNode>, BindingService, TransactionFactory, DataTreeService, TransactionChainFactory<InstanceIdentifier<?>,TreeNode>
For more information on usage, please see the documentation in AsyncDataBroker.
AsyncDataBroker,
TransactionChainFactory| Modifier and Type | Method and Description |
|---|---|
BindingTransactionChain |
createTransactionChain(TransactionChainListener listener)
Create a new transaction chain.
|
ReadTransaction |
newReadOnlyTransaction()
Allocates a new read-only transaction which provides an immutable snapshot of
the data tree.
|
WriteTransaction |
newWriteOnlyTransaction()
Allocates new write-only transaction based on latest state of data tree.
|
newReadWriteTransactionregisterListenercreateProducerReadTransaction newReadOnlyTransaction()
AsyncDataTransactionFactoryThe view of data tree is an immutable snapshot of current data tree state when transaction was allocated.
newReadOnlyTransaction in interface AsyncDataBroker<InstanceIdentifier<?>,TreeNode>newReadOnlyTransaction in interface AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>newReadOnlyTransaction in interface TransactionFactoryWriteTransaction newWriteOnlyTransaction()
AsyncDataTransactionFactory
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.
newWriteOnlyTransaction in interface AsyncDataBroker<InstanceIdentifier<?>,TreeNode>newWriteOnlyTransaction in interface AsyncDataTransactionFactory<InstanceIdentifier<?>,TreeNode>newWriteOnlyTransaction in interface TransactionFactoryBindingTransactionChain createTransactionChain(TransactionChainListener listener)
TransactionChainFactorycreateTransactionChain in interface TransactionChainFactory<InstanceIdentifier<?>,TreeNode>listener - Transaction chain event listenerCopyright © 2019 OpenDaylight. All rights reserved.