com.puppycrawl.tools.checkstyle.utils

Class JavadocUtil

java.lang.Object

com.puppycrawl.tools.checkstyle.utils.JavadocUtil

public final class JavadocUtil
extends java.lang.Object

Contains utility methods for working with Javadoc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JavadocUtil.JavadocTagType The type of Javadoc tag we want returned.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.regex.Pattern	NEWLINE Newline pattern.
private static java.util.regex.Pattern	RETURN Return pattern.
private static java.util.regex.Pattern	TAB Tab pattern.
private static java.util.Map<java.lang.String,java.lang.Integer>	TOKEN_NAME_TO_VALUE Maps from a token name to value.
private static java.util.Map<java.lang.Integer,java.lang.String>	TOKEN_VALUE_TO_NAME Maps from a token value to name.
private static java.lang.String	UNKNOWN_JAVADOC_TOKEN_ID_EXCEPTION_MESSAGE Exception message for unknown JavaDoc token id.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	JavadocUtil() Prevent instantiation.

Method Summary

Modifier and Type	Method and Description
static boolean	containsInBranch(DetailNode node, int type) Checks whether node contains any node of specified type among children on any deep level.
static java.lang.String	escapeAllControlChars(java.lang.String text) Replace all control chars with escaped symbols.
static DetailNode	findFirstToken(DetailNode detailNode, int type) Returns the first child token that has a specified type.
static java.lang.String	getBlockCommentContent(DetailAST blockCommentBegin) Gets content of block comment.
static DetailNode	getFirstChild(DetailNode node) Gets first child node of specified node.
static java.lang.String	getJavadocCommentContent(DetailAST javadocCommentBegin) Get content of Javadoc comment.
static JavadocTags	getJavadocTags(TextBlock textBlock, JavadocUtil.JavadocTagType tagType) Gets validTags from a given piece of Javadoc.
static DetailNode	getNextSibling(DetailNode node) Gets next sibling of specified node.
static DetailNode	getNextSibling(DetailNode node, int tokenType) Gets next sibling of specified node with the specified type.
static DetailNode	getPreviousSibling(DetailNode node) Gets previous sibling of specified node.
static java.lang.String	getTagName(DetailNode javadocTagSection) Gets tag name from javadocTagSection.
static int	getTokenId(java.lang.String name) Returns the ID of a token for a given name.
static java.lang.String	getTokenName(int id) Returns the name of a token for a given ID.
static boolean	isCorrectJavadocPosition(DetailAST blockComment) Checks Javadoc comment it's in right place.
static boolean	isJavadocComment(DetailAST blockCommentBegin) Checks block comment content starts with '*' javadoc comment identifier.
static boolean	isJavadocComment(java.lang.String commentContent) Checks that commentContent starts with '*' javadoc comment identifier.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TOKEN_NAME_TO_VALUE

private static final java.util.Map<java.lang.String,java.lang.Integer> TOKEN_NAME_TO_VALUE

Maps from a token name to value.

TOKEN_VALUE_TO_NAME

private static final java.util.Map<java.lang.Integer,java.lang.String> TOKEN_VALUE_TO_NAME

Maps from a token value to name.

UNKNOWN_JAVADOC_TOKEN_ID_EXCEPTION_MESSAGE

private static final java.lang.String UNKNOWN_JAVADOC_TOKEN_ID_EXCEPTION_MESSAGE

Exception message for unknown JavaDoc token id.

See Also:

Constant Field Values

NEWLINE

private static final java.util.regex.Pattern NEWLINE

Newline pattern.

RETURN

private static final java.util.regex.Pattern RETURN

Return pattern.

TAB

private static final java.util.regex.Pattern TAB

Tab pattern.

Constructor Detail

JavadocUtil

private JavadocUtil()

Prevent instantiation.

Method Detail

getJavadocTags

public static JavadocTags getJavadocTags(TextBlock textBlock,
                                         JavadocUtil.JavadocTagType tagType)

Gets validTags from a given piece of Javadoc.

Parameters:

textBlock - the Javadoc comment to process.

tagType - the type of validTags we're interested in

Returns:

all standalone validTags from the given javadoc.

isJavadocComment

public static boolean isJavadocComment(java.lang.String commentContent)

Checks that commentContent starts with '*' javadoc comment identifier.

Parameters:

commentContent - content of block comment

Returns:

true if commentContent starts with '*' javadoc comment identifier.

isJavadocComment

public static boolean isJavadocComment(DetailAST blockCommentBegin)

Checks block comment content starts with '*' javadoc comment identifier.

Parameters:

blockCommentBegin - block comment AST

Returns:

true if block comment content starts with '*' javadoc comment identifier.

getBlockCommentContent

public static java.lang.String getBlockCommentContent(DetailAST blockCommentBegin)

Gets content of block comment.

Parameters:

blockCommentBegin - block comment AST.

Returns:

content of block comment.

getJavadocCommentContent

public static java.lang.String getJavadocCommentContent(DetailAST javadocCommentBegin)

Get content of Javadoc comment.

Parameters:

javadocCommentBegin - Javadoc comment AST

Returns:

content of Javadoc comment.

findFirstToken

public static DetailNode findFirstToken(DetailNode detailNode,
                                        int type)

Returns the first child token that has a specified type.

Parameters:

detailNode - Javadoc AST node

type - the token type to match

Returns:

the matching token, or null if no match

getFirstChild

public static DetailNode getFirstChild(DetailNode node)

Gets first child node of specified node.

Parameters:

node - DetailNode

Returns:

first child

containsInBranch

public static boolean containsInBranch(DetailNode node,
                                       int type)

Checks whether node contains any node of specified type among children on any deep level.

Parameters:

node - DetailNode

type - token type

Returns:

true if node contains any node of type type among children on any deep level.

getNextSibling

public static DetailNode getNextSibling(DetailNode node)

Gets next sibling of specified node.

Parameters:

node - DetailNode

Returns:

next sibling.

getNextSibling

public static DetailNode getNextSibling(DetailNode node,
                                        int tokenType)

Gets next sibling of specified node with the specified type.

Parameters:

node - DetailNode

tokenType - javadoc token type

Returns:

next sibling.

getPreviousSibling

public static DetailNode getPreviousSibling(DetailNode node)

Gets previous sibling of specified node.

Parameters:

node - DetailNode

Returns:

previous sibling

getTokenName

public static java.lang.String getTokenName(int id)

Returns the name of a token for a given ID.

Parameters:

id - the ID of the token name to get

Returns:

a token name

Throws:

java.lang.IllegalArgumentException - if an unknown token ID was specified.

getTokenId

public static int getTokenId(java.lang.String name)

Returns the ID of a token for a given name.

Parameters:

name - the name of the token ID to get

Returns:

a token ID

Throws:

java.lang.IllegalArgumentException - if an unknown token name was specified.

getTagName

public static java.lang.String getTagName(DetailNode javadocTagSection)

Gets tag name from javadocTagSection.

Parameters:

javadocTagSection - to get tag name from.

Returns:

name, of the javadocTagSection's tag.

escapeAllControlChars

public static java.lang.String escapeAllControlChars(java.lang.String text)

Replace all control chars with escaped symbols.

Parameters:

text - the String to process.

Returns:

the processed String with all control chars escaped.

isCorrectJavadocPosition

public static boolean isCorrectJavadocPosition(DetailAST blockComment)

Checks Javadoc comment it's in right place.

From Javadoc util documentation: "Placement of comments - Documentation comments are recognized only when placed immediately before class, interface, constructor, method, field or annotation field declarations -- see the class example, method example, and field example. Documentation comments placed in the body of a method are ignored."

If there are many documentation comments per declaration statement, only the last one will be recognized.

Parameters:

blockComment - Block comment AST

Returns:

true if Javadoc is in right place

See Also:

Javadoc util documentation