com.puppycrawl.tools.checkstyle.checks.javadoc

Class JavadocUtils

java.lang.Object

com.puppycrawl.tools.checkstyle.checks.javadoc.JavadocUtils

public final class JavadocUtils
extends Object

Contains utility methods for working with Javadoc.

Author:

Lyle Hanson

Nested Class Summary

Nested Classes

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

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	branchContains(DetailNode node, int type) Checks whether node contains any node of specified type among children on any deep level.
static DetailNode	findFirstToken(DetailNode node, int type) Returns the first child token that has a specified type.
static String	getBlockCommentContent(DetailAST blockCommentBegin) Gets content of block comment.
static DetailNode	getFirstChild(DetailNode node) Gets first child node of specified node.
static String	getJavadocCommentContent(DetailAST javdocCommentBegin) Get content of Javadoc comment.
static JavadocTags	getJavadocTags(TextBlock cmt, JavadocUtils.JavadocTagType tagType) Gets validTags from a given piece of Javadoc.
static DetailNode	getNextSibling(DetailNode node) Gets next sibling of specified node.
static DetailNode	getPreviousSibling(DetailNode node) Gets previous sibling of specified node.
static int	getTokenId(String name) Returns the ID of a token for a given name.
static String	getTokenName(int iD) Returns the name of a token for a given ID.
static boolean	isJavadocComment(DetailAST blockCommentBegin) Checks block comment content starts with '*' javadoc comment identifier.
static boolean	isJavadocComment(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

Method Detail

getJavadocTags

public static JavadocTags getJavadocTags(TextBlock cmt,
                         JavadocUtils.JavadocTagType tagType)

Gets validTags from a given piece of Javadoc.

Parameters:

cmt - 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(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 String getBlockCommentContent(DetailAST blockCommentBegin)

Gets content of block comment.

Parameters:

blockCommentBegin - block comment AST.

Returns:

content of block comment.

getJavadocCommentContent

public static String getJavadocCommentContent(DetailAST javdocCommentBegin)

Get content of Javadoc comment.

Parameters:

javdocCommentBegin - Javadoc comment AST

Returns:

content of Javadoc comment.

findFirstToken

public static DetailNode findFirstToken(DetailNode node,
                        int type)

Returns the first child token that has a specified type.

Parameters:

node - 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

branchContains

public static boolean branchContains(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.

getPreviousSibling

public static DetailNode getPreviousSibling(DetailNode node)

Gets previous sibling of specified node.

Parameters:

node - DetailNode

Returns:

previous sibling

getTokenName

public static 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

getTokenId

public static int getTokenId(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