Package org.opendaylight.mdsal.dom.api
Interface DOMDataTreeReadOperations
-
- All Known Subinterfaces:
DOMDataTreeReadTransaction
,DOMDataTreeReadWriteTransaction
- All Known Implementing Classes:
ForwardingDOMDataReadOnlyTransaction
,ForwardingDOMDataReadWriteTransaction
,ShardedDOMReadTransactionAdapter
,TransactionChainReadTransaction
public interface DOMDataTreeReadOperations
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description FluentFuture<Boolean>
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.FluentFuture<Optional<org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>>
read(LogicalDatastoreType store, org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path)
Reads data from provided logical data store located at the provided path.
-
-
-
Method Detail
-
read
FluentFuture<Optional<org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode<?,?>>> read(LogicalDatastoreType store, org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier path)
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).
- Parameters:
store
- Logical data store from which read should occur.path
- Path which uniquely identifies subtree which client want to read- Returns:
- a FluentFuture 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.empty().
- If the read of the data fails, the Future will fail with a
ReadFailedException
or an exception derived from ReadFailedException.
-
exists
FluentFuture<Boolean> 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.Note: a successful result from this method makes no guarantee that a subsequent call to
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 toexists
andread
- 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 FluentFuture 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.
-
-