org.opendaylight.mdsal.binding.javav2.api

Interface CursorAwareWriteTransaction

All Superinterfaces:

DataTreeCursorProvider

All Known Implementing Classes:

BindingDOMCursorAwareWriteTransactionAdapter

@Beta
public interface CursorAwareWriteTransaction
extends DataTreeCursorProvider

Write transaction that provides cursor's with write access to the data tree.

Method Summary

Modifier and Type	Method and Description
boolean	cancel() Cancels the transaction.
<T extends TreeNode> DataTreeCursor	createCursor(DataTreeIdentifier<T> path) Create a DataTreeWriteCursor anchored at the specified path.
<T extends TreeNode> void	submit(BiConsumer<TransactionCommitFailedException,T> callback) Submits this transaction to be asynchronously applied to update the logical data tree.

Method Detail

createCursor

@Nullable
<T extends TreeNode> DataTreeCursor createCursor(@Nonnull
                                                           DataTreeIdentifier<T> path)

Create a DataTreeWriteCursor anchored at the specified path. There can only be one cursor open at a time.

Specified by:

createCursor in interface DataTreeCursorProvider

Type Parameters:

T - data tree type

Parameters:

path - Path at which the cursor is to be anchored

Returns:

write cursor at the desired location.

Throws:

IllegalStateException - when there's an open cursor, or this transaction is closed already.

cancel

boolean cancel()

Cancels the transaction.

Transactions can only be cancelled if it was not yet submited.

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

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

Returns:

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

submit

<T extends TreeNode> void submit(BiConsumer<TransactionCommitFailedException,T> callback)

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

This call logically seals the transaction, which prevents the client from further changing data tree using this transaction's cursor. Any subsequent calls to createCursorCursor(DOMDataTreeIdentifier or any of the cursor's methods will fail with IllegalStateException.

The transaction is marked as submitted and enqueued into the shard back-end for processing.

Type Parameters:

T - result type

Parameters:

callback - result callback