public enum JavadocTagInfo extends Enum<JavadocTagInfo>
This class was modeled after documentation located at javadoc and how to write.
Some of this documentation was a little incomplete (ex: valid placement of code, value, and literal tags).
Whenever an inconsistency was found the author's judgment was used.
For now, the number of required/optional tag arguments are not included
because some Javadoc tags have very complex rules for determining this
(ex: {@value}
tag).
Also, the isValidOn
method does not consider
classes defined in a local code block (method, init block, etc.).
Modifier and Type | Class and Description |
---|---|
static class |
JavadocTagInfo.Type
The Javadoc Type.
|
Enum Constant and Description |
---|
AUTHOR
@author . |
CODE
{@code} . |
DEPRECATED
@deprecated . |
DOC_ROOT
{@docRoot} . |
EXCEPTION
@exception . |
INHERIT_DOC
{@inheritDoc} . |
LINK
{@link} . |
LINKPLAIN
{@linkplain} . |
LITERAL
{@literal} . |
PARAM
@param . |
RETURN
@return . |
SEE
@see . |
SERIAL
@serial . |
SERIAL_DATA
@serialData . |
SERIAL_FIELD
@serialField . |
SINCE
@since . |
THROWS
@throws . |
VALUE
{@value} . |
VERSION
@version . |
Modifier and Type | Method and Description |
---|---|
static JavadocTagInfo |
fromName(String name)
Returns a JavadocTag from the tag name.
|
static JavadocTagInfo |
fromText(String text)
Returns a JavadocTag from the tag text.
|
String |
getName()
Gets the tag name.
|
String |
getText()
Gets the tag text.
|
JavadocTagInfo.Type |
getType()
Gets the Tag type defined by
Type . |
static boolean |
isValidName(String name)
Returns whether the provided name is for a valid tag.
|
abstract boolean |
isValidOn(DetailAST ast)
Checks if a particular Javadoc tag is valid within a Javadoc block of a
given AST.
|
String |
toString() |
static JavadocTagInfo |
valueOf(String name)
Returns the enum constant of this type with the specified name.
|
static JavadocTagInfo[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final JavadocTagInfo AUTHOR
@author
.public static final JavadocTagInfo CODE
{@code}
.public static final JavadocTagInfo DOC_ROOT
{@docRoot}
.public static final JavadocTagInfo DEPRECATED
@deprecated
.public static final JavadocTagInfo EXCEPTION
@exception
.public static final JavadocTagInfo INHERIT_DOC
{@inheritDoc}
.public static final JavadocTagInfo LINK
{@link}
.public static final JavadocTagInfo LINKPLAIN
{@linkplain}
.public static final JavadocTagInfo LITERAL
{@literal}
.public static final JavadocTagInfo PARAM
@param
.public static final JavadocTagInfo RETURN
@return
.public static final JavadocTagInfo SEE
@see
.public static final JavadocTagInfo SERIAL
@serial
.public static final JavadocTagInfo SERIAL_DATA
@serialData
.public static final JavadocTagInfo SERIAL_FIELD
@serialField
.public static final JavadocTagInfo SINCE
@since
.public static final JavadocTagInfo THROWS
@throws
.public static final JavadocTagInfo VALUE
{@value}
.public static final JavadocTagInfo VERSION
@version
.public static JavadocTagInfo[] values()
for (JavadocTagInfo c : JavadocTagInfo.values()) System.out.println(c);
public static JavadocTagInfo valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is nullpublic abstract boolean isValidOn(DetailAST ast)
If passing in a DetailAST representing a non-void METHOD_DEF
true
would be returned. If passing in a DetailAST
representing a CLASS_DEF false
would be returned because
CLASS_DEF's cannot return a value.
ast
- the AST representing a type that can be Javadoc'dpublic JavadocTagInfo.Type getType()
Type
.public static JavadocTagInfo fromText(String text)
text
- String representing the tag textNullPointerException
- if the text is nullIllegalArgumentException
- if the text is not a valid tagpublic static JavadocTagInfo fromName(String name)
name
- String name of the tagNullPointerException
- if the text is nullIllegalArgumentException
- if the text is not a valid tag. The name
can be checked using isValidName(String)
public static boolean isValidName(String name)
name
- the tag name to check.public String toString()
toString
in class Enum<JavadocTagInfo>
Copyright © 2001–2018. All rights reserved.