org.opendaylight.controller.md.sal.binding.api

Class ForwardingWriteTransaction

java.lang.Object

com.google.common.collect.ForwardingObject

org.opendaylight.controller.md.sal.binding.api.ForwardingWriteTransaction

All Implemented Interfaces:

WriteTransaction, AsyncTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, org.opendaylight.yangtools.concepts.Identifiable<Object>

public class ForwardingWriteTransaction
extends com.google.common.collect.ForwardingObject
implements WriteTransaction

Utility WriteTransaction implementation which forwards all interface method invocation to a delegate instance.

Field Summary

Fields inherited from interface org.opendaylight.controller.md.sal.binding.api.WriteTransaction

CREATE_MISSING_PARENTS, FAIL_ON_MISSING_PARENTS

Fields inherited from interface org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction

SUBMIT_EXCEPTION_MAPPER

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForwardingWriteTransaction(WriteTransaction delegate)

Method Summary

Modifier and Type	Method and Description
boolean	cancel() Cancels the transaction.
com.google.common.util.concurrent.FluentFuture<? extends org.opendaylight.mdsal.common.api.CommitInfo>	commit() Submits this transaction to be asynchronously applied to update the logical data tree.
protected WriteTransaction	delegate()
void	delete(LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path) Removes a piece of data from specified path.
Object	getIdentifier()
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	merge(LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data) Merges a piece of data with the existing data at a specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	merge(LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data, boolean createMissingParents) Merges a piece of data with the existing data at a specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	put(LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data) Stores a piece of data at the specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	put(LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data, boolean createMissingParents) Stores a piece of data at the specified path.

Methods inherited from class com.google.common.collect.ForwardingObject

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction

submit

Constructor Detail

ForwardingWriteTransaction

protected ForwardingWriteTransaction(WriteTransaction delegate)

Method Detail

delegate

protected WriteTransaction delegate()

Specified by:

delegate in class com.google.common.collect.ForwardingObject

put

public <T extends org.opendaylight.yangtools.yang.binding.DataObject> void put(LogicalDatastoreType store,
                                                                               org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                               T data)

Description copied from interface: WriteTransaction

Stores a piece of data at the specified path. This acts as an add / replace operation, which is to say that whole subtree will be replaced by the specified data. *

This method does not automatically create missing parent nodes. It is equivalent to invoking WriteTransaction.put(LogicalDatastoreType, InstanceIdentifier, DataObject, boolean) with createMissingParents set to false.

For more information on usage and examples, please see the documentation in AsyncWriteTransaction.

If you need to make sure that a parent object exists but you do not want modify its pre-existing state by using put, consider using WriteTransaction.merge(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T>, T) instead.

Specified by:

put in interface WriteTransaction

Parameters:

store - the logical data store which should be modified

path - the data object path

data - the data object to be written to the specified path

put

public <T extends org.opendaylight.yangtools.yang.binding.DataObject> void put(LogicalDatastoreType store,
                                                                               org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                               T data,
                                                                               boolean createMissingParents)

Description copied from interface: WriteTransaction

Stores a piece of data at the specified path. This acts as an add / replace operation, which is to say that whole subtree will be replaced by the specified data.

For more information on usage and examples, please see the documentation in AsyncWriteTransaction.

If you need to make sure that a parent object exists but you do not want modify its pre-existing state by using put, consider using WriteTransaction.merge(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T>, T) instead. Note: Using createMissingParents with value true, may introduce garbage in data store, or recreate nodes, which were deleted by previous transaction.

Specified by:

put in interface WriteTransaction

Parameters:

store - the logical data store which should be modified

path - the data object path

data - the data object to be written to the specified path

createMissingParents - if WriteTransaction.CREATE_MISSING_PARENTS (true), any missing parent nodes will be automatically created using a merge operation.

merge

public <T extends org.opendaylight.yangtools.yang.binding.DataObject> void merge(LogicalDatastoreType store,
                                                                                 org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                                 T data)

Description copied from interface: WriteTransaction

Merges a piece of data with the existing data at a specified path. Any pre-existing data which is not explicitly overwritten will be preserved. This means that if you store a container, its child lists will be merged.

This method does not automatically create missing parent nodes. It is equivalent to invoking WriteTransaction.merge(LogicalDatastoreType, InstanceIdentifier, DataObject, boolean) with createMissingParents set to false.

For more information on usage and examples, please see the documentation in AsyncWriteTransaction.

If you require an explicit replace operation, use WriteTransaction.put(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T>, T) instead.

Specified by:

merge in interface WriteTransaction

Parameters:

store - the logical data store which should be modified

path - the data object path

data - the data object to be merged to the specified path

merge

public <T extends org.opendaylight.yangtools.yang.binding.DataObject> void merge(LogicalDatastoreType store,
                                                                                 org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                                 T data,
                                                                                 boolean createMissingParents)

Description copied from interface: WriteTransaction

Merges a piece of data with the existing data at a specified path. Any pre-existing data which is not explicitly overwritten will be preserved. This means that if you store a container, its child lists will be merged.

For more information on usage and examples, please see the documentation in AsyncWriteTransaction.

If you require an explicit replace operation, use WriteTransaction.put(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T>, T) instead.

Specified by:

merge in interface WriteTransaction

Parameters:

store - the logical data store which should be modified

path - the data object path

data - the data object to be merged to the specified path

createMissingParents - if WriteTransaction.CREATE_MISSING_PARENTS (true), any missing parent nodes will be automatically created using a merge operation.

delete

public void delete(LogicalDatastoreType store,
                   org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path)

Description copied from interface: AsyncWriteTransaction

Removes a piece of data from specified path. This operation does not fail if the specified path does not exist.

Specified by:

delete in interface WriteTransaction

Specified by:

delete in interface AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

Parameters:

store - Logical data store which should be modified

path - Data object path

cancel

public boolean cancel()

Description copied from interface: AsyncWriteTransaction

Cancels the transaction.

Transactions can only be cancelled if it's state is new or submitted.

Invoking cancel() on a failed or cancelled transaction will have no effect, and transaction is considered cancelled.

Invoking cancel() on a finished transaction (future returned by AsyncWriteTransaction.submit() already completed will always fail (return false).

Specified by:

cancel in interface AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

Returns:

false if the task could not be cancelled, typically because it has already completed normally true otherwise

commit

public com.google.common.util.concurrent.FluentFuture<? extends org.opendaylight.mdsal.common.api.CommitInfo> commit()

Description copied from interface: AsyncWriteTransaction

Submits this transaction to be asynchronously applied to update the logical data tree. The returned FluentFuture conveys the result of applying the data changes.

This call logically seals the transaction, which prevents the client from further changing the data tree using this transaction. Any subsequent calls to put(LogicalDatastoreType, Path, Object), merge(LogicalDatastoreType, Path, Object), delete(LogicalDatastoreType, Path) will fail with IllegalStateException. The transaction is marked as submitted and enqueued into the data store back-end for processing.

Whether or not the commit is successful is determined by versioning of the data tree and validation of registered commit participants if the transaction changes the data tree.

The effects of a successful commit of data depends on listeners and commit participants that are registered with the data broker.

A successful commit produces implementation-specific CommitInfo structure, which is used to communicate post-condition information to the caller. Such information can contain commit-id, timing information or any other information the implementation wishes to share.

Specified by:

commit in interface AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

Returns:

a FluentFuture containing the result of the commit information. The Future blocks until the commit operation is complete. A successful commit returns nothing. On failure, the Future will fail with a TransactionCommitFailedException or an exception derived from TransactionCommitFailedException.

getIdentifier

public Object getIdentifier()

Specified by:

getIdentifier in interface AsyncTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

Specified by:

getIdentifier in interface org.opendaylight.yangtools.concepts.Identifiable<Object>