Package com.puppycrawl.tools.checkstyle.checks.coding

Class UnusedCatchParameterShouldBeUnnamedCheck

java.lang.Object

com.puppycrawl.tools.checkstyle.AbstractAutomaticBean

com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

com.puppycrawl.tools.checkstyle.api.AbstractCheck

com.puppycrawl.tools.checkstyle.checks.coding.UnusedCatchParameterShouldBeUnnamedCheck

All Implemented Interfaces:

Configurable, Contextualizable

public class UnusedCatchParameterShouldBeUnnamedCheck
extends AbstractCheck

Ensures that catch parameters that are not used are declared as an unnamed variable.

Rationale:

• Improves code readability by clearly indicating which parameters are unused.
• Follows Java conventions for denoting unused parameters with an underscore (_).

See the Java Language Specification for more information about unnamed variables.

Attention: This check should be activated only on source code that is compiled by jdk21 or higher; unnamed catch parameters came out as the first preview in Java 21.

Parent is com.puppycrawl.tools.checkstyle.TreeWalker

Violation Message Keys:

• unused.catch.parameter

Since:

10.18.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	UnusedCatchParameterShouldBeUnnamedCheck.CatchParameterDetails	Maintains information about the catch parameter.

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

AbstractAutomaticBean.OutputStreamOptions

Field Summary

Fields

Modifier and Type	Field	Description
private final Deque<UnusedCatchParameterShouldBeUnnamedCheck.CatchParameterDetails>	catchParameters	Keeps track of the catch parameters in a block.
private static final int[]	INVALID_CATCH_PARAM_IDENT_PARENTS	Invalid parents of the catch parameter identifier.
static final String	MSG_UNUSED_CATCH_PARAMETER	A key is pointing to the warning message text in "messages.properties" file.

Constructor Summary

Constructors

Constructor	Description
UnusedCatchParameterShouldBeUnnamedCheck()

Method Summary

Modifier and Type	Method	Description
void	beginTree(DetailAST rootAST)	Called before the starting to process a tree.
int[]	getAcceptableTokens()	The configurable token set.
int[]	getDefaultTokens()	Returns the default token a check is interested in.
int[]	getRequiredTokens()	The tokens that this check must be registered for.
private static boolean	isCatchParameterIdentifierCandidate(DetailAST identifierAst)	Visit ast of type TokenTypes.IDENT and check if it is a candidate for a catch parameter identifier.
private static boolean	isLeftHandOfAssignment(DetailAST identAst)	Check if the given TokenTypes.IDENT is a left hand side value.
private static boolean	isMethodInvocation(DetailAST identAst)	Check if the given TokenTypes.IDENT is a child of a dot operator and is a candidate for catch parameter.
void	leaveToken(DetailAST ast)	Called after all the child nodes have been process.
void	visitToken(DetailAST ast)	Called to process a token.

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

clearViolations, destroy, finishTree, getFileContents, getFilePath, getLine, getLineCodePoints, getLines, getTabWidth, getTokenNames, getViolations, init, isCommentNodesRequired, log, log, log, 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.AbstractAutomaticBean

configure, contextualize, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Field Details

MSG_UNUSED_CATCH_PARAMETER

public static final String MSG_UNUSED_CATCH_PARAMETER

A key is pointing to the warning message text in "messages.properties" file.

See Also:

• Constant Field Values

INVALID_CATCH_PARAM_IDENT_PARENTS

private static final int[] INVALID_CATCH_PARAM_IDENT_PARENTS

Invalid parents of the catch parameter identifier.

catchParameters

private final Deque<UnusedCatchParameterShouldBeUnnamedCheck.CatchParameterDetails> catchParameters

Keeps track of the catch parameters in a block.

Constructor Details

UnusedCatchParameterShouldBeUnnamedCheck

public UnusedCatchParameterShouldBeUnnamedCheck()

Method Details

getDefaultTokens

public int[] getDefaultTokens()

Description copied from class: AbstractCheck

Returns the default token a check is interested in. Only used if the configuration for a check does not define the tokens.

Specified by:

getDefaultTokens in class AbstractCheck

Returns:

the default tokens

See Also:

• TokenTypes

getAcceptableTokens

public int[] getAcceptableTokens()

Description copied from class: AbstractCheck

The configurable token set. Used to protect Checks against malicious users who specify an unacceptable token set in the configuration file. The default implementation returns the check's default tokens.

Specified by:

getAcceptableTokens in class AbstractCheck

Returns:

the token set this check is designed for.

See Also:

• TokenTypes

getRequiredTokens

public int[] getRequiredTokens()

Description copied from class: AbstractCheck

The tokens that this check must be registered for.

Specified by:

getRequiredTokens in class AbstractCheck

Returns:

the token set this must be registered for.

See Also:

• TokenTypes

beginTree

public void beginTree(DetailAST rootAST)

Description copied from class: AbstractCheck

Called before the starting to process a tree. Ideal place to initialize information that is to be collected whilst processing a tree.

Overrides:

beginTree in class AbstractCheck

Parameters:

rootAST - the root of the tree

visitToken

public void visitToken(DetailAST ast)

Description copied from class: AbstractCheck

Called to process a token.

Overrides:

visitToken in class AbstractCheck

Parameters:

ast - the token to process

leaveToken

public void leaveToken(DetailAST ast)

Description copied from class: AbstractCheck

Called after all the child nodes have been process.

Overrides:

leaveToken in class AbstractCheck

Parameters:

ast - the token leaving

isCatchParameterIdentifierCandidate

private static boolean isCatchParameterIdentifierCandidate(DetailAST identifierAst)

Visit ast of type TokenTypes.IDENT and check if it is a candidate for a catch parameter identifier.

Parameters:

identifierAst - token representing TokenTypes.IDENT

Returns:

true if the given TokenTypes.IDENT could be a catch parameter identifier

isMethodInvocation

private static boolean isMethodInvocation(DetailAST identAst)

Check if the given TokenTypes.IDENT is a child of a dot operator and is a candidate for catch parameter.

Parameters:

identAst - token representing TokenTypes.IDENT

Returns:

true if the given TokenTypes.IDENT is a child of a dot operator and a candidate for catch parameter.

isLeftHandOfAssignment

private static boolean isLeftHandOfAssignment(DetailAST identAst)

Check if the given TokenTypes.IDENT is a left hand side value.

Parameters:

identAst - token representing TokenTypes.IDENT

Returns:

true if the given TokenTypes.IDENT is a left hand side value.