org.opendaylight.mdsal.dom.spi

Class ForwardingDOMDataReadOnlyTransaction

java.lang.Object

com.google.common.collect.ForwardingObject

org.opendaylight.mdsal.dom.spi.ForwardingDOMDataReadOnlyTransaction

All Implemented Interfaces:

AutoCloseable, AsyncReadTransaction<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>, AsyncTransaction<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>, DOMDataTreeReadTransaction, org.opendaylight.yangtools.concepts.Identifiable<Object>

public abstract class ForwardingDOMDataReadOnlyTransaction
extends com.google.common.collect.ForwardingObject
implements DOMDataTreeReadTransaction

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

Constructor Summary

Constructors

Constructor and Description
ForwardingDOMDataReadOnlyTransaction()

Method Summary

Modifier and Type	Method and Description
void	close() Closes this transaction and releases all resources associated with it.
protected abstract DOMDataTreeReadTransaction	delegate()
com.google.common.util.concurrent.CheckedFuture<Boolean,ReadFailedException>	exists(LogicalDatastoreType store, org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path) Checks if data is available in the logical data store located at provided path.
Object	getIdentifier()
com.google.common.util.concurrent.CheckedFuture<com.google.common.base.Optional<org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>,ReadFailedException>	read(LogicalDatastoreType store, org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path) Reads data from 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

Constructor Detail

ForwardingDOMDataReadOnlyTransaction

public ForwardingDOMDataReadOnlyTransaction()

Method Detail

delegate

@Nonnull
protected abstract DOMDataTreeReadTransaction delegate()

Specified by:

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

read

public com.google.common.util.concurrent.CheckedFuture<com.google.common.base.Optional<org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>,ReadFailedException> read(LogicalDatastoreType store,
                                                                                                                                                                                      org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path)

Description copied from interface: DOMDataTreeReadTransaction

Reads data from 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 DOMDataTreeReadTransaction

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,ReadFailedException> exists(LogicalDatastoreType store,
                                                                                           org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path)

Description copied from interface: DOMDataTreeReadTransaction

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 DOMDataTreeReadTransaction.read(org.opendaylight.mdsal.common.api.LogicalDatastoreType, org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier) 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

Specified by:

exists in interface DOMDataTreeReadTransaction

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()

Specified by:

getIdentifier in interface AsyncTransaction<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>

Specified by:

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

close

public void close()

Description copied from interface: AsyncReadTransaction

Closes this transaction and releases all resources associated with it.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface AsyncReadTransaction<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier,org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>