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

Class ForwardingReadWriteTransaction

java.lang.Object

com.google.common.collect.ForwardingObject

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

All Implemented Interfaces:

ReadTransaction, ReadWriteTransaction, WriteTransaction, org.opendaylight.controller.md.sal.common.api.data.AsyncReadTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, org.opendaylight.controller.md.sal.common.api.data.AsyncReadWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, org.opendaylight.controller.md.sal.common.api.data.AsyncTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>, org.opendaylight.yangtools.concepts.Identifiable<Object>

Deprecated.

Use org.opendaylight.mdsal.binding.spi.ForwardingReadWriteTransaction instead.

@Deprecated
public class ForwardingReadWriteTransaction
extends com.google.common.collect.ForwardingObject
implements ReadWriteTransaction

Utility ReadWriteTransaction 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	ForwardingReadWriteTransaction(ReadWriteTransaction delegate) Deprecated.

Method Summary

Modifier and Type	Method and Description
boolean	cancel() Deprecated.
com.google.common.util.concurrent.FluentFuture<? extends org.opendaylight.mdsal.common.api.CommitInfo>	commit() Deprecated.
protected ReadWriteTransaction	delegate() Deprecated.
void	delete(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path) Deprecated.
com.google.common.util.concurrent.CheckedFuture<Boolean,org.opendaylight.controller.md.sal.common.api.data.ReadFailedException>	exists(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path) Deprecated. Checks if data is available in the logical data store located at provided path.
Object	getIdentifier() Deprecated.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	merge(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data) Deprecated. Merges a piece of data with the existing data at a specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	merge(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data, boolean createMissingParents) Deprecated. Merges a piece of data with the existing data at a specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	put(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data) Deprecated. Stores a piece of data at the specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> void	put(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path, T data, boolean createMissingParents) Deprecated. Stores a piece of data at the specified path.
<T extends org.opendaylight.yangtools.yang.binding.DataObject> com.google.common.util.concurrent.CheckedFuture<com.google.common.base.Optional<T>,org.opendaylight.controller.md.sal.common.api.data.ReadFailedException>	read(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path) Deprecated. Reads data from the provided logical data store located at the provided 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

ForwardingReadWriteTransaction

protected ForwardingReadWriteTransaction(ReadWriteTransaction delegate)

Deprecated.

Method Detail

delegate

protected ReadWriteTransaction delegate()

Deprecated.

Specified by:

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

put

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

Deprecated.

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(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store,
                                                                               org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                               T data,
                                                                               boolean createMissingParents)

Deprecated.

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.

read

public <T extends org.opendaylight.yangtools.yang.binding.DataObject> com.google.common.util.concurrent.CheckedFuture<com.google.common.base.Optional<T>,org.opendaylight.controller.md.sal.common.api.data.ReadFailedException> read(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store,
                                                                                                                                                                                                                                      org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path)

Deprecated.

Description copied from interface: ReadTransaction

Reads data from the provided logical data store located at the provided path.

If the target is a subtree, then the whole subtree is read (and will be accessible from the returned data object).

Specified by:

read in interface ReadTransaction

Parameters:

store - Logical data store from which read should occur.

path - Path which uniquely identifies subtree which client want to read

Returns:

a CheckFuture containing the result of the read. The Future blocks until the commit operation is complete. Once complete:

• If the data at the supplied path exists, the Future returns an Optional object containing the data.
• If the data at the supplied path does not exist, the Future returns Optional#absent().
• If the read of the data fails, the Future will fail with a ReadFailedException or an exception derived from ReadFailedException.

exists

public com.google.common.util.concurrent.CheckedFuture<Boolean,org.opendaylight.controller.md.sal.common.api.data.ReadFailedException> exists(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store,
                                                                                                                                              org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path)

Deprecated.

Description copied from interface: ReadTransaction

Checks if data is available in the logical data store located at provided path.

Note: a successful result from this method makes no guarantee that a subsequent call to ReadTransaction.read(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType, org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T>) will succeed. It is possible that the data resides in a data store on a remote node and, if that node goes down or a network failure occurs, a subsequent read would fail. Another scenario is if the data is deleted in between the calls to exists and read

Default implementation delegates to ReadTransaction.read(LogicalDatastoreType, InstanceIdentifier), implementations are advised to provide a more efficient override.

Specified by:

exists in interface ReadTransaction

Parameters:

store - Logical data store from which read should occur.

path - Path which uniquely identifies subtree which client want to check existence of

Returns:

a CheckFuture containing the result of the check.

• If the data at the supplied path exists, the Future returns a Boolean whose value is true, false otherwise
• If checking for the data fails, the Future will fail with a ReadFailedException or an exception derived from ReadFailedException.

getIdentifier

public Object getIdentifier()

Deprecated.

Specified by:

getIdentifier in interface org.opendaylight.controller.md.sal.common.api.data.AsyncTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

Specified by:

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

cancel

public boolean cancel()

Deprecated.

Specified by:

cancel in interface org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

merge

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

Deprecated.

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(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store,
                                                                                 org.opendaylight.yangtools.yang.binding.InstanceIdentifier<T> path,
                                                                                 T data,
                                                                                 boolean createMissingParents)

Deprecated.

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.

commit

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

Deprecated.

Specified by:

commit in interface org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>

delete

public void delete(org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType store,
                   org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?> path)

Deprecated.

Specified by:

delete in interface WriteTransaction

Specified by:

delete in interface org.opendaylight.controller.md.sal.common.api.data.AsyncWriteTransaction<org.opendaylight.yangtools.yang.binding.InstanceIdentifier<?>,org.opendaylight.yangtools.yang.binding.DataObject>