Package com.puppycrawl.tools.checkstyle.utils

Class BlockCommentPosition

java.lang.Object

com.puppycrawl.tools.checkstyle.utils.BlockCommentPosition

public final class BlockCommentPosition
extends java.lang.Object

Utility class that has methods to check javadoc comment position in java file.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	BlockCommentPosition()	Forbid new instances.

Method Summary

Modifier and Type	Method	Description
private static DetailAST	getNextSiblingSkipComments(DetailAST node)	Get next sibling node skipping any comment nodes.
private static DetailAST	getPrevSiblingSkipComments(DetailAST node)	Get previous sibling node skipping any comments.
static boolean	isOnAnnotationDef(DetailAST blockComment)	Node is on annotation definition.
static boolean	isOnClass(DetailAST blockComment)	Node is on class definition.
static boolean	isOnConstructor(DetailAST blockComment)	Node is on constructor.
static boolean	isOnEnum(DetailAST blockComment)	Node is on enum definition.
static boolean	isOnEnumConstant(DetailAST blockComment)	Node is on enum constant.
static boolean	isOnField(DetailAST blockComment)	Node is on field declaration.
static boolean	isOnInterface(DetailAST blockComment)	Node is on interface definition.
static boolean	isOnMethod(DetailAST blockComment)	Node is on method declaration.
private static boolean	isOnPlainClassMember(DetailAST blockComment, int memberType)	Checks that block comment is on specified class member without any modifiers.
private static boolean	isOnPlainToken(DetailAST blockComment, int parentTokenType, int nextTokenType)	Checks that block comment is on specified token without any modifiers.
private static boolean	isOnTokenWithAnnotation(DetailAST blockComment, int tokenType)	Checks that block comment is on specified token with annotation.
private static boolean	isOnTokenWithModifiers(DetailAST blockComment, int tokenType)	Checks that block comment is on specified token with modifiers.

Methods inherited from class java.lang.Object

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

Constructor Detail

BlockCommentPosition

private BlockCommentPosition()

Forbid new instances.

Method Detail

isOnClass

public static boolean isOnClass(DetailAST blockComment)

Node is on class definition.

Parameters:

blockComment - DetailAST

Returns:

true if node is before class

isOnInterface

public static boolean isOnInterface(DetailAST blockComment)

Node is on interface definition.

Parameters:

blockComment - DetailAST

Returns:

true if node is before interface

isOnEnum

public static boolean isOnEnum(DetailAST blockComment)

Node is on enum definition.

Parameters:

blockComment - DetailAST

Returns:

true if node is before enum

isOnAnnotationDef

public static boolean isOnAnnotationDef(DetailAST blockComment)

Node is on annotation definition.

Parameters:

blockComment - DetailAST

Returns:

true if node is before annotation

isOnMethod

public static boolean isOnMethod(DetailAST blockComment)

Node is on method declaration.

Parameters:

blockComment - DetailAST

Returns:

true if node is before method

isOnField

public static boolean isOnField(DetailAST blockComment)

Node is on field declaration.

Parameters:

blockComment - DetailAST

Returns:

true if node is before field

isOnConstructor

public static boolean isOnConstructor(DetailAST blockComment)

Node is on constructor.

Parameters:

blockComment - DetailAST

Returns:

true if node is before constructor

isOnEnumConstant

public static boolean isOnEnumConstant(DetailAST blockComment)

Node is on enum constant.

Parameters:

blockComment - DetailAST

Returns:

true if node is before enum constant

isOnPlainToken

private static boolean isOnPlainToken(DetailAST blockComment,
                                      int parentTokenType,
                                      int nextTokenType)

Checks that block comment is on specified token without any modifiers.

Parameters:

blockComment - block comment start DetailAST

parentTokenType - parent token type

nextTokenType - next token type

Returns:

true if block comment is on specified token without modifiers

isOnTokenWithModifiers

private static boolean isOnTokenWithModifiers(DetailAST blockComment,
                                              int tokenType)

Checks that block comment is on specified token with modifiers.

Parameters:

blockComment - block comment start DetailAST

tokenType - parent token type

Returns:

true if block comment is on specified token with modifiers

isOnTokenWithAnnotation

private static boolean isOnTokenWithAnnotation(DetailAST blockComment,
                                               int tokenType)

Checks that block comment is on specified token with annotation.

Parameters:

blockComment - block comment start DetailAST

tokenType - parent token type

Returns:

true if block comment is on specified token with annotation

isOnPlainClassMember

private static boolean isOnPlainClassMember(DetailAST blockComment,
                                            int memberType)

Checks that block comment is on specified class member without any modifiers.

Parameters:

blockComment - block comment start DetailAST

memberType - parent token type

Returns:

true if block comment is on specified token without modifiers

getNextSiblingSkipComments

private static DetailAST getNextSiblingSkipComments(DetailAST node)

Get next sibling node skipping any comment nodes.

Parameters:

node - current node

Returns:

next sibling

getPrevSiblingSkipComments

private static DetailAST getPrevSiblingSkipComments(DetailAST node)

Get previous sibling node skipping any comments.

Parameters:

node - current node

Returns:

previous sibling