Class MethodCountCheck
- All Implemented Interfaces:
Configurable,Contextualizable
Checks the number of methods declared in each type declaration by access modifier or total count.
This check can be configured to flag classes that define too many methods
to prevent the class from getting too complex. Counting can be customized
to prevent too many total methods in a type definition (maxTotal),
or to prevent too many methods of a specific access modifier (private,
package, protected or public). Each count is completely
separated to customize how many methods of each you want to allow. For example,
specifying a maxTotal of 10, still means you can prevent more than 0
maxPackage methods. A violation won't appear for 8 public methods,
but one will appear if there is also 3 private methods or any package-private methods.
Methods defined in anonymous classes are not counted towards any totals. Counts only go towards the main type declaration parent, and are kept separate from it's children's inner types.
public class ExampleClass {
public enum Colors {
RED, GREEN, YELLOW;
public String getRGB() { ... } // NOT counted towards ExampleClass
}
public void example() { // counted towards ExampleClass
Runnable r = (new Runnable() {
public void run() { ... } // NOT counted towards ExampleClass, won't produce any violations
});
}
public static class InnerExampleClass {
protected void example2() { ... } // NOT counted towards ExampleClass,
// but counted towards InnerExampleClass
}
}
-
Property
maxTotal- Specify the maximum number of methods allowed at all scope levels. Type isint. Default value is100. -
Property
maxPrivate- Specify the maximum number ofprivatemethods allowed. Type isint. Default value is100. -
Property
maxPackage- Specify the maximum number ofpackagemethods allowed. Type isint. Default value is100. -
Property
maxProtected- Specify the maximum number ofprotectedmethods allowed. Type isint. Default value is100. -
Property
maxPublic- Specify the maximum number ofpublicmethods allowed. Type isint. Default value is100. -
Property
tokens- tokens to check Type isjava.lang.String[]. Validation type istokenSet. Default value is: CLASS_DEF, ENUM_CONSTANT_DEF, ENUM_DEF, INTERFACE_DEF, ANNOTATION_DEF, RECORD_DEF.
To configure the default check:
<module name="MethodCount"/>
To configure the check to allow no more than 30 methods per type declaration:
<module name="MethodCount"> <property name="maxTotal" value="30"/> </module>
To configure the check to allow no more than 10 public methods per type declaration, and 40 methods in total:
<module name="MethodCount"> <property name="maxPublic" value="10"/> <property name="maxTotal" value="40"/> </module>
Parent is com.puppycrawl.tools.checkstyle.TreeWalker
Violation Message Keys:
-
too.many.methods -
too.many.packageMethods -
too.many.privateMethods -
too.many.protectedMethods -
too.many.publicMethods
- Since:
- 5.3
-
Nested Class Summary
Nested classes/interfaces inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean
AutomaticBean.OutputStreamOptions -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringA key is pointing to the warning message text in "messages.properties" file.static final StringA key is pointing to the warning message text in "messages.properties" file.static final StringA key is pointing to the warning message text in "messages.properties" file.static final StringA key is pointing to the warning message text in "messages.properties" file.static final StringA key is pointing to the warning message text in "messages.properties" file. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionint[]The configurable token set.int[]Returns the default token a check is interested in.int[]The tokens that this check must be registered for.voidleaveToken(DetailAST ast) Called after all the child nodes have been process.voidsetMaxPackage(int value) Setter to specify the maximum number ofpackagemethods allowed.voidsetMaxPrivate(int value) Setter to specify the maximum number ofprivatemethods allowed.voidsetMaxProtected(int value) Setter to specify the maximum number ofprotectedmethods allowed.voidsetMaxPublic(int value) Setter to specify the maximum number ofpublicmethods allowed.voidsetMaxTotal(int value) Setter to specify the maximum number of methods allowed at all scope levels.voidvisitToken(DetailAST ast) Called to process a token.Methods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractCheck
beginTree, clearMessages, destroy, finishTree, getFileContents, getLine, getLines, getMessages, getTabWidth, getTokenNames, init, isCommentNodesRequired, log, log, log, setFileContents, setTabWidth, setTokensMethods inherited from class com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter
finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverityMethods inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean
configure, contextualize, getConfiguration, setupChild
-
Field Details
-
MSG_PRIVATE_METHODS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
MSG_PACKAGE_METHODS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
MSG_PROTECTED_METHODS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
MSG_PUBLIC_METHODS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
MSG_MANY_METHODS
A key is pointing to the warning message text in "messages.properties" file.- See Also:
-
-
Constructor Details
-
MethodCountCheck
public MethodCountCheck()
-
-
Method Details
-
getDefaultTokens
public int[] getDefaultTokens()Description copied from class:AbstractCheckReturns the default token a check is interested in. Only used if the configuration for a check does not define the tokens.- Specified by:
getDefaultTokensin classAbstractCheck- Returns:
- the default tokens
- See Also:
-
getAcceptableTokens
public int[] getAcceptableTokens()Description copied from class:AbstractCheckThe 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:
getAcceptableTokensin classAbstractCheck- Returns:
- the token set this check is designed for.
- See Also:
-
getRequiredTokens
public int[] getRequiredTokens()Description copied from class:AbstractCheckThe tokens that this check must be registered for.- Specified by:
getRequiredTokensin classAbstractCheck- Returns:
- the token set this must be registered for.
- See Also:
-
visitToken
Description copied from class:AbstractCheckCalled to process a token.- Overrides:
visitTokenin classAbstractCheck- Parameters:
ast- the token to process
-
leaveToken
Description copied from class:AbstractCheckCalled after all the child nodes have been process.- Overrides:
leaveTokenin classAbstractCheck- Parameters:
ast- the token leaving
-
setMaxPrivate
public void setMaxPrivate(int value) Setter to specify the maximum number ofprivatemethods allowed.- Parameters:
value- the maximum allowed.
-
setMaxPackage
public void setMaxPackage(int value) Setter to specify the maximum number ofpackagemethods allowed.- Parameters:
value- the maximum allowed.
-
setMaxProtected
public void setMaxProtected(int value) Setter to specify the maximum number ofprotectedmethods allowed.- Parameters:
value- the maximum allowed.
-
setMaxPublic
public void setMaxPublic(int value) Setter to specify the maximum number ofpublicmethods allowed.- Parameters:
value- the maximum allowed.
-
setMaxTotal
public void setMaxTotal(int value) Setter to specify the maximum number of methods allowed at all scope levels.- Parameters:
value- the maximum allowed.
-