org.opendaylight.mdsal.dom.api

Interface DOMDataTreeCursor

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

DOMDataTreeReadCursor, DOMDataTreeWriteCursor

All Known Implementing Classes:

AbstractDataModificationCursor

@Beta
 @NotThreadSafe
public interface DOMDataTreeCursor
extends AutoCloseable

A cursor holding a logical position within a conceptual data tree. It allows operations relative to that position, as well as moving the position up or down the tree.

Method Summary

Modifier and Type	Method and Description
void	close() Close this cursor.
void	enter(@NonNull Iterable<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument> path) Move the cursor to the specified child of the current position.
default void	enter(org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument... path) Move the cursor to the specified child of the current position.
void	enter(@NonNull org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument child) Move the cursor to the specified child of the current position.
void	exit() Move the cursor up to the parent of current position.
void	exit(int depth) Move the cursor up by specified amounts of steps from the current position.

Method Detail

enter

void enter(@NonNull org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument child)

Move the cursor to the specified child of the current position.

Parameters:

child - Child identifier

Throws:

IllegalArgumentException - when specified identifier does not identify a valid child, or if that child is not an instance of NormalizedNodeContainer.

enter

default void enter(org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument... path)

Move the cursor to the specified child of the current position. This is the equivalent of multiple invocations of #enter(PathArgument), except the operation is performed all at once.

Parameters:

path - Nested child identifier

Throws:

IllegalArgumentException - when specified path does not identify a valid child, or if that child is not an instance of NormalizedNodeContainer.

enter

void enter(@NonNull Iterable<org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument> path)

Move the cursor to the specified child of the current position. This is equivalent to #enter(PathArgument...), except it takes an Iterable argument.

Parameters:

path - Nested child identifier

Throws:

IllegalArgumentException - when specified path does not identify a valid child, or if that child is not an instance of NormalizedNodeContainer.

exit

void exit()

Move the cursor up to the parent of current position. This is equivalent of invoking exit(1).

Throws:

IllegalStateException - when exiting would violate containment, typically by attempting to exit more levels than previously entered.

exit

void exit(int depth)

Move the cursor up by specified amounts of steps from the current position. This is equivalent of invoking exit() multiple times, except the operation is performed atomically.

Parameters:

depth - number of steps to exit

Throws:

IllegalArgumentException - when depth is negative.

IllegalStateException - when exiting would violate containment, typically by attempting to exit more levels than previously entered.

close

void close()

Close this cursor. Attempting any further operations on the cursor will lead to undefined behavior.

Specified by:

close in interface AutoCloseable