APIdia Launch Partner
Top Description Methods
com.sun.source.util

public Interface DocTreeFactory

Known Direct Implementers
com.sun.tools.javac.tree.DocTreeMaker
Imports
java.util.List, javax.lang.model.element.Element, .Name, javax.lang.model.util.Elements, javax.tools.Diagnostic, .JavaFileObject, com.sun.source.doctree.AttributeTree, .AttributeTree.ValueKind, .AuthorTree, .CommentTree, .DeprecatedTree, .DocCommentTree, .DocRootTree, .DocTree, .DocTypeTree, .EndElementTree, .EntityTree, .ErroneousTree, .EscapeTree, .HiddenTree, .IdentifierTree, .IndexTree, .InheritDocTree, .LinkTree, .LiteralTree, .RawTextTree, .ParamTree, .ProvidesTree, .ReferenceTree, .ReturnTree, .SeeTree, .SerialDataTree, .SerialFieldTree, .SerialTree, .SinceTree, .SnippetTree, .SpecTree, .StartElementTree, .SummaryTree, .SystemPropertyTree, .TextTree, .ThrowsTree, .UnknownBlockTagTree, .UnknownInlineTagTree, .UsesTree, .ValueTree, .VersionTree

Factory for creating DocTree nodes.

Implementation Note

The methods in an implementation of this interface may only accept DocTree nodes that have been created by the same implementation.

Since
9

Method Summary

Modifier and TypeMethod and Description
public DocTreeFactory

Returns:

this object, to facilitate method chaining
at
(int
the position
pos
)

Sets the position to be recorded in subsequent tree nodes created by this factory.

public List<DocTree>

Returns:

a list containing the first sentence of the list
getFirstSentence
(List<? extends DocTree>
the list
list
)

Gets the first sentence contained in a list of content.

public AttributeTree

Returns:

an AttributeTree object
newAttributeTree
(Name
the name of the attribute
name
,
AttributeTree.ValueKind
the kind of the attribute value
vkind
,
List<? extends DocTree>
the value, if any, of the attribute
value
)

Creates a new AttributeTree object, to represent an attribute in an HTML element or tag.

public AuthorTree

Returns:

an AuthorTree object
newAuthorTree
(List<? extends DocTree>
the name of the author
name
)

Creates a new AuthorTree object, to represent an @author tag.

public LiteralTree

Returns:

a LiteralTree object
newCodeTree
(TextTree
the content of the tag
text
)

Creates a new LiteralTree object, to represent a {@code } tag.

public CommentTree

Returns:

a CommentTree object
newCommentTree
(String
the content of the comment
text
)

Creates a new CommentTree, to represent an HTML comment.

public DeprecatedTree

Returns:

a DeprecatedTree object
newDeprecatedTree
(List<? extends DocTree>
the content of the tag
text
)

Creates a new DeprecatedTree object, to represent an @deprecated tag.

public DocCommentTree

Returns:

a DocCommentTree object
newDocCommentTree
(List<? extends DocTree>
the entire body of the doc comment
fullBody
,
List<? extends DocTree>
the block tags in the doc comment
tags
)

Creates a new DocCommentTree object, to represent a complete doc comment.

public DocCommentTree

Returns:

a DocCommentTree object
newDocCommentTree
(List<? extends DocTree>
the entire body of the doc comment
fullBody
,
List<? extends DocTree>
the block tags in the doc comment
tags
,
List<? extends DocTree>
the meta content of an html file including the body tag
preamble
,
List<? extends DocTree>
the meta content of an html including the closing body tag
postamble
)

Creates a new DocCommentTree object, to represent the entire doc comment.

public DocRootTree

Returns:

a DocRootTree object
newDocRootTree
()

Creates a new DocRootTree object, to represent an {@docRoot} tag.

public DocTypeTree

Returns:

a DocTypeTree object
newDocTypeTree
(String
the content of the declaration
text
)

Creates a new DocTypeTree, to represent a DOCTYPE HTML declaration.

public EndElementTree

Returns:

an EndElementTree object
newEndElementTree
(Name
the name of the HTML element
name
)

Creates a new EndElement object, to represent the end of an HTML element.

public EntityTree

Returns:

an EntityTree object
newEntityTree
(Name
the name of the entity, representing the characters between '&' and ';' in the representation of the entity in an HTML document
name
)

Creates a new EntityTree object, to represent an HTML entity.

public ErroneousTree

Returns:

an ErroneousTree object
newErroneousTree
(String
the unparseable text
text
,
Diagnostic<JavaFileObject>
a diagnostic associated with the unparseable text, or null
diag
)

Creates a new ErroneousTree object, to represent some unparseable input.

public EscapeTree

Returns:

an EscapeTree object
newEscapeTree
(char
the character
ch
)

Creates a new EscapeTree object, to represent an escaped character.

public ThrowsTree

Returns:

an ThrowsTree object
newExceptionTree
(ReferenceTree
the name of the exception
name
,
List<? extends DocTree>
a description of why the exception might be thrown
description
)

Creates a new ThrowsTree object, to represent an @exception tag.

public HiddenTree

Returns:

a HiddenTree object
newHiddenTree
(List<? extends DocTree>
the content of the tag
text
)

Creates a new HiddenTree object, to represent an @hidden tag.

public IdentifierTree

Returns:

an IdentifierTree object
newIdentifierTree
(Name
the name of the identifier
name
)

Creates a new IdentifierTree object, to represent an identifier, such as in a @param tag.

public IndexTree

Returns:

an IndexTree object
newIndexTree
(DocTree
the search term
term
,
List<? extends DocTree>
an optional description of the search term
description
)

Creates a new IndexTree object, to represent an {@index } tag.

public InheritDocTree

Returns:

an InheritDocTree object
newInheritDocTree
()

Creates a new InheritDocTree object, to represent an {@inheritDoc} tag.

public default InheritDocTree

Returns:

an InheritDocTree object
newInheritDocTree
(ReferenceTree
a superclass or superinterface reference
supertype
)

Creates a new InheritDocTree object, to represent an {@inheritDoc} tag.

public LinkTree

Returns:

a LinkTree object
newLinkPlainTree
(ReferenceTree
the API element being referenced
ref
,
List<? extends DocTree>
an optional label for the link
label
)

Creates a new LinkTree object, to represent a {@linkplain } tag.

public LinkTree

Returns:

a LinkTree object
newLinkTree
(ReferenceTree
the API element being referenced
ref
,
List<? extends DocTree>
an optional label for the link
label
)

Creates a new LinkTree object, to represent a {@link } tag.

public LiteralTree

Returns:

a LiteralTree object
newLiteralTree
(TextTree
the content of the tag
text
)

Creates a new LiteralTree object, to represent a {@literal } tag.

public ParamTree

Returns:

a ParamTree object
newParamTree
(boolean
true if this is a type parameter, and false otherwise
isTypeParameter
,
IdentifierTree
the parameter being described
name
,
List<? extends DocTree>
the description of the parameter
description
)

Creates a new ParamTree object, to represent a @param tag.

public ProvidesTree

Returns:

a ProvidesTree object
newProvidesTree
(ReferenceTree
the name of the service type
name
,
List<? extends DocTree>
a description of the service being provided
description
)

Creates a new ProvidesTree object, to represent a @provides tag.

public RawTextTree

Returns:

a RawTextTree object
newRawTextTree
(DocTree.Kind
the kind of text
kind
,
String
the code
code
)

Creates a new RawTextTree object, to represent a fragment of uninterpreted raw text.

public ReferenceTree

Returns:

a ReferenceTree object
newReferenceTree
(String
the doc comment signature of the reference
signature
)

Creates a new ReferenceTree object, to represent a reference to an API element.

public ReturnTree

Returns:

a ReturnTree object
newReturnTree
(List<? extends DocTree>
the description of the return value of a method
description
)

Creates a new ReturnTree object, to represent a @return tag.

public default ReturnTree

Returns:

a ReturnTree object
newReturnTree
(boolean
true if this instance is as an inline tag, and false otherwise
isInline
,
List<? extends DocTree>
the description of the return value of a method
description
)

Creates a new ReturnTree object, to represent a @return tag or {@return} tag.

public SeeTree

Returns:

a SeeTree object
newSeeTree
(List<? extends DocTree>
the reference
reference
)

Creates a new SeeTree object, to represent a @see tag.

public SerialDataTree

Returns:

a SerialDataTree object
newSerialDataTree
(List<? extends DocTree>
the description for the tag
description
)

Creates a new SerialDataTree object, to represent a @serialData tag.

public SerialFieldTree

Returns:

a SerialFieldTree object
newSerialFieldTree
(IdentifierTree
the name of the field
name
,
ReferenceTree
the type of the field
type
,
List<? extends DocTree>
the description of the field
description
)

Creates a new SerialFieldTree object, to represent a @serialField tag.

public SerialTree

Returns:

a SerialTree object
newSerialTree
(List<? extends DocTree>
the description for the tag
description
)

Creates a new SerialTree object, to represent a @serial tag.

public SinceTree

Returns:

a SinceTree object
newSinceTree
(List<? extends DocTree>
the content of the tag
text
)

Creates a new SinceTree object, to represent a @since tag.

public SnippetTree

Returns:

a SnippetTree object
newSnippetTree
(List<? extends DocTree>
the attributes of the tag
attributes
,
TextTree
the body of the tag, or null if the tag has no body (not to be confused with an empty body)
text
)

Creates a new SnippetTree object, to represent a {@snippet } tag.

public SpecTree

Returns:

a SpecTree object
newSpecTree
(TextTree
the url
url
,
List<? extends DocTree>
the title
title
)

Creates a new SpecTree object, to represent an @spec tag.

public StartElementTree

Returns:

a StartElementTree object
newStartElementTree
(Name
the name of the HTML element
name
,
List<? extends DocTree>
the attributes
attrs
,
boolean
true if the start element is marked as self-closing; otherwise false
selfClosing
)

Creates a new StartElementTree object, to represent the start of an HTML element.

public default SummaryTree

Returns:

a SummaryTree object
newSummaryTree
(List<? extends DocTree>
the content of the tag
summary
)

Creates a new SummaryTree object, to represent a {@summary } tag.

public SystemPropertyTree

Returns:

a SystemPropertyTree object
newSystemPropertyTree
(Name
the system property name
propertyName
)

Creates a new SystemPropertyTree object, to represent a {@systemProperty } tag.

public TextTree

Returns:

a TextTree object
newTextTree
(String
the text
text
)

Creates a new TextTree object, to represent some plain text.

public ThrowsTree

Returns:

a ThrowsTree object
newThrowsTree
(ReferenceTree
the name of the exception
name
,
List<? extends DocTree>
a description of why the exception might be thrown
description
)

Creates a new ThrowsTree object, to represent a @throws tag.

public UnknownBlockTagTree

Returns:

an UnknownBlockTagTree object
newUnknownBlockTagTree
(Name
the name of the block tag
name
,
List<? extends DocTree>
the content
content
)

Creates a new UnknownBlockTagTree object, to represent an unrecognized block tag.

public UnknownInlineTagTree

Returns:

an UnknownInlineTagTree object
newUnknownInlineTagTree
(Name
the name of the inline tag
name
,
List<? extends DocTree>
the content
content
)

Creates a new UnknownInlineTagTree object, to represent an unrecognized inline tag.

public UsesTree

Returns:

a UsesTree object
newUsesTree
(ReferenceTree
the name of the service type
name
,
List<? extends DocTree>
a description of how the service will be used
description
)

Creates a new UsesTree object, to represent a @uses tag.

public ValueTree

Returns:

a ValueTree object
newValueTree
(ReferenceTree
a reference to the value
ref
)

Creates a new ValueTree object, to represent a {@value } tag.

public default ValueTree

Returns:

a ValueTree object
newValueTree
(TextTree
a format string for the value
format
,
ReferenceTree
a reference to the value
ref
)

Creates a new ValueTree object, to represent a {@value } tag.

public VersionTree

Returns:

a VersionTree object
newVersionTree
(List<? extends DocTree>
the content of the tag
text
)

Creates a new VersionTree object, to represent a {@version } tag.

Method Detail

atback to summary
public DocTreeFactory at(int pos)

Sets the position to be recorded in subsequent tree nodes created by this factory. The position should be a character offset relative to the beginning of the source file or NOPOS.

Parameters
pos:int

the position

Returns:DocTreeFactory

this object, to facilitate method chaining

getFirstSentenceback to summary
public List<DocTree> getFirstSentence(List<? extends DocTree> list)

Gets the first sentence contained in a list of content. The determination of the first sentence is implementation specific, and may involve the use of a locale-specific BreakIterator and other heuristics. The resulting list may share a common set of initial items with the input list.

Parameters
list:List<? extends DocTree>

the list

Returns:List<DocTree>

a list containing the first sentence of the list

newAttributeTreeback to summary
public AttributeTree newAttributeTree(Name name, AttributeTree.ValueKind vkind, List<? extends DocTree> value)

Creates a new AttributeTree object, to represent an attribute in an HTML element or tag.

Parameters
name:Name

the name of the attribute

vkind:AttributeTree.ValueKind

the kind of the attribute value

value:List<? extends DocTree>

the value, if any, of the attribute

Returns:AttributeTree

an AttributeTree object

newAuthorTreeback to summary
public AuthorTree newAuthorTree(List<? extends DocTree> name)

Creates a new AuthorTree object, to represent an @author tag.

Parameters
name:List<? extends DocTree>

the name of the author

Returns:AuthorTree

an AuthorTree object

newCodeTreeback to summary
public LiteralTree newCodeTree(TextTree text)

Creates a new LiteralTree object, to represent a {@code } tag.

Parameters
text:TextTree

the content of the tag

Returns:LiteralTree

a LiteralTree object

newCommentTreeback to summary
public CommentTree newCommentTree(String text)

Creates a new CommentTree, to represent an HTML comment.

Parameters
text:String

the content of the comment

Returns:CommentTree

a CommentTree object

newDeprecatedTreeback to summary
public DeprecatedTree newDeprecatedTree(List<? extends DocTree> text)

Creates a new DeprecatedTree object, to represent an @deprecated tag.

Parameters
text:List<? extends DocTree>

the content of the tag

Returns:DeprecatedTree

a DeprecatedTree object

newDocCommentTreeback to summary
public DocCommentTree newDocCommentTree(List<? extends DocTree> fullBody, List<? extends DocTree> tags)

Creates a new DocCommentTree object, to represent a complete doc comment.

Parameters
fullBody:List<? extends DocTree>

the entire body of the doc comment

tags:List<? extends DocTree>

the block tags in the doc comment

Returns:DocCommentTree

a DocCommentTree object

newDocCommentTreeback to summary
public DocCommentTree newDocCommentTree(List<? extends DocTree> fullBody, List<? extends DocTree> tags, List<? extends DocTree> preamble, List<? extends DocTree> postamble)

Creates a new DocCommentTree object, to represent the entire doc comment.

Parameters
fullBody:List<? extends DocTree>

the entire body of the doc comment

tags:List<? extends DocTree>

the block tags in the doc comment

preamble:List<? extends DocTree>

the meta content of an html file including the body tag

postamble:List<? extends DocTree>

the meta content of an html including the closing body tag

Returns:DocCommentTree

a DocCommentTree object

Since
10
newDocRootTreeback to summary
public DocRootTree newDocRootTree()

Creates a new DocRootTree object, to represent an {@docRoot} tag.

Returns:DocRootTree

a DocRootTree object

newDocTypeTreeback to summary
public DocTypeTree newDocTypeTree(String text)

Creates a new DocTypeTree, to represent a DOCTYPE HTML declaration.

Parameters
text:String

the content of the declaration

Returns:DocTypeTree

a DocTypeTree object

Since
10
newEndElementTreeback to summary
public EndElementTree newEndElementTree(Name name)

Creates a new EndElement object, to represent the end of an HTML element.

Parameters
name:Name

the name of the HTML element

Returns:EndElementTree

an EndElementTree object

newEntityTreeback to summary
public EntityTree newEntityTree(Name name)

Creates a new EntityTree object, to represent an HTML entity.

Parameters
name:Name

the name of the entity, representing the characters between '&' and ';' in the representation of the entity in an HTML document

Returns:EntityTree

an EntityTree object

newErroneousTreeback to summary
public ErroneousTree newErroneousTree(String text, Diagnostic<JavaFileObject> diag)

Creates a new ErroneousTree object, to represent some unparseable input.

Parameters
text:String

the unparseable text

diag:Diagnostic<JavaFileObject>

a diagnostic associated with the unparseable text, or null

Returns:ErroneousTree

an ErroneousTree object

newEscapeTreeback to summary
public EscapeTree newEscapeTree(char ch)

Creates a new EscapeTree object, to represent an escaped character.

API Note

This method does not itself constrain the set of valid escape sequences, although the set may be effectively constrained to those defined in the Documentation Comment Specification for the Standard Doclet, including the following context-sensitive escape sequences:

  • @@, representing @, where it would otherwise be treated as introducing a block or inline tag,
  • @/, representing /, as part of *@/ to represent */, and
  • @*, representing *, where it would otherwise be discarded, after whitespace at the beginning of a line.
Parameters
ch:char

the character

Returns:EscapeTree

an EscapeTree object

Since
21
newExceptionTreeback to summary
public ThrowsTree newExceptionTree(ReferenceTree name, List<? extends DocTree> description)

Creates a new ThrowsTree object, to represent an @exception tag.

Parameters
name:ReferenceTree

the name of the exception

description:List<? extends DocTree>

a description of why the exception might be thrown

Returns:ThrowsTree

an ThrowsTree object

newHiddenTreeback to summary
public HiddenTree newHiddenTree(List<? extends DocTree> text)

Creates a new HiddenTree object, to represent an @hidden tag.

Parameters
text:List<? extends DocTree>

the content of the tag

Returns:HiddenTree

a HiddenTree object

newIdentifierTreeback to summary
public IdentifierTree newIdentifierTree(Name name)

Creates a new IdentifierTree object, to represent an identifier, such as in a @param tag.

Parameters
name:Name

the name of the identifier

Returns:IdentifierTree

an IdentifierTree object

newIndexTreeback to summary
public IndexTree newIndexTree(DocTree term, List<? extends DocTree> description)

Creates a new IndexTree object, to represent an {@index } tag.

Parameters
term:DocTree

the search term

description:List<? extends DocTree>

an optional description of the search term

Returns:IndexTree

an IndexTree object

newInheritDocTreeback to summary
public InheritDocTree newInheritDocTree()

Creates a new InheritDocTree object, to represent an {@inheritDoc} tag.

Returns:InheritDocTree

an InheritDocTree object

newInheritDocTreeback to summary
public default InheritDocTree newInheritDocTree(ReferenceTree supertype)

Creates a new InheritDocTree object, to represent an {@inheritDoc} tag.

Implementation Specification

This implementation throws UnsupportedOperationException.

Parameters
supertype:ReferenceTree

a superclass or superinterface reference

Returns:InheritDocTree

an InheritDocTree object

Since
22
newLinkPlainTreeback to summary
public LinkTree newLinkPlainTree(ReferenceTree ref, List<? extends DocTree> label)

Creates a new LinkTree object, to represent a {@linkplain } tag.

Parameters
ref:ReferenceTree

the API element being referenced

label:List<? extends DocTree>

an optional label for the link

Returns:LinkTree

a LinkTree object

newLinkTreeback to summary
public LinkTree newLinkTree(ReferenceTree ref, List<? extends DocTree> label)

Creates a new LinkTree object, to represent a {@link } tag.

Parameters
ref:ReferenceTree

the API element being referenced

label:List<? extends DocTree>

an optional label for the link

Returns:LinkTree

a LinkTree object

newLiteralTreeback to summary
public LiteralTree newLiteralTree(TextTree text)

Creates a new LiteralTree object, to represent a {@literal } tag.

Parameters
text:TextTree

the content of the tag

Returns:LiteralTree

a LiteralTree object

newParamTreeback to summary
public ParamTree newParamTree(boolean isTypeParameter, IdentifierTree name, List<? extends DocTree> description)

Creates a new ParamTree object, to represent a @param tag.

Parameters
isTypeParameter:boolean

true if this is a type parameter, and false otherwise

name:IdentifierTree

the parameter being described

description:List<? extends DocTree>

the description of the parameter

Returns:ParamTree

a ParamTree object

newProvidesTreeback to summary
public ProvidesTree newProvidesTree(ReferenceTree name, List<? extends DocTree> description)

Creates a new ProvidesTree object, to represent a @provides tag.

Parameters
name:ReferenceTree

the name of the service type

description:List<? extends DocTree>

a description of the service being provided

Returns:ProvidesTree

a ProvidesTree object

newRawTextTreeback to summary
public RawTextTree newRawTextTree(DocTree.Kind kind, String code)

Creates a new RawTextTree object, to represent a fragment of uninterpreted raw text.

Parameters
kind:DocTree.Kind

the kind of text

code:String

the code

Returns:RawTextTree

a RawTextTree object

Exceptions
IllegalArgumentException:
if the kind is not a recognized kind for raw text
Since
23
newReferenceTreeback to summary
public ReferenceTree newReferenceTree(String signature)

Creates a new ReferenceTree object, to represent a reference to an API element.

Parameters
signature:String

the doc comment signature of the reference

Returns:ReferenceTree

a ReferenceTree object

newReturnTreeback to summary
public ReturnTree newReturnTree(List<? extends DocTree> description)

Creates a new ReturnTree object, to represent a @return tag.

Parameters
description:List<? extends DocTree>

the description of the return value of a method

Returns:ReturnTree

a ReturnTree object

newReturnTreeback to summary
public default ReturnTree newReturnTree(boolean isInline, List<? extends DocTree> description)

Creates a new ReturnTree object, to represent a @return tag or {@return} tag.

Implementation Specification

This implementation throws UnsupportedOperationException if isInline is true, and calls newReturnTree(List) otherwise.

Parameters
isInline:boolean

true if this instance is as an inline tag, and false otherwise

description:List<? extends DocTree>

the description of the return value of a method

Returns:ReturnTree

a ReturnTree object

Exceptions
UnsupportedOperationException:
if inline {@return} tags are not supported
Since
16
newSeeTreeback to summary
public SeeTree newSeeTree(List<? extends DocTree> reference)

Creates a new SeeTree object, to represent a @see tag.

Parameters
reference:List<? extends DocTree>

the reference

Returns:SeeTree

a SeeTree object

newSerialDataTreeback to summary
public SerialDataTree newSerialDataTree(List<? extends DocTree> description)

Creates a new SerialDataTree object, to represent a @serialData tag.

Parameters
description:List<? extends DocTree>

the description for the tag

Returns:SerialDataTree

a SerialDataTree object

newSerialFieldTreeback to summary
public SerialFieldTree newSerialFieldTree(IdentifierTree name, ReferenceTree type, List<? extends DocTree> description)

Creates a new SerialFieldTree object, to represent a @serialField tag.

Parameters
name:IdentifierTree

the name of the field

type:ReferenceTree

the type of the field

description:List<? extends DocTree>

the description of the field

Returns:SerialFieldTree

a SerialFieldTree object

newSerialTreeback to summary
public SerialTree newSerialTree(List<? extends DocTree> description)

Creates a new SerialTree object, to represent a @serial tag.

Parameters
description:List<? extends DocTree>

the description for the tag

Returns:SerialTree

a SerialTree object

newSinceTreeback to summary
public SinceTree newSinceTree(List<? extends DocTree> text)

Creates a new SinceTree object, to represent a @since tag.

Parameters
text:List<? extends DocTree>

the content of the tag

Returns:SinceTree

a SinceTree object

newSnippetTreeback to summary
public SnippetTree newSnippetTree(List<? extends DocTree> attributes, TextTree text)

Creates a new SnippetTree object, to represent a {@snippet } tag.

Parameters
attributes:List<? extends DocTree>

the attributes of the tag

text:TextTree

the body of the tag, or null if the tag has no body (not to be confused with an empty body)

Returns:SnippetTree

a SnippetTree object

Since
18
newSpecTreeback to summary
public SpecTree newSpecTree(TextTree url, List<? extends DocTree> title)

Creates a new SpecTree object, to represent an @spec tag.

Parameters
url:TextTree

the url

title:List<? extends DocTree>

the title

Returns:SpecTree

a SpecTree object

Since
20
newStartElementTreeback to summary
public StartElementTree newStartElementTree(Name name, List<? extends DocTree> attrs, boolean selfClosing)

Creates a new StartElementTree object, to represent the start of an HTML element.

Parameters
name:Name

the name of the HTML element

attrs:List<? extends DocTree>

the attributes

selfClosing:boolean

true if the start element is marked as self-closing; otherwise false

Returns:StartElementTree

a StartElementTree object

newSummaryTreeback to summary
public default SummaryTree newSummaryTree(List<? extends DocTree> summary)

Creates a new SummaryTree object, to represent a {@summary } tag.

Implementation Specification

This implementation throws UnsupportedOperationException.

Parameters
summary:List<? extends DocTree>

the content of the tag

Returns:SummaryTree

a SummaryTree object

Since
10
newSystemPropertyTreeback to summary
public SystemPropertyTree newSystemPropertyTree(Name propertyName)

Creates a new SystemPropertyTree object, to represent a {@systemProperty } tag.

Parameters
propertyName:Name

the system property name

Returns:SystemPropertyTree

a SystemPropertyTree object

Since
12
newTextTreeback to summary
public TextTree newTextTree(String text)

Creates a new TextTree object, to represent some plain text.

Parameters
text:String

the text

Returns:TextTree

a TextTree object

newThrowsTreeback to summary
public ThrowsTree newThrowsTree(ReferenceTree name, List<? extends DocTree> description)

Creates a new ThrowsTree object, to represent a @throws tag.

Parameters
name:ReferenceTree

the name of the exception

description:List<? extends DocTree>

a description of why the exception might be thrown

Returns:ThrowsTree

a ThrowsTree object

newUnknownBlockTagTreeback to summary
public UnknownBlockTagTree newUnknownBlockTagTree(Name name, List<? extends DocTree> content)

Creates a new UnknownBlockTagTree object, to represent an unrecognized block tag.

Parameters
name:Name

the name of the block tag

content:List<? extends DocTree>

the content

Returns:UnknownBlockTagTree

an UnknownBlockTagTree object

newUnknownInlineTagTreeback to summary
public UnknownInlineTagTree newUnknownInlineTagTree(Name name, List<? extends DocTree> content)

Creates a new UnknownInlineTagTree object, to represent an unrecognized inline tag.

Parameters
name:Name

the name of the inline tag

content:List<? extends DocTree>

the content

Returns:UnknownInlineTagTree

an UnknownInlineTagTree object

newUsesTreeback to summary
public UsesTree newUsesTree(ReferenceTree name, List<? extends DocTree> description)

Creates a new UsesTree object, to represent a @uses tag.

Parameters
name:ReferenceTree

the name of the service type

description:List<? extends DocTree>

a description of how the service will be used

Returns:UsesTree

a UsesTree object

newValueTreeback to summary
public ValueTree newValueTree(ReferenceTree ref)

Creates a new ValueTree object, to represent a {@value } tag.

Parameters
ref:ReferenceTree

a reference to the value

Returns:ValueTree

a ValueTree object

newValueTreeback to summary
public default ValueTree newValueTree(TextTree format, ReferenceTree ref)

Creates a new ValueTree object, to represent a {@value } tag.

Implementation Specification

This implementation calls newValueTree(ref).

Parameters
format:TextTree

a format string for the value

ref:ReferenceTree

a reference to the value

Returns:ValueTree

a ValueTree object

Since
20
newVersionTreeback to summary
public VersionTree newVersionTree(List<? extends DocTree> text)

Creates a new VersionTree object, to represent a {@version } tag.

Parameters
text:List<? extends DocTree>

the content of the tag

Returns:VersionTree

a VersionTree object