com.puppycrawl.tools.checkstyle.api
Enum JavadocTagInfo

java.lang.Object
  java.lang.Enum<JavadocTagInfo>
      com.puppycrawl.tools.checkstyle.api.JavadocTagInfo

All Implemented Interfaces:

Serializable, Comparable<JavadocTagInfo>

public enum JavadocTagInfo
extends Enum<JavadocTagInfo>

This enum defines the various Javadoc tags and there properties.

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.).

Author:

Travis Schneeberger

Nested Class Summary

static class

JavadocTagInfo.Type The Javadoc Type.

Enum Constant Summary

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.

Method Summary

static JavadocTagInfo	fromName(String aName) returns a JavadocTag from the tag name.
static JavadocTagInfo	fromText(String aText) 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.
boolean	isValidInOverviewHtml() Checks if tag is valid in a overview.html Javadoc file.
boolean	isValidInPackageHtml() Checks if tag is valid in a package.html Javadoc file.
static boolean	isValidName(String aName) Returns whether the provided name is for a valid tag.
abstract boolean	isValidOn(DetailAST aAST) 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.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

AUTHOR

public static final JavadocTagInfo AUTHOR

@author.

CODE

public static final JavadocTagInfo CODE

{@code}.

DOC_ROOT

public static final JavadocTagInfo DOC_ROOT

{@docRoot}.

DEPRECATED

public static final JavadocTagInfo DEPRECATED

@deprecated.

EXCEPTION

public static final JavadocTagInfo EXCEPTION

@exception.

INHERIT_DOC

public static final JavadocTagInfo INHERIT_DOC

{@inheritDoc}.

LINK

public static final JavadocTagInfo LINK

{@link}.

LINKPLAIN

public static final JavadocTagInfo LINKPLAIN

{@linkplain}.

LITERAL

public static final JavadocTagInfo LITERAL

{@literal}.

PARAM

public static final JavadocTagInfo PARAM

@param.

RETURN

public static final JavadocTagInfo RETURN

@return.

SEE

public static final JavadocTagInfo SEE

@see.

SERIAL

public static final JavadocTagInfo SERIAL

@serial.

SERIAL_DATA

public static final JavadocTagInfo SERIAL_DATA

@serialData.

SERIAL_FIELD

public static final JavadocTagInfo SERIAL_FIELD

@serialField.

SINCE

public static final JavadocTagInfo SINCE

@since.

THROWS

public static final JavadocTagInfo THROWS

@throws.

VALUE

public static final JavadocTagInfo VALUE

{@value}.

VERSION

public static final JavadocTagInfo VERSION

@version.

Method Detail

values

public static JavadocTagInfo[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (JavadocTagInfo c : JavadocTagInfo.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static JavadocTagInfo valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

isValidOn

public abstract boolean isValidOn(DetailAST aAST)

Checks if a particular Javadoc tag is valid within a Javadoc block of a given AST.

For example: Given a call to JavadocTag.RETURNisValidOn(DetailAST).

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.

Parameters:

aAST - the AST representing a type that can be Javadoc'd

Returns:

true if tag is valid.

isValidInPackageHtml

public boolean isValidInPackageHtml()

Checks if tag is valid in a package.html Javadoc file.

Returns:

true if tag is valid.

isValidInOverviewHtml

public boolean isValidInOverviewHtml()

Checks if tag is valid in a overview.html Javadoc file.

Returns:

true if tag is valid.

getText

public String getText()

Gets the tag text.

Returns:

the tag text

getName

public String getName()

Gets the tag name.

Returns:

the tag name

getType

public JavadocTagInfo.Type getType()

Gets the Tag type defined by Type.

Returns:

the Tag type

fromText

public static JavadocTagInfo fromText(String aText)

returns a JavadocTag from the tag text.

Parameters:

aText - String representing the tag text

Returns:

Returns a JavadocTag type from a String representing the tag

Throws:

NullPointerException - if the text is null

IllegalArgumentException - if the text is not a valid tag

fromName

public static JavadocTagInfo fromName(String aName)

returns a JavadocTag from the tag name.

Parameters:

aName - String name of the tag

Returns:

Returns a JavadocTag type from a String representing the tag

Throws:

NullPointerException - if the text is null

IllegalArgumentException - if the text is not a valid tag. The name can be checked using isValidName(String)

isValidName

public static boolean isValidName(String aName)

Returns whether the provided name is for a valid tag.

Parameters:

aName - the tag name to check.

Returns:

whether the provided name is for a valid tag.

toString

public String toString()

Overrides:

toString in class Enum<JavadocTagInfo>