Package org.opendaylight.yangtools.yang.data.tree.api

Interface DataTreeCandidateNode

public interface DataTreeCandidateNode
A single node within a DataTreeCandidate. The nodes are organized in tree hierarchy, reflecting the modification from which this candidate was created. The node itself exposes the before- and after-image of the tree restricted to the modified nodes.

  • Method Details

    • name

      @NonNull YangInstanceIdentifier.PathArgument name()
      Get the node underlying NormalizedNode.name().
      Returns:
      The node identifier.

    • childNodes

      @NonNull Collection<DataTreeCandidateNode> childNodes()
      Get an unmodifiable collection of modified child nodes. Note that the collection may include ModificationType.UNMODIFIED nodes, which the caller is expected to handle as if they were not present.
      Returns:
      Unmodifiable collection of modified child nodes.

    • modifiedChild

      @Nullable DataTreeCandidateNode modifiedChild(YangInstanceIdentifier.PathArgument childName)
      Returns modified child or empty. Note that this method may return an ModificationType.UNMODIFIED node when there is evidence of the node or its parent being involved in modification which has turned out not to modify the node's contents.
      Parameters:
      childName - Identifier of child node
      Returns:
      Modified child or null if the specified child has not been modified
      Throws:
      NullPointerException - if childNamez is null

    • findModifiedChild

      default @NonNull Optional<DataTreeCandidateNode> findModifiedChild(YangInstanceIdentifier.PathArgument childName)
      Returns modified child or empty. Note that this method may return an ModificationType.UNMODIFIED node when there is evidence of the node or its parent being involved in modification which has turned out not to modify the node's contents.
      Parameters:
      childName - Identifier of child node
      Returns:
      Modified child or empty.
      Throws:
      NullPointerException - if childIdentifier is null
      Implementation Requirements:
      Default implementation defers to Optional.ofNullable(Object) based on modifiedChild(PathArgument).

    • getModifiedChild

      default @NonNull DataTreeCandidateNode getModifiedChild(YangInstanceIdentifier.PathArgument childName)
      Returns modified child or empty. Note that this method may return an ModificationType.UNMODIFIED node when there is evidence of the node or its parent being involved in modification which has turned out not to modify the node's contents.
      Parameters:
      childName - Identifier of child node
      Returns:
      Modified child
      Throws:
      NullPointerException - if childName is null
      VerifyException - if no modified child with specified name is found
      Implementation Requirements:
      Default implementation defers to modifiedChild(PathArgument).

    • modificationType

      @NonNull ModificationType modificationType()
      Return the type of modification this node is undergoing.
      Returns:
      Node modification type.

    • dataBefore

      @Nullable NormalizedNode dataBefore()
      Return the before-image of data corresponding to the node.
      Returns:
      Node data as they were present in the tree before the modification was applied.

    • findDataBefore

      default @NonNull Optional<NormalizedNode> findDataBefore()
      Return the before-image of data corresponding to the node.
      Returns:
      Node data as they were present in the tree before the modification was applied, or empty.
      Implementation Requirements:
      Default implementation defers to Optional.ofNullable(Object) based on dataBefore().

    • getDataBefore

      default @NonNull NormalizedNode getDataBefore()
      Return the before-image of data corresponding to the node.
      Returns:
      Node data as they were present in the tree before the modification was applied.
      Throws:
      VerifyException - if no before-image is present
      Implementation Requirements:
      Default implementation defers to dataBefore().

    • dataAfter

      @Nullable NormalizedNode dataAfter()
      Return the after-image of data corresponding to the node.
      Returns:
      Node data as they will be present in the tree after the modification is applied

    • findDataAfter

      default @NonNull Optional<NormalizedNode> findDataAfter()
      Return the after-image of data corresponding to the node.
      Returns:
      Node data as they will be present in the tree after the modification is applied, or empty
      Implementation Requirements:
      Default implementation defers to Optional.ofNullable(Object) based on dataAfter().

    • getDataAfter

      default @NonNull NormalizedNode getDataAfter()
      Return the after-image of data corresponding to the node.
      Returns:
      Node data as they will be present in the tree after the modification is applied.
      Throws:
      VerifyException - if no after-image is present
      Implementation Requirements:
      Default implementation defers to dataAfter().