Class JavadocCommentsTokenTypes
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intAt-sign@that starts a block tag.static final intValue assigned to an attribute.static final int@authorJavadoc block tag.static final int{@code}Javadoc inline tag.static final intColon symbol:.static final intComma symbol,.static final int@customBlockJavadoc block tag.static final intCustom or unrecognized inline tag.static final int@deprecatedblock tag.static final intDescription part of a Javadoc tag.static final intEquals sign=.static final int@exceptionJavadoc block tag.static final intextendskeyword inside type arguments of a Javadoc inline tag.static final intField type reference.static final intFormat specifier inside Javadoc content.static final intGreater-than symbol>.static final intHash symbol#used in references.static final int@hiddenJavadoc block tag.static final intHTML_ATTRIBUTESingle HTML attribute.static final intHTML_ATTRIBUTESrepresents a collection of HTML attributes inside an HTML tag.static final intStart of an HTML comment node.static final intHTML_COMMENT_CONTENTContent inside an HTML comment.static final intClosing part of an HTML comment.static final intHTML_COMMENT_STARTrepresents the beginning of an HTML comment, i.e., the "<!--" sequence inside a Javadoc comment.static final intContent inside an HTML element.static final intGeneral HTML element.static final intEnd of an HTML tag (the closing tag node).static final intStart of an HTML tag (the opening tag node).static final intIdentifier token.static final int{@index}inline tag.static final intTerm used in{@index}tag.static final int{@inheritDoc}inline tag.static final intGeneral block tag (e.g.static final intRoot node of any Javadoc comment.static final intGeneral inline tag (e.g.static final intEnd of an inline tag}.static final intStart of an inline tag{.static final intLeading asterisk used to format Javadoc lines.static final int{@link}Javadoc inline tag.static final int{@linkplain}Javadoc inline tag.static final int{@literal}inline tag.static final intLeft parenthesis(.static final intLess-than symbol<.static final intMEMBER_REFERENCEMember reference (method or field).static final intNewline character in a Javadoc comment.static final int@paramJavadoc block tag.static final intParameter name reference.static final intPARAMETER_TYPEParameter type reference.static final intPARAMETER_TYPE_LISTrepresents the list of parameter types inside a member reference within a Javadoc inline@linktag.static final int@providesblock tag.static final intQuestion mark symbol?.static final intREFERENCEGeneral reference within Javadoc.static final int@returnJavadoc block tag.static final intInlinereturntag inside Javadoc.static final intRight parenthesis).static final int@seeJavadoc block tag.static final int@serialblock tag.static final int@serialDatablock tag.static final int@serialFieldJavadoc block tag.static final int@sinceJavadoc block tag.static final intSlash symbol/.static final intAttribute name in a@snippet.static final intSingle snippet attribute.static final intCollection of snippet attributes.static final intBody content of a@snippet.static final int@snippetinline tag.static final intString literal inside Javadoc.static final intInline{@summary ...}tag inside Javadoc.static final intKeywordsuperin type parameters.static final int{@systemProperty}inline tag.static final intTAG_ATTR_NAMErepresents the name of an attribute inside an HTML element within a Javadoc comment.static final intTAG_CLOSErepresents the closing ">" symbol of an HTML tag.static final intTAG_NAMEName of an HTML element.static final intRepresents the opening "<" symbol of an HTML start tag.static final intTAG_SLASHrepresents the slash "/" used inside an HTML closing tag.static final int/>Self-closing tag delimiter.static final intPlain text content within a Javadoc comment.static final int@throwsJavadoc block tag.static final intSingle type argument in generics.static final intTYPE_ARGUMENTSType arguments in generics.static final int@usesJavadoc block tag.static final int{@value}Javadoc inline tag.static final int@versionJavadoc block tag.static final intVoid HTML element (self-closing). -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivateEmpty private constructor of the current class. -
Method Summary
-
Field Details
-
JAVADOC_CONTENT
Root node of any Javadoc comment.Tree for example:
JAVADOC_CONTENT -> JAVADOC_CONTENT |--LEADING_ASTERISK -> * |--NEWLINE -> \n |--LEADING_ASTERISK -> * |--NEWLINE -> \n |--LEADING_ASTERISK -> * `--NEWLINE -> \n- See Also:
-
LEADING_ASTERISK
Leading asterisk used to format Javadoc lines.Example:
/** * This is a Javadoc line. * /Tree:
--BLOCK_COMMENT_BEGIN -> /** |--COMMENT_CONTENT -> *\r\n * This is a Javadoc line.\r\n | `--JAVADOC_CONTENT -> JAVADOC_CONTENT | |--NEWLINE -> \r\n | |--LEADING_ASTERISK -> * | |--TEXT -> This is a Javadoc line. | |--NEWLINE -> \r\n | `--TEXT -> ` --BLOCK_COMMENT_END -> *- See Also:
-
NEWLINE
Newline character in a Javadoc comment.- See Also:
-
TEXT
Plain text content within a Javadoc comment.- See Also:
-
JAVADOC_BLOCK_TAG
General block tag (e.g.@param,@return).- See Also:
-
AT_SIGN
At-sign@that starts a block tag.Example:
Tree:* @author name|--LEADING_ASTERISK -> * |--TEXT -> `--JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--AUTHOR_BLOCK_TAG -> AUTHOR_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> author `--DESCRIPTION -> DESCRIPTION `--TEXT -> name- See Also:
-
AUTHOR_BLOCK_TAG
@authorJavadoc block tag.Such Javadoc tag can have one child:
Example:
Tree:* @author name.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--AUTHOR_BLOCK_TAG -> AUTHOR_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> author `--DESCRIPTION -> DESCRIPTION `--TEXT -> name.- See Also:
-
DEPRECATED_BLOCK_TAG
@deprecatedblock tag.Such Javadoc tag can have one child:
Example:
Tree:* @deprecated deprecated text.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--DEPRECATED_BLOCK_TAG -> DEPRECATED_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> deprecated `--DESCRIPTION -> DESCRIPTION `--TEXT -> deprecated text.- See Also:
-
PARAM_BLOCK_TAG
@paramJavadoc block tag.Such Javadoc tag can have two children:
Example:
Tree:* @param value The parameter of method.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--PARAM_BLOCK_TAG -> PARAM_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> param |--TEXT -> |--PARAMETER_NAME -> value `--DESCRIPTION -> DESCRIPTION `--TEXT -> The parameter of method.- See Also:
-
RETURN_BLOCK_TAG
@returnJavadoc block tag.Such Javadoc tag can have one child:
Example:
Tree:* @return The return of method.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--RETURN_BLOCK_TAG -> RETURN_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> return `--DESCRIPTION -> DESCRIPTION `--TEXT -> The return of method.- See Also:
-
THROWS_BLOCK_TAG
@throwsJavadoc block tag.Such Javadoc tag can have two children:
IDENTIFIER- the exception classDESCRIPTION- description
Example:
Tree:* @throws IOException if an I/O error occursJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--THROWS_BLOCK_TAG -> THROWS_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> throws |--TEXT -> |--IDENTIFIER -> IOException `--DESCRIPTION -> DESCRIPTION `--TEXT -> if an I/O error occurs- See Also:
-
EXCEPTION_BLOCK_TAG
@exceptionJavadoc block tag.Such Javadoc tag can have two children:
Example:
Tree:* @exception FileNotFoundException when file is not found.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--EXCEPTION_BLOCK_TAG -> EXCEPTION_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> exception |--TEXT -> |--IDENTIFIER -> FileNotFoundException `--DESCRIPTION -> DESCRIPTION `--TEXT -> when file is not found.- See Also:
-
SINCE_BLOCK_TAG
@sinceJavadoc block tag.Such Javadoc tag can have one child:
Example:
Tree:* @since 1.0JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--SINCE_BLOCK_TAG -> SINCE_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> since `--DESCRIPTION -> DESCRIPTION `--TEXT -> 1.0- See Also:
-
VERSION_BLOCK_TAG
@versionJavadoc block tag.This tag has only one argument —
TEXT:Example:
Tree:* @version valueJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--VERSION_BLOCK_TAG -> VERSION_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> version `--DESCRIPTION -> DESCRIPTION `--TEXT -> value- See Also:
-
SEE_BLOCK_TAG
@seeJavadoc block tag.Such Javadoc tag can have three children:
Example:
Tree:* @see SomeClass#FieldJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--SEE_BLOCK_TAG -> SEE_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> see |--TEXT -> `--REFERENCE -> REFERENCE |--IDENTIFIER -> SomeClass |--HASH -> # `--MEMBER_REFERENCE -> MEMBER_REFERENCE `--IDENTIFIER -> Field- See Also:
-
HIDDEN_BLOCK_TAG
@hiddenJavadoc block tag.Such Javadoc tag can have one child:
DESCRIPTION– optional description text
Example:
Tree:* @hidden valueJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--HIDDEN_BLOCK_TAG -> HIDDEN_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> hidden `--DESCRIPTION -> DESCRIPTION `--TEXT -> value- See Also:
-
USES_BLOCK_TAG
@usesJavadoc block tag.Such Javadoc tag can have one child:
IDENTIFIER– the referenced service type
Example:
Tree:* @uses com.example.app.MyServiceJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--USES_BLOCK_TAG -> USES_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> uses |--TEXT -> `--IDENTIFIER -> com.example.app.MyService- See Also:
-
PROVIDES_BLOCK_TAG
@providesblock tag.Such Javadoc tag can have two children:
Example:
Tree:* @provides com.example.MyService with com.example.MyServiceImplJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--PROVIDES_BLOCK_TAG -> PROVIDES_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> provides |--TEXT -> |--IDENTIFIER -> com.example.MyService `--DESCRIPTION -> DESCRIPTION `--TEXT -> with com.example.MyServiceImpl- See Also:
-
SERIAL_BLOCK_TAG
@serialblock tag.Such Javadoc tag can have one child:
DESCRIPTION– optional description text
Example:
Tree:* @serial includeJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--SERIAL_BLOCK_TAG -> SERIAL_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> serial `--DESCRIPTION -> DESCRIPTION `--TEXT -> include- See Also:
-
SERIAL_DATA_BLOCK_TAG
@serialDatablock tag.Such Javadoc tag can have one child:
DESCRIPTION– optional description text
Example:
Tree:* @serialData data description valueJAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--SERIAL_DATA_BLOCK_TAG -> SERIAL_DATA_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> serialData `--DESCRIPTION -> DESCRIPTION `--TEXT -> data description value- See Also:
-
SERIAL_FIELD_BLOCK_TAG
@serialFieldJavadoc block tag.Such Javadoc tag can have three children:
IDENTIFIER– field nameFIELD_TYPE– field typeDESCRIPTION– field description
Example:
Tree:* @serialField name String The person's full name.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--SERIAL_FIELD_BLOCK_TAG -> SERIAL_FIELD_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> serialField |--TEXT -> |--IDENTIFIER -> name |--TEXT -> |--FIELD_TYPE -> String `--DESCRIPTION -> DESCRIPTION `--TEXT -> The person's full name.- See Also:
-
CUSTOM_BLOCK_TAG
@customBlockJavadoc block tag.This type represents any block tag that is not explicitly recognized by Checkstyle, such as a project-specific or malformed tag.
Example:
Tree:* @mycustomtag This is a custom block tag.JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG `--CUSTOM_BLOCK_TAG -> CUSTOM_BLOCK_TAG |--AT_SIGN -> @ |--TAG_NAME -> customBlock |--TEXT -> `--DESCRIPTION -> DESCRIPTION `--TEXT -> This is a custom block tag.- See Also:
-
JAVADOC_INLINE_TAG
General inline tag (e.g.@link).- See Also:
-
JAVADOC_INLINE_TAG_START
Start of an inline tag{.- See Also:
-
JAVADOC_INLINE_TAG_END
End of an inline tag}.- See Also:
-
CODE_INLINE_TAG
{@code}Javadoc inline tag.Such Javadoc tag can have no children:
Example:
Tree:* {@code println("Hello");}`--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--CODE_INLINE_TAG -> CODE_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> code |--TEXT -> println("Hello"); `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
LINK_INLINE_TAG
{@link}Javadoc inline tag.Such Javadoc tag can have two children:
Example:
Tree:* {@link Math#max(int, int) label}--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> link |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> Math | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | |--IDENTIFIER -> max | |--LPAREN -> ( | |--PARAMETER_TYPE_LIST -> PARAMETER_TYPE_LIST | | |--PARAMETER_TYPE -> int | | |--COMMA -> , | | |--TEXT -> | | `--PARAMETER_TYPE -> int | `--RPAREN -> ) |--DESCRIPTION -> DESCRIPTION | `--TEXT -> label `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
LINKPLAIN_INLINE_TAG
{@linkplain}Javadoc inline tag.Such Javadoc tag can have two children:
Example:
Tree:* {@linkplain String#indexOf(int, int) label}--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINKPLAIN_INLINE_TAG -> LINKPLAIN_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> linkplain |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> String | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | |--IDENTIFIER -> indexOf | |--LPAREN -> ( | |--PARAMETER_TYPE_LIST -> PARAMETER_TYPE_LIST | | |--PARAMETER_TYPE -> int | | |--COMMA -> , | | |--TEXT -> | | `--PARAMETER_TYPE -> int | `--RPAREN -> ) |--DESCRIPTION -> DESCRIPTION | `--TEXT -> label `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
VALUE_INLINE_TAG
{@value}Javadoc inline tag.Such Javadoc tag can have one child:
Example:
Tree:* {@value Integer#MAX_VALUE}--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--VALUE_INLINE_TAG -> VALUE_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> value |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> Integer | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | `--IDENTIFIER -> MAX_VALUE |--TEXT -> `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
SUMMARY_INLINE_TAG
Inline{@summary ...}tag inside Javadoc.This node represents an inline
{@summary ...}tag used to provide a short summary description within a Javadoc sentence.Example:
Tree:* Example showing {@summary This is a short summary.}|--LEADING_ASTERISK -> * |--TEXT -> Example showing `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--SUMMARY_INLINE_TAG -> SUMMARY_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> summary |--DESCRIPTION -> DESCRIPTION | `--TEXT -> This is a short summary. `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
INHERIT_DOC_INLINE_TAG
{@inheritDoc}inline tag.This node models the inline
{@inheritDoc}tag that instructs Javadoc to inherit documentation from the corresponding element in a parent class or interface.Example:
Tree:* {@inheritDoc}|--LEADING_ASTERISK -> * |--TEXT -> `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--INHERIT_DOC_INLINE_TAG -> INHERIT_DOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> inheritDoc `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
SYSTEM_PROPERTY_INLINE_TAG
{@systemProperty}inline tag.- See Also:
-
LITERAL_INLINE_TAG
{@literal}inline tag.Example:
Tree:* {@literal @Override}|--LEADING_ASTERISK -> * |--TEXT -> `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LITERAL_INLINE_TAG -> LITERAL_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> literal |--TEXT -> @Override `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
RETURN_INLINE_TAG
Inlinereturntag inside Javadoc.This node represents an inline
{@return ...}tag used to describe the returned value directly within a Javadoc sentence.Example:
Tree:Example showing result {@return The computed value.}|--LEADING_ASTERISK -> * |--TEXT -> Example showing result `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--RETURN_INLINE_TAG -> RETURN_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> return |--DESCRIPTION -> DESCRIPTION | `--TEXT -> The computed value. `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
INDEX_INLINE_TAG
{@index}inline tag.This node represents an inline
{@index ...}tag used to mark an index term inside a Javadoc sentence.Example:
Tree:* Example showing {@index keyword description of the index term}.|--LEADING_ASTERISK -> * |--TEXT -> Example showing `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--INDEX_INLINE_TAG -> INDEX_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> index |--TEXT -> |--INDEX_TERM -> keyword |--DESCRIPTION -> DESCRIPTION | `--TEXT -> description of the index term `--JAVADOC_INLINE_TAG_END -> } |--TEXT -> .- See Also:
-
SNIPPET_INLINE_TAG
@snippetinline tag.This node represents an inline { @code { @snippet :}} tag used to embed code snippets directly inside a Javadoc sentence.
Example:
{ @code * Example showing { @snippet :java | System.out.println("hello"); }}Tree:|--LEADING_ASTERISK -> * |--TEXT -> Example showing `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--SNIPPET_INLINE_TAG -> SNIPPET_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--COLON -> : |--SNIPPET_BODY -> SNIPPET_BODY | |--TEXT -> java | | |--NEWLINE -> \n | |--LEADING_ASTERISK -> * | |--TEXT -> System.out.println("hello"); | |--NEWLINE -> \n | |--LEADING_ASTERISK -> * | `--TEXT -> `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
CUSTOM_INLINE_TAG
Custom or unrecognized inline tag.- See Also:
-
IDENTIFIER
Identifier token.- See Also:
-
HASH
Hash symbol#used in references.- See Also:
-
LPAREN
Left parenthesis(.- See Also:
-
RPAREN
Right parenthesis).- See Also:
-
COMMA
Comma symbol,.- See Also:
-
SLASH
Slash symbol/.- See Also:
-
QUESTION
Question mark symbol?.- See Also:
-
LT
Less-than symbol<.- See Also:
-
GT
Greater-than symbol>.- See Also:
-
EXTENDS
extendskeyword inside type arguments of a Javadoc inline tag.This node represents the
extendsbound used inside a parameterized type within an inline Javadoc tag.Example:
Tree:* {@link java.util.List<? extends Number> list of any subtype of Number}|--LEADING_ASTERISK -> * |--TEXT -> |--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { @ |--TAG_NAME -> link |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> java.util.List | `--TYPE_ARGUMENTS -> TYPE_ARGUMENTS | |--LT -> < | |--TYPE_ARGUMENT -> TYPE_ARGUMENT | | |--QUESTION -> ? | | |--TEXT -> | | |--EXTENDS -> extends | | |--TEXT -> | | `--IDENTIFIER -> Number | `--GT -> > |--DESCRIPTION -> DESCRIPTION | `--TEXT -> list of any subtype of Number `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
SUPER
Keywordsuperin type parameters.- See Also:
-
PARAMETER_TYPE
PARAMETER_TYPEParameter type reference.Represents a type used in a method parameter.
Example:
Tree:{@link java.util.List#add(Object)}JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> {@ |--TAG_NAME -> link |--REFERENCE -> REFERENCE | |--IDENTIFIER -> List | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | |--IDENTIFIER -> add | |--LPAREN -> ( | |--PARAMETER_TYPE_LIST -> PARAMETER_TYPE_LIST | | `--PARAMETER_TYPE -> Object | `--RPAREN -> ) `--JAVADOC_INLINE_TAG_END ->}- See Also:
-
REFERENCE
REFERENCEGeneral reference within Javadoc.Represents the target of an inline reference tag such as
{@link String#length()}.Example:
Tree:{@link String#length()}JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--LINK_INLINE_TAG -> LINK_INLINE_TAG | |--JAVADOC_INLINE_TAG_START -> {@ | |--TAG_NAME -> link | `--REFERENCE -> String#length()- See Also:
-
MEMBER_REFERENCE
MEMBER_REFERENCEMember reference (method or field).Represents a field or method in a type reference.
Example:
{@link String#length()}Tree:
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> {@ |--TAG_NAME -> link |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> String | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | |--IDENTIFIER -> length | |--LPAREN -> ( | `--RPAREN -> ) `--JAVADOC_INLINE_TAG_END ->}- See Also:
-
PARAMETER_TYPE_LIST
PARAMETER_TYPE_LISTrepresents the list of parameter types inside a member reference within a Javadoc inline@linktag.Example:
{@link Math#max(int, int)}Tree:
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> {\@ |--TAG_NAME -> link |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> Math | |--HASH -> # | `--MEMBER_REFERENCE -> MEMBER_REFERENCE | |--IDENTIFIER -> max | |--LPAREN -> ( | |--PARAMETER_TYPE_LIST -> PARAMETER_TYPE_LIST | | |--PARAMETER_TYPE -> int | | |--COMMA -> , | | |--TEXT -> | | `--PARAMETER_TYPE -> int | `--RPAREN -> ) `--JAVADOC_INLINE_TAG_END -> }- See Also:
-
TYPE_ARGUMENTS
TYPE_ARGUMENTSType arguments in generics.Represents the type arguments inside a generic type reference.
Example:
{@link java.util.List<String>}Tree:
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG `--LINK_INLINE_TAG -> LINK_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> {@ |--TAG_NAME -> link |--TEXT -> |--REFERENCE -> REFERENCE | |--IDENTIFIER -> java.util.List | `--TYPE_ARGUMENTS -> TYPE_ARGUMENTS | |--LT -> < | |--TYPE_ARGUMENT -> TYPE_ARGUMENT | | `--IDENTIFIER -> String | `--GT -> > `--JAVADOC_INLINE_TAG_END ->}- See Also:
-
TYPE_ARGUMENT
Single type argument in generics.- See Also:
-
DESCRIPTION
Description part of a Javadoc tag.- See Also:
-
FORMAT_SPECIFIER
Format specifier inside Javadoc content.- See Also:
-
SNIPPET_ATTR_NAME
Attribute name in a@snippet.- See Also:
-
EQUALS
Equals sign=.- See Also:
-
ATTRIBUTE_VALUE
Value assigned to an attribute.- See Also:
-
COLON
Colon symbol:.- See Also:
-
INDEX_TERM
Term used in{@index}tag.- See Also:
-
SNIPPET_ATTRIBUTE
Single snippet attribute.- See Also:
-
SNIPPET_ATTRIBUTES
Collection of snippet attributes.- See Also:
-
SNIPPET_BODY
Body content of a@snippet.- See Also:
-
FIELD_TYPE
Field type reference.- See Also:
-
PARAMETER_NAME
Parameter name reference.- See Also:
-
STRING_LITERAL
String literal inside Javadoc.- See Also:
-
HTML_ELEMENT
General HTML element.- See Also:
-
VOID_ELEMENT
Void HTML element (self-closing).- See Also:
-
HTML_CONTENT
Content inside an HTML element.This node represents the textual content between an HTML start tag and the corresponding end tag inside a Javadoc comment.
Example:
Tree:* <a href="https://example.com">link</a>|--LEADING_ASTERISK -> * `--HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> a | |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TEXT -> (whitespace) | | |--TAG_ATTR_NAME -> href | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "https://example.com" | `--TAG_CLOSE -> > |--HTML_CONTENT -> HTML_CONTENT | `--TEXT -> link `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> a `--TAG_CLOSE -> >- See Also:
-
HTML_ATTRIBUTE
HTML_ATTRIBUTESingle HTML attribute.Represents one attribute inside an HTML tag.
Example:
Tree:<input type="text">HTML_ELEMENT -> HTML_ELEMENT `--VOID_ELEMENT -> VOID_ELEMENT `--HTML_TAG_START -> HTML_TAG_START |--TAG_OPEN -> < |--TAG_NAME -> input |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | |--TEXT -> | |--TAG_ATTR_NAME -> type | |--EQUALS -> = | `--ATTRIBUTE_VALUE -> "text" `--TAG_CLOSE -> >- See Also:
-
HTML_ATTRIBUTES
HTML_ATTRIBUTESrepresents a collection of HTML attributes inside an HTML tag.Appears in Javadoc comments when documenting HTML elements that contain multiple attributes.
Example:
<div lang="en" custom-attr="value"></div>Tree:
HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> div | |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | | |--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | | |--TEXT -> | | | |--TAG_ATTR_NAME -> lang | | | |--EQUALS -> = | | | `--ATTRIBUTE_VALUE -> "en" | | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TEXT -> | | |--TAG_ATTR_NAME -> custom-attr | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "value" | `--TAG_CLOSE -> >- See Also:
-
HTML_TAG_START
Start of an HTML tag (the opening tag node).This node represents the opening part of an HTML element and contains the opening delimiter, tag name, optional attributes, and the closing delimiter of the opening tag.
Example:
Tree:* <a href="https://example.com">link</a>|--LEADING_ASTERISK -> * `--HTML_ELEMENT -> HTML_ELEMENT `--HTML_TAG_START -> HTML_TAG_START |--TAG_OPEN -> < |--TAG_NAME -> a |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | |--TEXT -> | |--TAG_ATTR_NAME -> href | |--EQUALS -> = | `--ATTRIBUTE_VALUE -> "https://example.com" `--TAG_CLOSE -> >- See Also:
-
HTML_TAG_END
End of an HTML tag (the closing tag node).This node represents the closing part of an HTML element and contains the closing delimiter, optional slash, and the tag name.
Example:
Tree:* <a href="https://example.com">link</a>|--LEADING_ASTERISK -> * `--HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> a | |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TEXT -> (whitespace) | | |--TAG_ATTR_NAME -> href | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "https://example.com" | `--TAG_CLOSE -> > |--HTML_CONTENT -> HTML_CONTENT | `--TEXT -> link `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> a `--TAG_CLOSE -> >- See Also:
-
TAG_OPEN
Represents the opening "<" symbol of an HTML start tag.Example:
Tree:<div class="container" lang="en"></div>HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> div | |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | | |--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | | |--TAG_ATTR_NAME -> class | | | |--EQUALS -> = | | | `--ATTRIBUTE_VALUE -> "container" | | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TAG_ATTR_NAME -> lang | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "en" | `--TAG_CLOSE -> > `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> div `--TAG_CLOSE -> >- See Also:
-
TAG_NAME
TAG_NAMEName of an HTML element.Appears inside an HTML tag within Javadoc comments.
Example:
Tree:<div class="container"> Content </div>HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> div | |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TAG_ATTR_NAME -> class | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "container" | `--TAG_CLOSE -> > |--HTML_CONTENT -> HTML_CONTENT | `--TEXT -> Content `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> div `--TAG_CLOSE -> >Here
TAG_NAMEcorresponds to"div".- See Also:
-
TAG_CLOSE
TAG_CLOSErepresents the closing ">" symbol of an HTML tag.Appears in Javadoc comments when documenting HTML elements.
Example:
Tree:<p>Some text</p>HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> p | `--TAG_CLOSE -> > |--HTML_CONTENT -> HTML_CONTENT | `--TEXT -> Some text `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> p `--TAG_CLOSE -> >- See Also:
-
TAG_SLASH_CLOSE
/>Self-closing tag delimiter.Used for void HTML elements.
Example:
Tree:* <br />VOID_ELEMENT -> VOID_ELEMENT |--TAG_OPEN -> < |--TAG_NAME -> br `--TAG_SLASH_CLOSE -> />- See Also:
-
TAG_SLASH
TAG_SLASHrepresents the slash "/" used inside an HTML closing tag.Appears in Javadoc comments when closing HTML elements.
Example:
Tree:<p>Paragraph text</p>HTML_ELEMENT -> HTML_ELEMENT |--HTML_TAG_START -> HTML_TAG_START | |--TAG_OPEN -> < | |--TAG_NAME -> p | `--TAG_CLOSE -> > |--HTML_CONTENT -> HTML_CONTENT | `--TEXT -> Paragraph text `--HTML_TAG_END -> HTML_TAG_END |--TAG_OPEN -> < |--TAG_SLASH -> / |--TAG_NAME -> p `--TAG_CLOSE -> >- See Also:
-
TAG_ATTR_NAME
TAG_ATTR_NAMErepresents the name of an attribute inside an HTML element within a Javadoc comment.Example:
<img src="logo.png" alt="Site logo">Tree:
HTML_ELEMENT -> HTML_ELEMENT `--VOID_ELEMENT -> VOID_ELEMENT `--HTML_TAG_START -> HTML_TAG_START |--TAG_OPEN -> < |--TAG_NAME -> img |--HTML_ATTRIBUTES -> HTML_ATTRIBUTES | |--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | | |--TEXT -> | | |--TAG_ATTR_NAME -> src | | |--EQUALS -> = | | `--ATTRIBUTE_VALUE -> "logo.png" | `--HTML_ATTRIBUTE -> HTML_ATTRIBUTE | |--TEXT -> | |--TAG_ATTR_NAME -> alt | |--EQUALS -> = | `--ATTRIBUTE_VALUE -> "Site logo" `--TAG_CLOSE -> >- See Also:
-
HTML_COMMENT
Start of an HTML comment node.This node represents a full HTML comment inside Javadoc.
This node has three children:
Example:
Tree:* <!-- Hello World! -->JAVADOC_CONTENT -> JAVADOC_CONTENT |--TEXT -> /** |--NEWLINE -> \r\n |--LEADING_ASTERISK -> * |--TEXT -> |--HTML_COMMENT -> HTML_COMMENT |--HTML_COMMENT_START -> <!-- |--HTML_COMMENT_CONTENT -> HTML_COMMENT_CONTENT | `--TEXT -> Hello World! `--HTML_COMMENT_END -> --> |--NEWLINE -> \r\n |--LEADING_ASTERISK -> * |--TEXT -> /- See Also:
-
HTML_COMMENT_START
HTML_COMMENT_STARTrepresents the beginning of an HTML comment, i.e., the "<!--" sequence inside a Javadoc comment.HTML comments occasionally appear in Javadoc to add internal notes or explanations without affecting the rendered output.
Example:<!-- Note: This method is for demonstration purposes only. -->Tree:
HTML_COMMENT -> HTML_COMMENT |--HTML_COMMENT_START -> <!-- |--HTML_COMMENT_CONTENT -> HTML_COMMENT_CONTENT | `--TEXT -> Note: This method is for demonstration purposes only. `--HTML_COMMENT_END -> -->- See Also:
-
HTML_COMMENT_END
Closing part of an HTML comment.This node represents the closing delimiter of an HTML comment in Javadoc (for example
-->).Example:
Tree:* <!-- hidden comment -->|--LEADING_ASTERISK -> * |--TEXT -> |--HTML_COMMENT -> HTML_COMMENT | |--HTML_COMMENT_START -> <!-- | |--HTML_COMMENT_CONTENT -> HTML_COMMENT_CONTENT | | `--TEXT -> hidden comment | `--HTML_COMMENT_END -> -->- See Also:
-
HTML_COMMENT_CONTENT
HTML_COMMENT_CONTENTContent inside an HTML comment.Text within an HTML comment.
Example:
<!-- This is a comment -->Tree:
HTML_COMMENT -> HTML_COMMENT |--HTML_COMMENT_START -> <!-- |--HTML_COMMENT_CONTENT -> HTML_COMMENT_CONTENT | `--TEXT -> This is a comment `--HTML_COMMENT_END -> -->- See Also:
-
-
Constructor Details
-
JavadocCommentsTokenTypes
private JavadocCommentsTokenTypes()Empty private constructor of the current class.
-