com.puppycrawl.tools.checkstyle.checks.indentation

Class AbstractExpressionHandler

java.lang.Object

com.puppycrawl.tools.checkstyle.checks.indentation.AbstractExpressionHandler

Direct Known Subclasses:

BlockParentHandler, CaseHandler, ImportHandler, IndexHandler, LabelHandler, LambdaHandler, MemberDefHandler, MethodCallHandler, NewHandler, PackageDefHandler, PrimordialHandler

public abstract class AbstractExpressionHandler
extends Object

Abstract base class for all handlers.

Author:

jrichard

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractExpressionHandler(IndentationCheck indentCheck, String typeName, DetailAST expr, AbstractExpressionHandler parent) Construct an instance of this handler with the given indentation check, name, abstract syntax tree, and parent handler.

Method Summary

Modifier and Type	Method and Description
static boolean	areOnSameLine(DetailAST ast1, DetailAST ast2) Determines if two expressions are on the same line.
protected void	checkChildren(DetailAST parentNode, int[] tokenTypes, IndentLevel startIndent, boolean firstLineMatches, boolean allowNesting) Check the indent level of the children of the specified parent expression.
protected void	checkExpressionSubtree(DetailAST tree, IndentLevel indentLevel, boolean firstLineMatches, boolean allowNesting) Check the indentation level for an expression subtree.
abstract void	checkIndentation() Check the indentation of the expression we are handling.
protected void	checkLeftParen(DetailAST lparen) Check the indentation of the left parenthesis.
protected void	checkModifiers() Check the indentation level of modifiers.
protected void	checkRightParen(DetailAST lparen, DetailAST rparen) Check the indentation of the right parenthesis.
protected void	checkWrappingIndentation(DetailAST firstNode, DetailAST lastNode) Checks indentation on wrapped lines between and including firstNode and lastNode.
protected void	checkWrappingIndentation(DetailAST firstNode, DetailAST lastNode, int wrappedIndentLevel, int startIndent, boolean ignoreFirstLine) Checks indentation on wrapped lines between and including firstNode and lastNode.
protected int	expandedTabsColumnNo(DetailAST ast) Get the column number for the start of a given expression, expanding tabs out into spaces in the process.
protected void	findSubtreeLines(LineSet lines, DetailAST tree, boolean allowNesting) Find the set of lines for a given subtree.
protected int	getBasicOffset() A shortcut for IndentationCheck property.
protected int	getBraceAdjustment() A shortcut for IndentationCheck property.
protected static int	getFirstLine(int startLine, DetailAST tree) Get the first line for a given expression.
static DetailAST	getFirstToken(DetailAST ast) Searches in given sub-tree (including given node) for the token which represents first symbol for this sub-tree in file.
IndentLevel	getIndent() Get the indentation amount for this handler.
protected IndentationCheck	getIndentCheck() Accessor for the IndentCheck attribute.
protected IndentLevel	getIndentImpl() Compute the indentation amount for this handler.
protected int	getLineStart(DetailAST ast) Get the start of the line for the given expression.
protected int	getLineStart(int lineNo) Get the start of the line for the given line number.
protected DetailAST	getMainAst() Accessor for the MainAst attribute.
protected AbstractExpressionHandler	getParent() Accessor for the Parent attribute.
IndentLevel	getSuggestedChildIndent(AbstractExpressionHandler child) Indentation level suggested for a child element.
protected boolean	isOnStartOfLine(DetailAST ast) Determines if the given expression is at the start of a line.
protected void	logError(DetailAST ast, String subtypeName, int actualIndent) Log an indentation error.
protected void	logError(DetailAST ast, String subtypeName, int actualIndent, IndentLevel expectedIndent) Log an indentation error.
protected boolean	shouldIncreaseIndent() Checks that indentation should be increased after first line in checkLinesIndent().

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractExpressionHandler

protected AbstractExpressionHandler(IndentationCheck indentCheck,
                                    String typeName,
                                    DetailAST expr,
                                    AbstractExpressionHandler parent)

Construct an instance of this handler with the given indentation check, name, abstract syntax tree, and parent handler.

Parameters:

indentCheck - the indentation check

typeName - the name of the handler

expr - the abstract syntax tree

parent - the parent handler

Method Detail

checkIndentation

public abstract void checkIndentation()

Check the indentation of the expression we are handling.

getIndent

public final IndentLevel getIndent()

Get the indentation amount for this handler. For performance reasons, this value is cached. The first time this method is called, the indentation amount is computed and stored. On further calls, the stored value is returned.

Returns:

the expected indentation amount

getIndentImpl

protected IndentLevel getIndentImpl()

Compute the indentation amount for this handler.

Returns:

the expected indentation amount

getSuggestedChildIndent

public IndentLevel getSuggestedChildIndent(AbstractExpressionHandler child)

Indentation level suggested for a child element. Children don't have to respect this, but most do.

Parameters:

child - child AST (so suggestion level can differ based on child type)

Returns:

suggested indentation for child

logError

protected final void logError(DetailAST ast,
                              String subtypeName,
                              int actualIndent)

Log an indentation error.

Parameters:

ast - the expression that caused the error

subtypeName - the type of the expression

actualIndent - the actual indent level of the expression

logError

protected final void logError(DetailAST ast,
                              String subtypeName,
                              int actualIndent,
                              IndentLevel expectedIndent)

Log an indentation error.

Parameters:

ast - the expression that caused the error

subtypeName - the type of the expression

actualIndent - the actual indent level of the expression

expectedIndent - the expected indent level of the expression

isOnStartOfLine

protected final boolean isOnStartOfLine(DetailAST ast)

Determines if the given expression is at the start of a line.

Parameters:

ast - the expression to check

Returns:

true if it is, false otherwise

areOnSameLine

public static boolean areOnSameLine(DetailAST ast1,
                                    DetailAST ast2)

Determines if two expressions are on the same line.

Parameters:

ast1 - the first expression

ast2 - the second expression

Returns:

true if they are, false otherwise

getFirstToken

public static DetailAST getFirstToken(DetailAST ast)

Searches in given sub-tree (including given node) for the token which represents first symbol for this sub-tree in file.

Parameters:

ast - a root of sub-tree in which the search should be performed.

Returns:

a token which occurs first in the file.

getLineStart

protected final int getLineStart(DetailAST ast)

Get the start of the line for the given expression.

Parameters:

ast - the expression to find the start of the line for

Returns:

the start of the line for the given expression

getLineStart

protected final int getLineStart(int lineNo)

Get the start of the line for the given line number.

Parameters:

lineNo - the line number to find the start for

Returns:

the start of the line for the given expression

shouldIncreaseIndent

protected boolean shouldIncreaseIndent()

Checks that indentation should be increased after first line in checkLinesIndent().

Returns:

true if indentation should be increased after first line in checkLinesIndent() false otherwise

checkWrappingIndentation

protected void checkWrappingIndentation(DetailAST firstNode,
                                        DetailAST lastNode)

Checks indentation on wrapped lines between and including firstNode and lastNode.

Parameters:

firstNode - First node to start examining.

lastNode - Last node to examine inclusively.

checkWrappingIndentation

protected void checkWrappingIndentation(DetailAST firstNode,
                                        DetailAST lastNode,
                                        int wrappedIndentLevel,
                                        int startIndent,
                                        boolean ignoreFirstLine)

Checks indentation on wrapped lines between and including firstNode and lastNode.

Parameters:

firstNode - First node to start examining.

lastNode - Last node to examine inclusively.

wrappedIndentLevel - Indentation all wrapped lines should use.

startIndent - Indentation first line before wrapped lines used.

ignoreFirstLine - Test if first line's indentation should be checked or not.

checkChildren

protected final void checkChildren(DetailAST parentNode,
                                   int[] tokenTypes,
                                   IndentLevel startIndent,
                                   boolean firstLineMatches,
                                   boolean allowNesting)

Check the indent level of the children of the specified parent expression.

Parameters:

parentNode - the parent whose children we are checking

tokenTypes - the token types to check

startIndent - the starting indent level

firstLineMatches - whether or not the first line needs to match

allowNesting - whether or not nested children are allowed

checkExpressionSubtree

protected final void checkExpressionSubtree(DetailAST tree,
                                            IndentLevel indentLevel,
                                            boolean firstLineMatches,
                                            boolean allowNesting)

Check the indentation level for an expression subtree.

Parameters:

tree - the expression subtree to check

indentLevel - the indentation level

firstLineMatches - whether or not the first line has to match

allowNesting - whether or not subtree nesting is allowed

getFirstLine

protected static int getFirstLine(int startLine,
                                  DetailAST tree)

Get the first line for a given expression.

Parameters:

startLine - the line we are starting from

tree - the expression to find the first line for

Returns:

the first line of the expression

expandedTabsColumnNo

protected final int expandedTabsColumnNo(DetailAST ast)

Get the column number for the start of a given expression, expanding tabs out into spaces in the process.

Parameters:

ast - the expression to find the start of

Returns:

the column number for the start of the expression

findSubtreeLines

protected final void findSubtreeLines(LineSet lines,
                                      DetailAST tree,
                                      boolean allowNesting)

Find the set of lines for a given subtree.

Parameters:

lines - the set of lines to add to

tree - the subtree to examine

allowNesting - whether or not to allow nested subtrees

checkModifiers

protected void checkModifiers()

Check the indentation level of modifiers.

getIndentCheck

protected final IndentationCheck getIndentCheck()

Accessor for the IndentCheck attribute.

Returns:

the IndentCheck attribute

getMainAst

protected final DetailAST getMainAst()

Accessor for the MainAst attribute.

Returns:

the MainAst attribute

getParent

protected final AbstractExpressionHandler getParent()

Accessor for the Parent attribute.

Returns:

the Parent attribute

getBasicOffset

protected final int getBasicOffset()

A shortcut for IndentationCheck property.

Returns:

value of basicOffset property of IndentationCheck

getBraceAdjustment

protected final int getBraceAdjustment()

A shortcut for IndentationCheck property.

Returns:

value of braceAdjustment property of IndentationCheck

checkRightParen

protected final void checkRightParen(DetailAST lparen,
                                     DetailAST rparen)

Check the indentation of the right parenthesis.

Parameters:

rparen - parenthesis to check

lparen - left parenthesis associated with aRparen

checkLeftParen

protected final void checkLeftParen(DetailAST lparen)

Check the indentation of the left parenthesis.

Parameters:

lparen - parenthesis to check