com.puppycrawl.tools.checkstyle.api

Class FullIdent

java.lang.Object

com.puppycrawl.tools.checkstyle.api.FullIdent

public final class FullIdent
extends java.lang.Object

Represents a full identifier, including dots, with associated position information.

Identifiers such as java.util.HashMap are spread across multiple AST nodes in the syntax tree (three IDENT nodes, two DOT nodes). A FullIdent represents the whole String (excluding any intermediate whitespace), which is often easier to work with in Checks.

See Also:

TokenTypes.DOT, TokenTypes.IDENT

Field Summary

Fields

Modifier and Type	Field and Description
private DetailAST	detailAst The topmost and leftmost AST of the full identifier.
private java.util.List<java.lang.String>	elements The list holding subsequent elements of identifier.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	FullIdent() Hide default constructor.

Method Summary

Modifier and Type	Method and Description
private void	append(DetailAST ast) Append the specified token and also recalibrate the first line and column.
private void	append(java.lang.String text) Append the specified text.
private static void	appendBrackets(FullIdent full, DetailAST ast) Appends the brackets of an array type to a FullIdent.
static FullIdent	createFullIdent(DetailAST ast) Creates a new FullIdent starting from the specified node.
static FullIdent	createFullIdentBelow(DetailAST ast) Creates a new FullIdent starting from the child of the specified node.
private static void	extractFullIdent(FullIdent full, DetailAST ast) Recursively extract a FullIdent.
int	getColumnNo() Gets the column number.
DetailAST	getDetailAst() Gets the topmost leftmost DetailAST for this FullIdent.
int	getLineNo() Gets the line number.
java.lang.String	getText() Gets the text.
private static boolean	isArrayTypeDeclaration(DetailAST arrayDeclarator) Checks an `ARRAY_DECLARATOR` ast to verify that it is not a array initialization, i.e.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

elements

private final java.util.List<java.lang.String> elements

The list holding subsequent elements of identifier.

detailAst

private DetailAST detailAst

The topmost and leftmost AST of the full identifier.

Constructor Detail

FullIdent

private FullIdent()

Hide default constructor.

Method Detail

createFullIdentBelow

public static FullIdent createFullIdentBelow(DetailAST ast)

Creates a new FullIdent starting from the child of the specified node.

Parameters:

ast - the parent node from where to start from

Returns:

a FullIdent value

createFullIdent

public static FullIdent createFullIdent(DetailAST ast)

Creates a new FullIdent starting from the specified node.

Parameters:

ast - the node to start from

Returns:

a FullIdent value

extractFullIdent

private static void extractFullIdent(FullIdent full,
                                     DetailAST ast)

Recursively extract a FullIdent.

Parameters:

full - the FullIdent to add to

ast - the node to recurse from

isArrayTypeDeclaration

private static boolean isArrayTypeDeclaration(DetailAST arrayDeclarator)

Checks an `ARRAY_DECLARATOR` ast to verify that it is not a array initialization, i.e. 'new int [2][2]'. We do this by making sure that no 'EXPR' token exists in this branch.

Parameters:

arrayDeclarator - the first ARRAY_DECLARATOR token in the ast

Returns:

true if ast is an array type declaration

appendBrackets

private static void appendBrackets(FullIdent full,
                                   DetailAST ast)

Appends the brackets of an array type to a FullIdent.

Parameters:

full - the FullIdent to append brackets to

ast - the type ast we are building a FullIdent for

getText

public java.lang.String getText()

Gets the text.

Returns:

the text

getDetailAst

public DetailAST getDetailAst()

Gets the topmost leftmost DetailAST for this FullIdent.

Returns:

the topmost leftmost ast

getLineNo

public int getLineNo()

Gets the line number.

Returns:

the line number

getColumnNo

public int getColumnNo()

Gets the column number.

Returns:

the column number

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

append

private void append(java.lang.String text)

Append the specified text.

Parameters:

text - the text to append

append

private void append(DetailAST ast)

Append the specified token and also recalibrate the first line and column.

Parameters:

ast - the token to append