com.thomasjensen.checkstyle.addons.checks

Class AbstractAddonsCheck

java.lang.Object

com.puppycrawl.tools.checkstyle.api.AutomaticBean

com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

com.puppycrawl.tools.checkstyle.api.AbstractCheck

com.thomasjensen.checkstyle.addons.checks.AbstractAddonsCheck

All Implemented Interfaces:

com.puppycrawl.tools.checkstyle.api.Configurable, com.puppycrawl.tools.checkstyle.api.Contextualizable

Direct Known Subclasses:

AbstractMethodCallCheck, LostInstanceCheck, PropertyCatalogCheck, RegexpOnStringCheck

public abstract class AbstractAddonsCheck
extends com.puppycrawl.tools.checkstyle.api.AbstractCheck

Base class of all Checkstyle Addons checks.

Nested Class Summary

Nested classes/interfaces inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean

com.puppycrawl.tools.checkstyle.api.AutomaticBean.OutputStreamOptions

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAddonsCheck()
protected	AbstractAddonsCheck(java.lang.String pMockfile)

Method Summary

Modifier and Type	Method and Description
void	beginTree(com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst)
protected void	finishTree(BinaryName pOuterClassName, com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst) Called after a tree is fully processed.
void	finishTree(com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst)
int[]	getAcceptableTokens()
protected CheckstyleApiFixer	getApiFixer()
protected com.puppycrawl.tools.checkstyle.api.DetailAST	getClassDeclarationPosition(BinaryName pBinaryName)
protected BinaryName	getCurrentBinaryName() Gets the binary name of the class currently being traversed on the AST.
protected java.lang.String	getCurrentSimpleName() Gets the simple name of the current class, interface, annotation, or enum.
int[]	getDefaultTokens()
protected java.lang.String	getMyPackage()
abstract java.util.Set<java.lang.Integer>	getRelevantTokens() The tokens which this check is interested in.
int[]	getRequiredTokens()
protected void	leaveKnownType(BinaryName pBinaryClassName, com.puppycrawl.tools.checkstyle.api.DetailAST pAst) Called after leaving a CLASS_DEF, INTERFACE_DEF, ANNOTATION_DEF, or ENUM_DEF token and the type's binary class name is known.
protected void	leaveToken(BinaryName pBinaryClassName, com.puppycrawl.tools.checkstyle.api.DetailAST pAst) Called after all the child nodes have been processed.
void	leaveToken(com.puppycrawl.tools.checkstyle.api.DetailAST pAst)
protected void	visitKnownType(BinaryName pBinaryClassName, com.puppycrawl.tools.checkstyle.api.DetailAST pAst) Called after visiting a CLASS_DEF, INTERFACE_DEF, ANNOTATION_DEF, or ENUM_DEF token and successfully determining the type's binary class name.
protected void	visitToken(BinaryName pBinaryClassName, com.puppycrawl.tools.checkstyle.api.DetailAST pAst) Called to process a token.
void	visitToken(com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Methods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractCheck

clearMessages, destroy, getClassLoader, getFileContents, getLine, getLines, getMessages, getTabWidth, getTokenNames, init, isCommentNodesRequired, log, log, log, setClassLoader, setFileContents, setTabWidth, setTokens

Methods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverity

Methods inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean

configure, contextualize, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractAddonsCheck

protected AbstractAddonsCheck()

AbstractAddonsCheck

protected AbstractAddonsCheck(@Nullable
                              java.lang.String pMockfile)

Method Detail

beginTree

public void beginTree(com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst)

Overrides:

beginTree in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

finishTree

protected void finishTree(@Nonnull
                          BinaryName pOuterClassName,
                          @Nonnull
                          com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst)

Called after a tree is fully processed. Ideal place to report on information collected whilst processing a tree.

Parameters:

pOuterClassName - the fully qualified class name of the outer class

pRootAst - the root of the tree

finishTree

public final void finishTree(com.puppycrawl.tools.checkstyle.api.DetailAST pRootAst)

Overrides:

finishTree in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

getAcceptableTokens

public final int[] getAcceptableTokens()

Specified by:

getAcceptableTokens in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

getApiFixer

@Nonnull
protected CheckstyleApiFixer getApiFixer()

getClassDeclarationPosition

@CheckForNull
protected com.puppycrawl.tools.checkstyle.api.DetailAST getClassDeclarationPosition(@Nonnull
                                                                                                   BinaryName pBinaryName)

getCurrentBinaryName

@CheckForNull
protected BinaryName getCurrentBinaryName()

Gets the binary name of the class currently being traversed on the AST. Normally, this is the single class in the .java file, but it could also be a (nested) named inner class. Whenever a new CLASS_DEF or similar token is visited, the result of this method would change.

Returns:

current binary name, or null if no CLASS_DEF or similar token has been encountered yet (e.g. while we are still going through the import statements)

getCurrentSimpleName

@CheckForNull
protected java.lang.String getCurrentSimpleName()

Gets the simple name of the current class, interface, annotation, or enum.

Returns:

the simple class name, or null if we are outside of a type definition

getDefaultTokens

public final int[] getDefaultTokens()

Specified by:

getDefaultTokens in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

getMyPackage

protected java.lang.String getMyPackage()

getRelevantTokens

public abstract java.util.Set<java.lang.Integer> getRelevantTokens()

The tokens which this check is interested in. Will be added to the tokens of the base class.

Returns:

the relevant tokens

getRequiredTokens

public final int[] getRequiredTokens()

Specified by:

getRequiredTokens in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

leaveKnownType

protected void leaveKnownType(@Nonnull
                              BinaryName pBinaryClassName,
                              @Nonnull
                              com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Called after leaving a CLASS_DEF, INTERFACE_DEF, ANNOTATION_DEF, or ENUM_DEF token and the type's binary class name is known. This is useful in a Java source file with nested inner classes. If the implementing check registers for any of the above tokens, the regular call to leaveToken(BinaryName, DetailAST) will be performed in addition to (before) this one.

Parameters:

pBinaryClassName - the binary class name of the visited type

pAst - the token being completed

leaveToken

protected void leaveToken(@Nullable
                          BinaryName pBinaryClassName,
                          @Nonnull
                          com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Called after all the child nodes have been processed.

Parameters:

pBinaryClassName - the currently active binary class name

pAst - the token being completed

leaveToken

public final void leaveToken(com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Overrides:

leaveToken in class com.puppycrawl.tools.checkstyle.api.AbstractCheck

visitKnownType

protected void visitKnownType(@Nonnull
                              BinaryName pBinaryClassName,
                              @Nonnull
                              com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Called after visiting a CLASS_DEF, INTERFACE_DEF, ANNOTATION_DEF, or ENUM_DEF token and successfully determining the type's binary class name. This is useful in a Java source file with nested inner classes. If the implementing check registers for any of the above tokens, the regular call to visitToken(BinaryName, DetailAST) will be performed in addition to (after) this one.

Parameters:

pBinaryClassName - the binary class name of the visited type

pAst - the token to process

visitToken

protected void visitToken(@Nullable
                          BinaryName pBinaryClassName,
                          @Nonnull
                          com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Called to process a token.

Parameters:

pBinaryClassName - the currently active binary class name

pAst - the token to process

visitToken

public final void visitToken(com.puppycrawl.tools.checkstyle.api.DetailAST pAst)

Overrides:

visitToken in class com.puppycrawl.tools.checkstyle.api.AbstractCheck