com.thomasjensen.checkstyle.addons.checks

Class AbstractMethodCallCheck

java.lang.Object

com.puppycrawl.tools.checkstyle.api.AutomaticBean

com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

com.puppycrawl.tools.checkstyle.api.Check

com.thomasjensen.checkstyle.addons.checks.AbstractAddonsCheck

com.thomasjensen.checkstyle.addons.checks.AbstractMethodCallCheck

All Implemented Interfaces:

Configurable, Contextualizable

Direct Known Subclasses:

IllegalMethodCallCheck, LocationReferenceCheck

public abstract class AbstractMethodCallCheck
extends AbstractAddonsCheck

Checks deriving from this type are aware of method calls occurring anywhere in the source, and get explicitly notified when such calls are encountered. The full qualifier of the call is provided.

Author:

Thomas Jensen

Constructor Summary

Constructors

Constructor and Description
AbstractMethodCallCheck()

Method Summary

Methods

Modifier and Type	Method and Description
void	beginTree(DetailAST pRootAst)
String	getCurrentMethodName() The current method name.
Set<Integer>	getRelevantTokens() The tokens which this check is interested in.
protected abstract boolean	isCheckActive() Determines if the check is configured to do anything at all.
protected abstract boolean	isRelevantCall(String pQualifier, String pMethodName) Filter method which determines if the given method call is considered relevant.
protected void	leaveToken(BinaryName pBinaryClassName, DetailAST pAst) Called after all the child nodes have been processed.
protected abstract void	visitMethodCall(String pMethodName, DetailAST pMethodCallAst) Visitor method called when a relevant method call is encountered.
protected void	visitToken(BinaryName pBinaryClassName, DetailAST pAst) Called to process a token.

Methods inherited from class com.thomasjensen.checkstyle.addons.checks.AbstractAddonsCheck

finishTree, finishTree, getApiFixer, getClassDeclarationPosition, getCurrentBinaryName, getCurrentSimpleName, getDefaultTokens, getMyPackage, getRequiredTokens, leaveKnownType, leaveToken, visitKnownType, visitToken

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

destroy, getAcceptableTokens, getClassLoader, getFileContents, getLine, getLines, getTabWidth, getTokenNames, init, isCommentNodesRequired, log, log, setClassLoader, setFileContents, setMessages, setTabWidth, setTokens

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

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

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

configure, contextualize, finishLocalSetup, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractMethodCallCheck

public AbstractMethodCallCheck()

Method Detail

getRelevantTokens

public Set<Integer> getRelevantTokens()

Description copied from class: AbstractAddonsCheck

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

Specified by:

getRelevantTokens in class AbstractAddonsCheck

Returns:

the relevant tokens

isCheckActive

protected abstract boolean isCheckActive()

Determines if the check is configured to do anything at all.

Returns:

true if processing should be performed

isRelevantCall

protected abstract boolean isRelevantCall(@Nonnull
                     String pQualifier,
                     @Nonnull
                     String pMethodName)

Filter method which determines if the given method call is considered relevant.

Parameters:

pQualifier - the qualifier of the method call (for a call like Foo.Bar.call(), the qualifier is Foo.Bar)

pMethodName - the simple name of the called method

Returns:

indication of whether the call is relevant (true) or not (false)

visitMethodCall

protected abstract void visitMethodCall(@Nonnull
                   String pMethodName,
                   @Nonnull
                   DetailAST pMethodCallAst)

Visitor method called when a relevant method call is encountered. This method is called in addition to the other visitor methods.

Parameters:

pMethodName - the simple name of the called method

pMethodCallAst - AST of the call, useful for logging issues ( this is a METHOD_DEF, CTOR_CALL, or a SUPER_CTOR_CALL token)

getCurrentMethodName

@CheckForNull
public String getCurrentMethodName()

The current method name. "<init>" is used for constructors and instance initializers, and "<clinit>" is used for static initializers.

Returns:

the method name, or null if we are not inside a method, constructor, or initializer

beginTree

public void beginTree(DetailAST pRootAst)

Overrides:

beginTree in class AbstractAddonsCheck

visitToken

protected void visitToken(@Nullable
              BinaryName pBinaryClassName,
              @Nonnull
              DetailAST pAst)

Description copied from class: AbstractAddonsCheck

Called to process a token.

Overrides:

visitToken in class AbstractAddonsCheck

Parameters:

pBinaryClassName - the currently active binary class name

pAst - the token to process

leaveToken

protected void leaveToken(@Nullable
              BinaryName pBinaryClassName,
              @Nonnull
              DetailAST pAst)

Description copied from class: AbstractAddonsCheck

Called after all the child nodes have been processed.

Overrides:

leaveToken in class AbstractAddonsCheck

Parameters:

pBinaryClassName - the currently active binary class name

pAst - the token being completed