Class JavadocTokenTypes
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Area tag name.static final int
Area html tag.static final int
Argument definition inPARAMETERS
part ofREFERENCE
.static final int
Attribute value html tag component.static final int
Html tag attribute.static final int
'@author' literal in@author
Javadoc tag.static final int
Base tag name.static final int
Base html tag.static final int
Basefont tag name.static final int
Basefont html tag.static final int
Body html tag.static final int
Body tag name.static final int
End body tag.static final int
Start body tag.static final int
Br tag name.static final int
Br html tag.static final int
Any other symbol.static final int
Exception class name.static final int
'@code' literal in {@code} Javadoc inline tag.static final int
Col tag name.static final int
Col html tag.static final int
Colgroup html tag.static final int
Colgroup tag name.static final int
End colgroup tag.static final int
Start colgroup tag.static final int
Comma separator between parameters inPARAMETERS
part ofREFERENCE
.static final int
Name of custom Javadoc tag (or Javadoc inline tag).static final int
Description of a term html tag:<dd></dd>
.static final int
Description of a term tag name.static final int
End description of a term tag.static final int
Start description of a term tag.static final int
'@deprecated' literal in @deprecated Javadoc tag.static final int
Description node.static final int
'@docRoot' literal in {@docRoot} Javadoc inline tag.static final int
Description term html tag:<dt></dt>
.static final int
Description term tag name.static final int
End description term tag.static final int
Start description term tag.static final int
"embed" tag name.static final int
HTML void element<embed>
.static final int
Non-special empty html tag.static final int
End html tag component:'>'
.static final int
End Of File symbol.static final int
Equals html tag component:'='
.static final int
'@exception' literal in@exception
Javadoc tag.static final int
Field name.static final int
Field type.static final int
Frame tag name.static final int
Frame html tag.static final int
Hash character inREFERENCE
.static final int
Head html tag.static final int
Head tag name.static final int
End head tag.static final int
Start head tag.static final int
Hr tag name.static final int
Hr html tag.static final int
Html html tag.static final int
Html comment:<!-- -->
.static final int
HTML comment end symbol '-->'.static final int
HTML comment start symbol '<!--'.static final int
Parent node for all html tags.static final int
End html tag: <XXXX>.static final int
Start html tag: <XXXX>.static final int
Html tag name.static final int
Non-special HTML tag.static final int
End html tag.static final int
Identifier inside HTML tag: tag name or attribute name.static final int
Start html tag.static final int
Img tag name.static final int
Img html tag.static final int
'@inheritDoc' literal in {@inheritDoc} Javadoc inline tag.static final int
Input tag name.static final int
Input html tag.static final int
Isindex tag name.static final int
Isindex html tag.static final int
Root node of any Javadoc comment.static final int
Javadoc inline tag.static final int
Last child ofJAVADOC_INLINE_TAG
that represents right curly brace '}'.static final int
First child ofJAVADOC_INLINE_TAG
that represents left curly brace '{'.static final int
Javadoc tag.static final int
"keygen" tag name.static final int
HTML void element<keygen>
.static final int
Leading asterisk.static final int
Left brace inPARAMETERS
part ofREFERENCE
.static final int
List item html tag:<li></li>
.static final int
List item tag name.static final int
End list item tag.static final int
Start list item tag.static final int
Link tag name.static final int
'@link' literal in {@link} Javadoc inline tag.static final int
Link html tag.static final int
'@linkplain' literal in {@linkplain} Javadoc inline tag.static final int
'exclude' literal.static final int
'include' literal.static final int
'@literal' literal in {@literal} Javadoc inline tag.static final int
A class member inREFERENCE
.static final int
Meta tag name.static final int
Meta html tag.static final int
Newline symbol - '\n'.static final int
`optgroup` html tag.static final int
`optgroup` tag name.static final int
`optgroup` tag end.static final int
`optgroup` tag start.static final int
Option html tag.static final int
Option tag name.static final int
End option tag.static final int
Start option tag.static final int
Paragraph tag name.static final int
End paragraph tag.static final int
Start paragraph tag.static final int
PACKAGE_CLASS represents the package or class which has been referenced in the `@see`, `@link`, `@linkplain` or `@value` javadoc tags.static final int
Paragraph html tag:<p></p>
.static final int
Param tag name.static final int
'@param' literal in@param
Javadoc tag.static final int
Param html tag.static final int
First argument in@param
Javadoc tag.static final int
Parameters part inREFERENCE
.static final int
`rb` html tag.static final int
`rb` tag name.static final int
`rb` tag end.static final int
`rb` tag start.static final int
Parameter of the Javadoc tags listed below.static final int
'@return' literal in@return
Javadoc tag.static final int
Right brace inPARAMETERS
part ofREFERENCE
.static final int
`rp` html tag.static final int
`rp` tag name.static final int
`rp` tag end.static final int
`rp` tag start.static final int
`rt` html tag.static final int
`rt` tag name.static final int
`rt` tag end.static final int
`rt` tag start.static final int
`rtc` html tag.static final int
`rtc` tag name.static final int
`rtc` tag end.static final int
`rtc` tag start.private static final int
Rule types offset.static final int
'@see' literal in@see
Javadoc tag.static final int
'@serialData' literal in@serialData
Javadoc tag.static final int
'@serialField' literal in@serialField
Javadoc tag.static final int
'@serial' literal in@serial
Javadoc tag.static final int
'@since' literal in@since
Javadoc tag.static final int
Parent node for all singleton html tags.static final int
Slash html tag component:'/'
.static final int
Slash close html tag component:'/>'
.static final int
"source" tag name.static final int
HTML void element<source>
.static final int
Start html tag component:'<'
.static final int
Quoted text.static final int
Table body html tag.static final int
Table body tag name.static final int
End table body tag.static final int
Start table body tag.static final int
Table cell html tag:<td></td>
.static final int
Table cell tag name.static final int
End table cell tag.static final int
Start table cell tag.static final int
CHAR and WS sequence.static final int
Table foot html tag.static final int
Table foot tag name.static final int
End table foot tag.static final int
Start table foot tag.static final int
Table header cell html tag:<th></th>
.static final int
Table header cell tag name.static final int
End table header cell tag.static final int
Start table header cell tag.static final int
Table head html tag.static final int
Table head tag name.static final int
End table head tag.static final int
Start table head tag.static final int
'@throws' literal in@throws
Javadoc tag.static final int
Table row html tag.static final int
Table row tag name.static final int
End table row tag.static final int
Start table row tag.static final int
"track" tag name.static final int
HTML void element<track>
.static final int
'@value' literal in {@value} Javadoc inline tag.static final int
'@version' literal in@version
Javadoc tag.static final int
"wbr" tag name.static final int
HTML void element<wbr>
.static final int
Whitespace or tab ('\t') symbol. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivate
Empty private constructor of the current class. -
Method Summary
-
Field Details
-
RETURN_LITERAL
'@return' literal in@return
Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@return true if file exists
JAVADOC_TAG -> JAVADOC_TAG |--RETURN_LITERAL -> @return |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> true if file exists
- See Also:
-
DEPRECATED_LITERAL
'@deprecated' literal in @deprecated Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@deprecated It is deprecated method
JAVADOC_TAG -> JAVADOC_TAG |--DEPRECATED_LITERAL -> @deprecated |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> It is deprecated method
- See Also:
-
SINCE_LITERAL
'@since' literal in@since
Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@since 3.4 RELEASE
JAVADOC_TAG -> JAVADOC_TAG |--SINCE_LITERAL -> @since |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> 3.4 RELEASE
- See Also:
-
SERIAL_DATA_LITERAL
'@serialData' literal in@serialData
Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@serialData Two values of Integer type
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_DATA_LITERAL -> @serialData |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> Two values of Integer type
- See Also:
-
SERIAL_FIELD_LITERAL
'@serialField' literal in@serialField
Javadoc tag.Such Javadoc tag can have three arguments:
Example:
Tree:@serialField counter Integer objects counter
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_FIELD_LITERAL -> @serialField |--WS -> |--FIELD_NAME -> counter |--WS -> |--FIELD_TYPE -> Integer |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> objects counter
- See Also:
-
PARAM_LITERAL
'@param' literal in@param
Javadoc tag.Such Javadoc tag can have two arguments:
Example:
Tree:@param value The parameter of method.
JAVADOC_TAG -> JAVADOC_TAG |--PARAM_LITERAL -> @param |--WS -> |--PARAMETER_NAME -> value |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> The parameter of method.
- See Also:
-
SEE_LITERAL
'@see' literal in@see
Javadoc tag.Such Javadoc tag can have one argument -
REFERENCE
Example:
Tree:@see org.apache.utils.Lists.Comparator#compare(Object)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE |--PACKAGE_CLASS -> org.apache.utils.Lists.Comparator |--HASH -> # |--MEMBER -> compare `--PARAMETERS -> PARAMETERS |--LEFT_BRACE -> ( |--ARGUMENT -> Object `--RIGHT_BRACE -> )
- See Also:
-
SERIAL_LITERAL
'@serial' literal in@serial
Javadoc tag.Such Javadoc tag can have one argument -
REFERENCE
orLITERAL_EXCLUDE
orLITERAL_INCLUDE
Example:
Tree:@serial include
|--JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_LITERAL -> @serial |--WS |--LITERAL_INCLUDE -> include
Example:
Tree:@serial serialized company name
|--JAVADOC_TAG-> JAVADOC_TAG |--SERIAL_LITERAL -> @serial |--WS |--DESCRIPTION -> DESCRIPTION |--TEXT -> serialized company name
- See Also:
-
VERSION_LITERAL
'@version' literal in@version
Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@version 1.3
JAVADOC_TAG -> JAVADOC_TAG |--VERSION_LITERAL -> @version |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> 1.3
- See Also:
-
EXCEPTION_LITERAL
'@exception' literal in@exception
Javadoc tag.Such Javadoc tag can have two argument -
CLASS_NAME
andDESCRIPTION
Example:
Tree:@exception SQLException if query is not correct
JAVADOC_TAG -> JAVADOC_TAG |--EXCEPTION_LITERAL -> @exception |--WS -> |--CLASS_NAME -> SQLException |--WS -> `--DESCRIPTION -> DESCRIPTION `--TEXT -> if query is not correct
- See Also:
-
THROWS_LITERAL
'@throws' literal in@throws
Javadoc tag.Such Javadoc tag can have two argument -
CLASS_NAME
andDESCRIPTION
Example:
Tree:@throws SQLException if query is not correct
JAVADOC_TAG -> JAVADOC_TAG |--THROWS_LITERAL -> @throws |--WS -> |--CLASS_NAME -> SQLException |--WS -> `--DESCRIPTION -> DESCRIPTION `--TEXT -> if query is not correct
- See Also:
-
AUTHOR_LITERAL
'@author' literal in@author
Javadoc tag.Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@author Baratali Izmailov
JAVADOC_TAG -> JAVADOC_TAG |--AUTHOR_LITERAL -> @author |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> Baratali Izmailov |--NEWLINE -> \r\n
- See Also:
-
CUSTOM_NAME
Name of custom Javadoc tag (or Javadoc inline tag).Such Javadoc tag can have one argument -
DESCRIPTION
Example:
Tree:@myJavadocTag some magic
JAVADOC_TAG --> JAVADOC_TAG |--CUSTOM_NAME --> @myJavadocTag |--WS --> `--DESCRIPTION --> DESCRIPTION |--TEXT --> some magic
- See Also:
-
JAVADOC_INLINE_TAG_START
First child ofJAVADOC_INLINE_TAG
that represents left curly brace '{'.Example:
Tree:{@code Comparable<E>}
JAVADOC_INLINE_TAG --> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START --> { |--CODE_LITERAL --> @code |--WS --> |--TEXT --> Comparable<E> `--JAVADOC_INLINE_TAG_END --> }
- See Also:
-
JAVADOC_INLINE_TAG_END
Last child ofJAVADOC_INLINE_TAG
that represents right curly brace '}'.Example:
Tree:{@code Comparable<E>}
JAVADOC_INLINE_TAG --> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START --> { |--CODE_LITERAL --> @code |--WS --> |--TEXT --> Comparable<E> `--JAVADOC_INLINE_TAG_END --> }
- See Also:
-
CODE_LITERAL
'@code' literal in {@code} Javadoc inline tag.Such Javadoc inline tag can have such child nodes:
Example:
Tree:{@code Comparable<E>}
JAVADOC_TAG -> JAVADOC_TAG |--CUSTOM_NAME -> @code |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> Comparable<E>
-
DOC_ROOT_LITERAL
'@docRoot' literal in {@docRoot} Javadoc inline tag.Such Javadoc inline tag does not have any arguments and can have such child nodes:
Example:
Tree:{@docRoot}
|--JAVADOC_INLINE_TAG[1x0] : [{@docRoot}] |--JAVADOC_INLINE_TAG_START[1x0] : [{] |--DOC_ROOT_LITERAL[1x1] : [@docRoot] |--JAVADOC_INLINE_TAG_END[2x0] : [}]
Example:
Tree:{@docRoot }
|--JAVADOC_INLINE_TAG[1x0] : [{@docRoot \n}] |--JAVADOC_INLINE_TAG_START[1x0] : [{] |--DOC_ROOT_LITERAL[1x1] : [@docRoot] |--WS[1x9] : [ ] |--NEWLINE[1x10] : [\n] |--JAVADOC_INLINE_TAG_END[2x0] : [}]
-
LINK_LITERAL
'@link' literal in {@link} Javadoc inline tag.Such Javadoc inline tag can have one argument -
REFERENCE
Example:
{@link org.apache.utils.Lists.Comparator#compare(Object)}
Tree:
|--JAVADOC_INLINE_TAG[1x0] : [{@link org.apache.utils.Lists.Comparator#compare(Object)}] |--JAVADOC_INLINE_TAG_START[1x0] : [{] |--LINK_LITERAL[1x1] : [@link] |--WS[1x6] : [ ] |--REFERENCE[1x7] : [org.apache.utils.Lists.Comparator#compare(Object)] |--PACKAGE_CLASS[1x7] : [org.apache.utils] |--DOT[1x23] : [.] |--CLASS[1x24] : [Lists] |--DOT[1x29] : [.] |--CLASS[1x30] : [Comparator] |--HASH[1x40] : [#] |--MEMBER[1x41] : [compare] |--PARAMETERS[1x48] : [(Object)] |--LEFT_BRACE[1x48] : [(] |--ARGUMENT[1x49] : [Object] |--RIGHT_BRACE[1x55] : [)] |--JAVADOC_INLINE_TAG_END[1x56] : [}]
-
INHERIT_DOC_LITERAL
'@inheritDoc' literal in {@inheritDoc} Javadoc inline tag.Such Javadoc inline tag does not have any arguments and can have such child nodes:
Example:
Tree:{@inheritDoc}
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { |--INHERIT_DOC_LITERAL -> @inheritDoc |--JAVADOC_INLINE_TAG_END -> }
-
LINKPLAIN_LITERAL
'@linkplain' literal in {@linkplain} Javadoc inline tag.Such Javadoc inline tag can have one argument -
REFERENCE
Example:
Tree:{@linkplain org.apache.utils.Lists.Comparator#compare(Object) compare}
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { |--LINKPLAIN_LITERAL -> @linkplain |--WS -> |--REFERENCE -> org.apache.utils.Lists.Comparator#compare(Object) |--PACKAGE_CLASS -> org.apache.utils |--DOT -> . |--CLASS -> Lists |--DOT -> . |--CLASS -> Comparator |--HASH -> # |--MEMBER -> compare |--PARAMETERS -> (Object) |--LEFT_BRACE -> ( |--ARGUMENT -> Object |--RIGHT_BRACE -> ) |--DESCRIPTION -> compare |--TEXT -> compare |--JAVADOC_INLINE_TAG_END -> }
-
LITERAL_LITERAL
'@literal' literal in {@literal} Javadoc inline tag.Such Javadoc inline tag can have such child nodes:
Example:
Tree:{@literal #compare(Object)}
|--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { |--LITERAL_LITERAL -> @literal |--WS -> |--TEXT -> #compare(Object) `--JAVADOC_INLINE_TAG_END -> }
-
VALUE_LITERAL
'@value' literal in {@value} Javadoc inline tag.Such Javadoc inline tag has one argument
REFERENCE
and can have such child nodes:Example:
Tree:{@value Integer#MAX_VALUE}
JAVADOC_INLINE_TAG --> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START --> { |--VALUE_LITERAL --> @value |--WS --> |--REFERENCE --> REFERENCE | |--PACKAGE_CLASS --> Integer | |--HASH --> # | `--MEMBER --> MAX_VALUE `--JAVADOC_INLINE_TAG_END --> }
-
PACKAGE_CLASS
PACKAGE_CLASS represents the package or class which has been referenced in the `@see`, `@link`, `@linkplain` or `@value` javadoc tags. In the javadoc tree it shall be a child ofREFERENCE
.
IMPORTANT: Constructs likepackage.Class.NestedClassAtDepth1.NestedClassAtDepth2#member
are recognized by the javadoc tool from oracle, and no assumptions like, package names wouldn't consist of uppercase characters or class names begin with an uppercase character, are made. Also, the reference in a javadoc tag can consist just a package name or a simple class name or even a full class name. Thus, PACKAGE_CLASS can represent a package name or a simple class name or a full class name i.e. checkstyle doesn't resolve references at present.Example:
Tree:@see org.apache.utils.Lists.Comparator#compare(Object)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE | |--PACKAGE_CLASS -> org.apache.utils.Lists.Comparator | |--HASH -> # | |--MEMBER -> compare | `--PARAMETERS -> PARAMETERS | |--LEFT_BRACE -> ( | |--ARGUMENT -> Object | `--RIGHT_BRACE -> ) |--NEWLINE -> \r\n `--WS ->
- See Also:
-
HASH
Hash character inREFERENCE
. Hash character is used before specifying a class member.Example:
Tree:@see org.apache.utils.Lists.Comparator#compare(Object)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE |--PACKAGE_CLASS -> org.apache.utils.Lists.Comparator |--HASH -> # |--MEMBER -> compare `--PARAMETERS -> PARAMETERS |--LEFT_BRACE -> ( |--ARGUMENT -> Object `--RIGHT_BRACE -> )
- See Also:
-
MEMBER
A class member inREFERENCE
. Class member is specified afterHASH
symbol.Example:
Tree:@see org.apache.utils.Lists.Comparator#compare(Object)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE |--PACKAGE_CLASS -> org.apache.utils.Lists.Comparator |--HASH -> # |--MEMBER -> compare `--PARAMETERS -> PARAMETERS |--LEFT_BRACE -> ( |--ARGUMENT -> Object `--RIGHT_BRACE -> )
- See Also:
-
LEFT_BRACE
Left brace inPARAMETERS
part ofREFERENCE
.Example:
Tree:@see #method(Processor, String)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE | |--HASH -> # | |--MEMBER -> method | `--PARAMETERS -> PARAMETERS | |--LEFT_BRACE -> ( | |--ARGUMENT -> Processor | |--COMMA -> , | |--WS -> | |--ARGUMENT -> String | `--RIGHT_BRACE -> )
- See Also:
-
RIGHT_BRACE
Right brace inPARAMETERS
part ofREFERENCE
.Example:
Tree:@see #method(Processor, String)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE | |--HASH -> # | |--MEMBER -> method | `--PARAMETERS -> PARAMETERS | |--LEFT_BRACE -> ( | |--ARGUMENT -> Processor | |--COMMA -> , | |--WS -> | |--ARGUMENT -> String | `--RIGHT_BRACE -> )
- See Also:
-
ARGUMENT
Argument definition inPARAMETERS
part ofREFERENCE
.Example:
Tree:@see #method(Processor, String)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE | |--HASH -> # | |--MEMBER -> method | `--PARAMETERS -> PARAMETERS | |--LEFT_BRACE -> ( | |--ARGUMENT -> Processor | |--COMMA -> , | |--WS -> | |--ARGUMENT -> String | `--RIGHT_BRACE -> ) `--NEWLINE -> \n
- See Also:
-
COMMA
Comma separator between parameters inPARAMETERS
part ofREFERENCE
.Example:
Tree:@see #method(Processor, String)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE | |--HASH -> # | |--MEMBER -> method | `--PARAMETERS -> PARAMETERS | |--LEFT_BRACE -> ( | |--ARGUMENT -> Processor | |--COMMA -> , | |--WS -> | |--ARGUMENT -> String | `--RIGHT_BRACE -> ) |--NEWLINE -> \r\n `--WS ->
- See Also:
-
STRING
Quoted text. One of possible@see
tag arguments.Example:
Tree:@see "Spring Framework"
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--STRING -> "Spring Framework" |--NEWLINE -> \r\n `--WS ->
- See Also:
-
CLASS_NAME
Exception class name. First argument in@throws
and@exception
Javadoc tags.Example:
Tree:@throws IOException connection problems
JAVADOC_TAG -> JAVADOC_TAG |--THROWS_LITERAL -> @throws |--WS -> |--CLASS_NAME -> IOException |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> connection problems |--NEWLINE -> \r\n `--TEXT ->
-
PARAMETER_NAME
First argument in@param
Javadoc tag.Example:
Tree:@param T The bar.
JAVADOC_TAG -> JAVADOC_TAG |--PARAM_LITERAL -> @param |--WS -> |--PARAMETER_NAME -> T |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> The bar. |--NEWLINE -> \r\n `--TEXT ->
- See Also:
-
LITERAL_EXCLUDE
'exclude' literal. One of three possible@serial
tag arguments.Example:
Tree:@serial exclude
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_LITERAL -> @serial |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> serialized company name |--NEWLINE -> \r\n `--TEXT ->
- See Also:
-
LITERAL_INCLUDE
'include' literal. One of three possible@serial
tag arguments.Example:
Tree:@serial include
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_LITERAL -> @serial |--WS -> |--LITERAL_INCLUDE -> include |--NEWLINE -> \r\n `--WS ->
- See Also:
-
FIELD_NAME
Field name. First argument of@serialField
Javadoc tag.Example:
Tree:@serialField counter Integer objects counter
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_FIELD_LITERAL -> @serialField |--WS -> |--FIELD_NAME -> counter |--WS -> |--FIELD_TYPE -> Integer |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> objects counter |--NEWLINE -> \r\n `--TEXT ->
-
FIELD_TYPE
Field type. Second argument of@serialField
Javadoc tag.Example:
Tree:@serialField counter Integer objects counter
JAVADOC_TAG -> JAVADOC_TAG |--SERIAL_FIELD_LITERAL -> @serialField |--WS -> |--FIELD_NAME -> counter |--WS -> |--FIELD_TYPE -> Integer |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> objects counter `--NEWLINE -> \n
-
HTML_TAG_NAME
Identifier inside HTML tag: tag name or attribute name.- See Also:
-
START
Start html tag component:'<'
.- See Also:
-
SLASH
Slash html tag component:'/'
.- See Also:
-
END
End html tag component:'>'
.- See Also:
-
SLASH_END
Slash close html tag component:'/>'
.- See Also:
-
EQUALS
Equals html tag component:'='
.- See Also:
-
ATTR_VALUE
Attribute value html tag component.- See Also:
-
P_HTML_TAG_NAME
Paragraph tag name.- See Also:
-
LI_HTML_TAG_NAME
List item tag name.- See Also:
-
TR_HTML_TAG_NAME
Table row tag name.- See Also:
-
TD_HTML_TAG_NAME
Table cell tag name.- See Also:
-
TH_HTML_TAG_NAME
Table header cell tag name.- See Also:
-
BODY_HTML_TAG_NAME
Body tag name.- See Also:
-
COLGROUP_HTML_TAG_NAME
Colgroup tag name.- See Also:
-
DD_HTML_TAG_NAME
Description of a term tag name.- See Also:
-
DT_HTML_TAG_NAME
Description term tag name.- See Also:
-
HEAD_HTML_TAG_NAME
Head tag name.- See Also:
-
HTML_HTML_TAG_NAME
Html tag name.- See Also:
-
OPTION_HTML_TAG_NAME
Option tag name.- See Also:
-
TBODY_HTML_TAG_NAME
Table body tag name.- See Also:
-
TFOOT_HTML_TAG_NAME
Table foot tag name.- See Also:
-
THEAD_HTML_TAG_NAME
Table head tag name.- See Also:
-
OPTGROUP_HTML_TAG_NAME
`optgroup` tag name.- See Also:
-
RB_HTML_TAG_NAME
`rb` tag name.- See Also:
-
RT_HTML_TAG_NAME
`rt` tag name.- See Also:
-
RTC_HTML_TAG_NAME
`rtc` tag name.- See Also:
-
RP_HTML_TAG_NAME
`rp` tag name.- See Also:
-
AREA_HTML_TAG_NAME
Area tag name.- See Also:
-
BASE_HTML_TAG_NAME
Base tag name.- See Also:
-
BASEFONT_HTML_TAG_NAME
Basefont tag name.- See Also:
-
BR_HTML_TAG_NAME
Br tag name.Example:
Tree:text before break < br > text after break
JAVADOC -> JAVADOC |--NEWLINE -> \r\n |--LEADING_ASTERISK -> * |--TEXT -> text before break |--HTML_ELEMENT -> HTML_ELEMENT | `--SINGLETON_ELEMENT -> SINGLETON_ELEMENT | `--BR_TAG -> BR_TAG | |--START -> -< | |--BR_HTML_TAG_NAME -> br | `--END -> > |--TEXT -> text after break |--NEWLINE -> \r\n |--TEXT ->
- See Also:
-
COL_HTML_TAG_NAME
Col tag name.- See Also:
-
FRAME_HTML_TAG_NAME
Frame tag name.- See Also:
-
HR_HTML_TAG_NAME
Hr tag name.- See Also:
-
IMG_HTML_TAG_NAME
Img tag name.- See Also:
-
INPUT_HTML_TAG_NAME
Input tag name.- See Also:
-
ISINDEX_HTML_TAG_NAME
Isindex tag name.- See Also:
-
LINK_HTML_TAG_NAME
Link tag name.- See Also:
-
META_HTML_TAG_NAME
Meta tag name.- See Also:
-
PARAM_HTML_TAG_NAME
Param tag name.- See Also:
-
EMBED_HTML_TAG_NAME
"embed" tag name.- See Also:
-
KEYGEN_HTML_TAG_NAME
"keygen" tag name.- See Also:
-
SOURCE_HTML_TAG_NAME
"source" tag name.- See Also:
-
TRACK_HTML_TAG_NAME
"track" tag name.- See Also:
-
WBR_HTML_TAG_NAME
"wbr" tag name.- See Also:
-
HTML_COMMENT_START
HTML comment start symbol '<!--'.- See Also:
-
HTML_COMMENT_END
HTML comment end symbol '-->'.- See Also:
-
LEADING_ASTERISK
Leading asterisk.- See Also:
-
NEWLINE
Newline symbol - '\n'.- See Also:
-
CHAR
Any other symbol.- See Also:
-
WS
Whitespace or tab ('\t') symbol.- See Also:
-
EOF
End Of File symbol. Copied fromRecognizer.EOF
to avoid ANTLR dependency in API.- See Also:
-
RULE_TYPES_OFFSET
Rule types offset. RULE_TYPES_OFFSET constant is used to split lexer tokens types and parser rules types. We need unique numbers for all tokens, ANTLR do not need this and that is why these types are mixed by used values. All values we can take a look at target/generated-sources/antlr/com/puppycrawl/tools/checkstyle/grammar/javadoc/JavadocParser.java For example: LEADING_ASTERISK=1 and RULE_htmlElement = 1. RULE_TYPES_OFFSET required to shift parser rules, to let them not overlap with types that have prefix "RULE_".- See Also:
-
JAVADOC
Root node of any Javadoc comment. Last child is alwaysEOF
.Tree for example:
JAVADOC[3x0] |--NEWLINE[3x0] : [\n] |--LEADING_ASTERISK[4x0] : [ *] |--WS[4x2] : [ ] |--JAVADOC_TAG[4x3] : [@param T The bar.\n ] |--PARAM_LITERAL[4x3] : [@param] |--WS[4x9] : [ ] |--PARAMETER_NAME[4x10] : [T] |--WS[4x11] : [ ] |--DESCRIPTION[4x12] : [The bar.\n ] |--TEXT[4x12] : [The bar.] |--NEWLINE[4x20] : [\n] |--TEXT[5x0] : [ ] |--EOF[5x1] : [<EOF>]
- See Also:
-
JAVADOC_TAG
Javadoc tag.Type of Javadoc tag is resolved by literal node that is first child of this node.
As literal could be:
RETURN_LITERAL
DEPRECATED_LITERAL
SINCE_LITERAL
SERIAL_DATA_LITERAL
SERIAL_FIELD_LITERAL
PARAM_LITERAL
SEE_LITERAL
SERIAL_LITERAL
VERSION_LITERAL
EXCEPTION_LITERAL
THROWS_LITERAL
AUTHOR_LITERAL
- or
CUSTOM_NAME
if it is custom Javadoc tag.
Example
Tree@param T The bar.
JAVADOC_TAG -> JAVADOC_TAG |--PARAM_LITERAL -> @param |--WS -> |--PARAMETER_NAME -> T |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> The bar. |--NEWLINE -> \r\n `--TEXT ->
- See Also:
-
JAVADOC_INLINE_TAG
Javadoc inline tag.Type of Javadoc inline tag is resolved by literal node that is second child of this node. First child is always
JAVADOC_INLINE_TAG_START
and last node is alwaysJAVADOC_INLINE_TAG_END
.As literal could be:
CODE_LITERAL
DOC_ROOT_LITERAL
LINK_LITERAL
INHERIT_DOC_LITERAL
LINKPLAIN_LITERAL
LITERAL_LITERAL
VALUE_LITERAL
- or
CUSTOM_NAME
if it is custom Javadoc inline tag.
Example:
Tree:{@link String}
JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG |--JAVADOC_INLINE_TAG_START -> { |--LINK_LITERAL -> @link |--WS -> |--REFERENCE -> REFERENCE `--PACKAGE_CLASS -> String `--JAVADOC_INLINE_TAG_END -> }
- See Also:
-
REFERENCE
Parameter of the Javadoc tags listed below.- See Also:
-
PARAMETERS
Parameters part inREFERENCE
. It is used to specify parameters formethod
. Always containsLEFT_BRACE
as first child andRIGHT_BRACE
as last child. Each parameter is represented byARGUMENT
node. Arguments in braces are separated byCOMMA
(and optionalWS
).Example:
Tree:@see #method(Processor, String)
JAVADOC_TAG -> JAVADOC_TAG |--SEE_LITERAL -> @see |--WS -> |--REFERENCE -> REFERENCE |--HASH -> # |--MEMBER -> method `--PARAMETERS -> PARAMETERS |--LEFT_BRACE -> ( |--ARGUMENT -> Processor |--COMMA -> , |--WS -> |--ARGUMENT -> String `--RIGHT_BRACE -> )
- See Also:
-
DESCRIPTION
Description node. It contains:It is argument for many Javadoc tags and inline tags.
Example:
Tree:@throws IOException if <b>connection</b> problems occur
JAVADOC_TAG -> JAVADOC_TAG |--THROWS_LITERAL -> @throws |--WS -> |--CLASS_NAME -> IOException |--WS -> `--DESCRIPTION -> DESCRIPTION |--TEXT -> if |--HTML_ELEMENT -> HTML_ELEMENT | `--HTML_TAG -> HTML_TAG | |--HTML_ELEMENT_START -> HTML_ELEMENT_START | | |--START -> < | | |--HTML_TAG_NAME -> b | | `--END -> > | |--TEXT -> connection | `--HTML_ELEMENT_END -> HTML_ELEMENT_END | |--START -> -< | |--SLASH -> / | |--HTML_TAG_NAME -> b | `--END -> -> |--TEXT -> problems occur
- See Also:
-
HTML_ELEMENT
Parent node for all html tags.- See Also:
-
HTML_ELEMENT_START
Start html tag: <XXXX>.- See Also:
-
HTML_ELEMENT_END
End html tag: <XXXX>.- See Also:
-
HTML_TAG
Non-special HTML tag.- See Also:
-
ATTRIBUTE
Html tag attribute. Parent node for:HTML_TAG_IDENT, EQUALS, ATTR_VALUE
.- See Also:
-
PARAGRAPH
Paragraph html tag:<p></p>
.- See Also:
-
P_TAG_START
Start paragraph tag.- See Also:
-
P_TAG_END
End paragraph tag.- See Also:
-
LI
List item html tag:<li></li>
.- See Also:
-
LI_TAG_START
Start list item tag.- See Also:
-
LI_TAG_END
End list item tag.- See Also:
-
TR
Table row html tag.Example:
Tree:<tr></tr>
JAVADOC -> JAVADOC |--NEWLINE -> \r\n |--LEADING_ASTERISK -> * |--TEXT -> |--HTML_ELEMENT -> HTML_ELEMENT | `--TR -> TR | |--TR_TAG_START -> TR_TAG_START | | |--START -> < | | |--TR_HTML_TAG_NAME -> tr | | `--END -> > | `--TR_TAG_END -> TR_TAG_END | |--START -> < | |--SLASH -> / | |--TR_HTML_TAG_NAME -> tr | `--END -> > |--NEWLINE -> \r\n |--TEXT ->
- See Also:
-
TR_TAG_START
Start table row tag.- See Also:
-
TR_TAG_END
End table row tag.- See Also:
-
TD
Table cell html tag:<td></td>
.- See Also:
-
TD_TAG_START
Start table cell tag.- See Also:
-
TD_TAG_END
End table cell tag.- See Also:
-
TH
Table header cell html tag:<th></th>
.- See Also:
-
TH_TAG_START
Start table header cell tag.- See Also:
-
TH_TAG_END
End table header cell tag.- See Also:
-
BODY
Body html tag.- See Also:
-
BODY_TAG_START
Start body tag.- See Also:
-
BODY_TAG_END
End body tag.- See Also:
-
COLGROUP
Colgroup html tag.- See Also:
-
COLGROUP_TAG_START
Start colgroup tag.- See Also:
-
COLGROUP_TAG_END
End colgroup tag.- See Also:
-
DD
Description of a term html tag:<dd></dd>
.- See Also:
-
DD_TAG_START
Start description of a term tag.- See Also:
-
DD_TAG_END
End description of a term tag.- See Also:
-
DT
Description term html tag:<dt></dt>
.- See Also:
-
DT_TAG_START
Start description term tag.- See Also:
-
DT_TAG_END
End description term tag.- See Also:
-
HEAD
Head html tag.- See Also:
-
HEAD_TAG_START
Start head tag.- See Also:
-
HEAD_TAG_END
End head tag.- See Also:
-
HTML
Html html tag.- See Also:
-
HTML_TAG_START
Start html tag.- See Also:
-
HTML_TAG_END
End html tag.- See Also:
-
OPTION
Option html tag.- See Also:
-
OPTION_TAG_START
Start option tag.- See Also:
-
OPTION_TAG_END
End option tag.- See Also:
-
TBODY
Table body html tag.- See Also:
-
TBODY_TAG_START
Start table body tag.- See Also:
-
TBODY_TAG_END
End table body tag.- See Also:
-
TFOOT
Table foot html tag.- See Also:
-
TFOOT_TAG_START
Start table foot tag.- See Also:
-
TFOOT_TAG_END
End table foot tag.- See Also:
-
THEAD
Table head html tag.- See Also:
-
THEAD_TAG_START
Start table head tag.- See Also:
-
THEAD_TAG_END
End table head tag.- See Also:
-
OPTGROUP
`optgroup` html tag.- See Also:
-
OPTGROUP_TAG_START
`optgroup` tag start.- See Also:
-
OPTGROUP_TAG_END
`optgroup` tag end.- See Also:
-
RB
`rb` html tag.- See Also:
-
RB_TAG_START
`rb` tag start.- See Also:
-
RB_TAG_END
`rb` tag end.- See Also:
-
RT
`rt` html tag.- See Also:
-
RT_TAG_START
`rt` tag start.- See Also:
-
RT_TAG_END
`rt` tag end.- See Also:
-
RTC
`rtc` html tag.- See Also:
-
RTC_TAG_START
`rtc` tag start.- See Also:
-
RTC_TAG_END
`rtc` tag end.- See Also:
-
RP
`rp` html tag.- See Also:
-
RP_TAG_START
`rp` tag start.- See Also:
-
RP_TAG_END
`rp` tag end.- See Also:
-
SINGLETON_ELEMENT
Parent node for all singleton html tags.- See Also:
-
EMPTY_TAG
Non-special empty html tag.- See Also:
-
AREA_TAG
Area html tag.- See Also:
-
BASE_TAG
Base html tag.- See Also:
-
BASEFONT_TAG
Basefont html tag.- See Also:
-
BR_TAG
Br html tag.- See Also:
-
COL_TAG
Col html tag.- See Also:
-
FRAME_TAG
Frame html tag.- See Also:
-
HR_TAG
Hr html tag.- See Also:
-
IMG_TAG
Img html tag.- See Also:
-
INPUT_TAG
Input html tag.- See Also:
-
ISINDEX_TAG
Isindex html tag.- See Also:
-
LINK_TAG
Link html tag.- See Also:
-
META_TAG
Meta html tag.- See Also:
-
PARAM_TAG
Param html tag.- See Also:
-
EMBED_TAG
HTML void element<embed>
.- See Also:
-
KEYGEN_TAG
HTML void element<keygen>
.- See Also:
-
SOURCE_TAG
HTML void element<source>
.- See Also:
-
TRACK_TAG
HTML void element<track>
.- See Also:
-
WBR_TAG
HTML void element<wbr>
.- See Also:
-
HTML_COMMENT
Html comment:<!-- -->
.- See Also:
-
TEXT
CHAR and WS sequence.- See Also:
-
-
Constructor Details
-
JavadocTokenTypes
private JavadocTokenTypes()Empty private constructor of the current class.
-