public class DescendantTokenCheck extends Check
Checks for restricted tokens beneath other tokens.
Examples of how to configure the check:
<!-- String literal equality check --> <module name="DescendantToken"> <property name="tokens" value="EQUAL,NOT_EQUAL"/> <property name="limitedTokens" value="STRING_LITERAL"/> <property name="maximumNumber" value="0"/> <property name="maximumDepth" value="1"/> </module> <!-- Switch with no default --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_SWITCH"/> <property name="maximumDepth" value="2"/> <property name="limitedTokens" value="LITERAL_DEFAULT"/> <property name="minimumNumber" value="1"/> </module> <!-- Assert statement may have side effects --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_ASSERT"/> <property name="limitedTokens" value="ASSIGN,DEC,INC,POST_DEC, POST_INC,PLUS_ASSIGN,MINUS_ASSIGN,STAR_ASSIGN,DIV_ASSIGN,MOD_ASSIGN, BSR_ASSIGN,SR_ASSIGN,SL_ASSIGN,BAND_ASSIGN,BXOR_ASSIGN,BOR_ASSIGN, METHOD_CALL"/> <property name="maximumNumber" value="0"/> </module> <!-- Initialiser in for performs no setup - use while instead? --> <module name="DescendantToken"> <property name="tokens" value="FOR_INIT"/> <property name="limitedTokens" value="EXPR"/> <property name="minimumNumber" value="1"/> </module> <!-- Condition in for performs no check --> <module name="DescendantToken"> <property name="tokens" value="FOR_CONDITION"/> <property name="limitedTokens" value="EXPR"/> <property name="minimumNumber" value="1"/> </module> <!-- Switch within switch --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_SWITCH"/> <property name="limitedTokens" value="LITERAL_SWITCH"/> <property name="maximumNumber" value="0"/> <property name="minimumDepth" value="1"/> </module> <!-- Return from within a catch or finally block --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_FINALLY,LITERAL_CATCH"/> <property name="limitedTokens" value="LITERAL_RETURN"/> <property name="maximumNumber" value="0"/> </module> <!-- Try within catch or finally block --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_CATCH,LITERAL_FINALLY"/> <property name="limitedTokens" value="LITERAL_TRY"/> <property name="maximumNumber" value="0"/> </module> <!-- Too many cases within a switch --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_SWITCH"/> <property name="limitedTokens" value="LITERAL_CASE"/> <property name="maximumDepth" value="2"/> <property name="maximumNumber" value="10"/> </module> <!-- Too many local variables within a method --> <module name="DescendantToken"> <property name="tokens" value="METHOD_DEF"/> <property name="limitedTokens" value="VARIABLE_DEF"/> <property name="maximumDepth" value="2"/> <property name="maximumNumber" value="10"/> </module> <!-- Too many returns from within a method --> <module name="DescendantToken"> <property name="tokens" value="METHOD_DEF"/> <property name="limitedTokens" value="LITERAL_RETURN"/> <property name="maximumNumber" value="3"/> </module> <!-- Too many fields within an interface --> <module name="DescendantToken"> <property name="tokens" value="INTERFACE_DEF"/> <property name="limitedTokens" value="VARIABLE_DEF"/> <property name="maximumDepth" value="2"/> <property name="maximumNumber" value="0"/> </module> <!-- Limit the number of exceptions a method can throw --> <module name="DescendantToken"> <property name="tokens" value="LITERAL_THROWS"/> <property name="limitedTokens" value="IDENT"/> <property name="maximumNumber" value="1"/> </module> <!-- Limit the number of expressions in a method --> <module name="DescendantToken"> <property name="tokens" value="METHOD_DEF"/> <property name="limitedTokens" value="EXPR"/> <property name="maximumNumber" value="200"/> </module> <!-- Disallow empty statements --> <module name="DescendantToken"> <property name="tokens" value="EMPTY_STAT"/> <property name="limitedTokens" value="EMPTY_STAT"/> <property name="maximumNumber" value="0"/> <property name="maximumDepth" value="0"/> <property name="maximumMessage" value="Empty statement is not allowed."/> </module> <!-- Too many fields within a class --> <module name="DescendantToken"> <property name="tokens" value="CLASS_DEF"/> <property name="limitedTokens" value="VARIABLE_DEF"/> <property name="maximumDepth" value="2"/> <property name="maximumNumber" value="10"/> </module>
Constructor and Description |
---|
DescendantTokenCheck() |
Modifier and Type | Method and Description |
---|---|
int[] |
getAcceptableTokens()
The configurable token set.
|
int[] |
getDefaultTokens()
Returns the default token a check is interested in.
|
void |
setLimitedTokens(String[] limitedTokensParam)
Sets the tokens which occurance as descendant is limited.
|
void |
setMaximumDepth(int maximumDepth)
Sets the maximum depth for descendant counts.
|
void |
setMaximumMessage(String message)
Sets the error message for maximum count exceeded.
|
void |
setMaximumNumber(int maximumNumber)
Sets a maximum count for descendants.
|
void |
setMinimumDepth(int minimumDepth)
Sets the minimum depth for descendant counts.
|
void |
setMinimumMessage(String message)
Sets the error message for minimum count not reached.
|
void |
setMinimumNumber(int minimumNumber)
Sets a minimum count for descendants.
|
void |
setSumTokenCounts(boolean sum)
Sets whether to use the sum of the tokens found, rather than the
individual counts.
|
void |
visitToken(DetailAST ast)
Called to process a token.
|
beginTree, destroy, finishTree, getClassLoader, getFileContents, getLine, getLines, getRequiredTokens, getTabWidth, getTokenNames, init, isCommentNodesRequired, leaveToken, log, log, setClassLoader, setFileContents, setMessages, setTabWidth, setTokens
getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, log, setId, setSeverity
configure, contextualize, finishLocalSetup, getConfiguration, setupChild
public DescendantTokenCheck()
public int[] getDefaultTokens()
Check
getDefaultTokens
in class Check
TokenTypes
public void visitToken(DetailAST ast)
Check
visitToken
in class Check
ast
- the token to processpublic int[] getAcceptableTokens()
Check
getAcceptableTokens
in class Check
TokenTypes
public void setLimitedTokens(String[] limitedTokensParam)
limitedTokensParam
- - list of tokens to ignore.public void setMinimumDepth(int minimumDepth)
minimumDepth
- the minimum depth for descendant counts.public void setMaximumDepth(int maximumDepth)
maximumDepth
- the maximum depth for descendant counts.public void setMinimumNumber(int minimumNumber)
minimumNumber
- the minimum count for descendants.public void setMaximumNumber(int maximumNumber)
maximumNumber
- the maximum count for descendants.public void setMinimumMessage(String message)
message
- the error message for minimum count not reached.
Used as a MessageFormat
pattern with arguments
public void setMaximumMessage(String message)
message
- the error message for maximum count exceeded.
Used as a MessageFormat
pattern with arguments
public void setSumTokenCounts(boolean sum)
sum
- whether to use the sum.Copyright © 2001–2015. All rights reserved.