Module jdk.compiler

Class DocTreePath

java.lang.Object
com.sun.source.util.DocTreePath
All Implemented Interfaces:
Iterable<DocTree>

public class DocTreePath
extends Object
implements Iterable<DocTree>
A path of tree nodes, typically used to represent the sequence of ancestor nodes of a tree node up to the top level DocCommentTree node.
Since:
1.8
  • Constructor Details

    • DocTreePath

      public DocTreePath​(TreePath treePath, DocCommentTree t)
      Creates a DocTreePath for a root node.
      Parameters:
      treePath - the TreePath from which the root node was created.
      t - the DocCommentTree to create the path for.
    • DocTreePath

      public DocTreePath​(DocTreePath p, DocTree t)
      Creates a DocTreePath for a child node.
      Parameters:
      p - the parent node
      t - the child node
  • Method Details

    • getPath

      public static DocTreePath getPath​(TreePath treePath, DocCommentTree doc, DocTree target)
      Returns a documentation tree path for a tree node within a compilation unit, or null if the node is not found.
      Parameters:
      treePath - the path for the node with which the doc comment is associated
      doc - the doc comment associated with the node
      target - a node within the doc comment
      Returns:
      a path identifying the target within the tree
    • getPath

      public static DocTreePath getPath​(DocTreePath path, DocTree target)
      Returns a documentation tree path for a tree node within a subtree identified by a DocTreePath object, or null if the node is not found.
      Parameters:
      path - a path identifying a node within a doc comment tree
      target - a node to be located within the given node
      Returns:
      a path identifying the target node
    • getTreePath

      public TreePath getTreePath()
      Returns the TreePath associated with this path.
      Returns:
      the TreePath for this DocTreePath
    • getDocComment

      public DocCommentTree getDocComment()
      Returns the DocCommentTree associated with this path.
      Returns:
      the DocCommentTree for this DocTreePath
    • getLeaf

      public DocTree getLeaf()
      Returns the leaf node for this path.
      Returns:
      the DocTree for this DocTreePath
    • getParentPath

      public DocTreePath getParentPath()
      Returns the path for the enclosing node, or null if there is no enclosing node.
      Returns:
      DocTreePath of parent