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 Summary

Constructors

Constructor	Description
DocTreePath(DocTreePath p, DocTree t)	Creates a DocTreePath for a child node.
DocTreePath(TreePath treePath, DocCommentTree t)	Creates a DocTreePath for a root node.

Method Summary

Modifier and Type	Method	Description
DocCommentTree	getDocComment()	Returns the DocCommentTree associated with this path.
DocTree	getLeaf()	Returns the leaf node for this path.
DocTreePath	getParentPath()	Returns the path for the enclosing node, or null if there is no enclosing node.
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.
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.
TreePath	getTreePath()	Returns the TreePath associated with this path.
Iterator<DocTree>	iterator()	Returns an iterator over elements of type T.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Methods declared in interface Iterable

forEach, spliterator

Modifier and Type	Method	Description
default void	forEach(Consumer<? super DocTree> action)	Performs the given action for each element of the Iterable until all elements have been processed or the action throws an exception.
default Spliterator<DocTree>	spliterator()	Creates a Spliterator over the elements described by this Iterable.

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

iterator

public Iterator<DocTree> iterator()

Description copied from interface: Iterable

Returns an iterator over elements of type T.

Specified by:

iterator in interface Iterable<DocTree>

Returns:

an Iterator.