checkstyle:check
Full name:
org.apache.maven.plugins:maven-checkstyle-plugin:3.6.0:check
Description:
Performs Checkstyle analysis and outputs violations or a count of violations to the console, potentially failing the build. It can also be configured to re-use an earlier analysis.
Attributes:
- Requires a Maven project to be executed.
- The goal is thread-safe and supports parallel builds.
- Binds by default to the lifecycle phase:
verify
.
Required Parameters
Name | Type | Since | Description |
---|---|---|---|
<includeResources> |
boolean |
2.11 |
Whether to apply Checkstyle to resource directories. Default: true User Property: checkstyle.includeResources |
<includeTestResources> |
boolean |
2.11 |
Whether to apply Checkstyle to test resource directories. Default: true User Property: checkstyle.includeTestResources |
<includes> |
String |
- |
Specifies the names filter of the source files to be used for Checkstyle. Default: **\/*.java User Property: checkstyle.includes |
<resourceIncludes> |
String |
2.11 |
Specifies the names filter of the files to be used for Checkstyle when checking resources. Default: **/*.properties User Property: checkstyle.resourceIncludes |
Optional Parameters
Name | Type | Since | Description |
---|---|---|---|
<cacheFile> |
String |
- |
Specifies the cache file used to speed up Checkstyle on successive runs. Default: ${project.build.directory}/checkstyle-cachefile |
<checkstyleRules> |
PlexusConfiguration |
2.12 |
By using this property, you can specify the whole Checkstyle rules inline directly inside this pom.
<plugin> ... <configuration> <checkstyleRules> <module name="Checker"> <module name="FileTabCharacter"> <property name="eachLine" value="true" /> </module> <module name="TreeWalker"> <module name="EmptyBlock"/> </module> </module> </checkstyleRules> </configuration> ... |
<checkstyleRulesHeader> |
String |
- |
The header to use for the inline configuration. Only used when you specify checkstyleRules .Default: <?xml version="1.0"?>
<!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
"https://checkstyle.org/dtds/configuration_1_3.dtd">
|
<configLocation> |
String |
2.5 |
Specifies the location of the XML configuration to use. Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle Checker module) configuration of rulesets. This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the There are 2 predefined rulesets.
Default: sun_checks.xml User Property: checkstyle.config.location |
<consoleOutput> |
boolean |
- |
Output errors to console. Default: false User Property: checkstyle.consoleOutput |
<excludeGeneratedSources> |
boolean |
3.3.1 |
Specifies whether generated source files should be excluded from Checkstyle. Default: false User Property: checkstyle.excludeGeneratedSources |
<excludes> |
String |
- |
Specifies the names filter of the source files to be excluded for Checkstyle. User Property: checkstyle.excludes |
<failOnViolation> |
boolean |
- |
Fail the build on a violation. The goal checks for the violations after logging them (if logViolationsToConsole is true ). Compare this to failsOnError which fails the build immediately before examining the output log.Default: true User Property: checkstyle.failOnViolation |
<failsOnError> |
boolean |
- |
If this is true, and Checkstyle reported any violations or errors, the build fails immediately after running Checkstyle, before checking the log for logViolationsToConsole . If you want to use logViolationsToConsole , use failOnViolation instead of this.Default: false |
<headerLocation> |
String |
2.0-beta-2 |
Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header. You need to use For instance: <module name="RegexpHeader"> <property name="headerFile" value="${checkstyle.header.file}"/> </module> Default: LICENSE.txt User Property: checkstyle.header.file |
<includeTestSourceDirectory> |
boolean |
2.2 |
Include or not the test source directory to be used for Checkstyle. Default: false |
<inputEncoding> |
String |
2.2 |
The file encoding to use when reading the source files. If the property project.build.sourceEncoding is not set, the platform default encoding is used. Note: This parameter always overrides the property charset from Checkstyle's TreeWalker module.Default: ${project.build.sourceEncoding} User Property: encoding |
<logViolationCountToConsole> |
boolean |
3.0.1 |
Output the detected violation count to the console. Default: true User Property: checkstyle.logViolationCount |
<logViolationsToConsole> |
boolean |
2.3 |
Output the detected violations to the console. Default: true User Property: checkstyle.console |
<maxAllowedViolations> |
int |
2.3 |
The maximum number of allowed violations. The execution fails only if the number of violations is above this limit. Default: 0 User Property: checkstyle.maxAllowedViolations |
<omitIgnoredModules> |
boolean |
3.0.0 |
Specifies whether modules with a configured severity of ignore should be omitted during Checkstyle invocation.Default: false |
<outputFile> |
File |
- |
Specifies the path and filename to save the Checkstyle output. The format of the output file is determined by the outputFileFormat parameter.Default: ${project.build.directory}/checkstyle-result.xml User Property: checkstyle.output.file |
<outputFileFormat> |
String |
- |
Specifies the format of the output to be used when writing to the output file. Valid values are "plain ", "sarif " and "xml ".Default: xml User Property: checkstyle.output.format |
<propertiesLocation> |
String |
2.5 |
Specifies the location of the properties file. This parameter is resolved as URL, File then resource. If successfully resolved, the contents of the properties location is copied into the The contents of the User Property: checkstyle.properties.location |
<propertyExpansion> |
String |
- |
Allows for specifying raw property expansion information. |
<resourceExcludes> |
String |
2.11 |
Specifies the names filter of the files to be excluded for Checkstyle when checking resources. User Property: checkstyle.resourceExcludes |
<rulesFiles> |
File |
- |
Dump file for inlined Checkstyle rules. Default: ${project.build.directory}/checkstyle-rules.xml User Property: checkstyle.output.rules.file |
<skip> |
boolean |
2.2 |
Skip entire check. Default: false User Property: checkstyle.skip |
<skipExec> |
boolean |
2.5 |
Skip Checkstyle execution will only scan the outputFile. Default: false User Property: checkstyle.skipExec |
<sourceDirectories> |
List<String> |
2.13 |
Specifies the location of the source directories to be used for Checkstyle. Default value is ${project.compileSourceRoots} . |
<sourceDirectory> |
File |
- |
Deprecated. instead use sourceDirectories . For version 3.0.0, this parameter is only defined to break the build if you use it!Specifies the location of the source directory to be used for Checkstyle. |
<suppressionsFileExpression> |
String |
2.1 |
The key to be used in the properties for the suppressions file. Default: checkstyle.suppressions.file User Property: checkstyle.suppression.expression |
<suppressionsLocation> |
String |
2.0-beta-2 |
Specifies the location of the suppressions XML file to use. This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the suppressions XML is copied into the See User Property: checkstyle.suppressions.location |
<testSourceDirectories> |
List<String> |
2.13 |
Specifies the location of the test source directories to be used for Checkstyle. Default value is ${project.testCompileSourceRoots} . |
<testSourceDirectory> |
File |
2.2 |
Deprecated. instead use testSourceDirectories . For version 3.0.0, this parameter is only defined to break the build if you use it!Specifies the location of the test source directory to be used for Checkstyle. |
<useFile> |
File |
- |
If null , the Checkstyle plugin will display violations on stdout. Otherwise, a text file will be created with the violations. |
<violationIgnore> |
String |
2.13 |
Violations to ignore. This is a comma-separated list, each value being either a rule name, a rule category or a java package name of rule class. User Property: checkstyle.violation.ignore |
<violationSeverity> |
String |
2.2 |
The lowest severity level that is considered a violation. Valid values are "error ", "warning " and "info ".Default: error User Property: checkstyle.violationSeverity |
Parameter Details
<cacheFile>
- Type:
java.lang.String
- Required:
No
- Default:
${project.build.directory}/checkstyle-cachefile
<checkstyleRules>
<plugin> ... <configuration> <checkstyleRules> <module name="Checker"> <module name="FileTabCharacter"> <property name="eachLine" value="true" /> </module> <module name="TreeWalker"> <module name="EmptyBlock"/> </module> </module> </checkstyleRules> </configuration> ...
- Type:
org.codehaus.plexus.configuration.PlexusConfiguration
- Since:
2.12
- Required:
No
<checkstyleRulesHeader>
checkstyleRules
.- Type:
java.lang.String
- Required:
No
- Default:
<?xml version="1.0"?> <!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN" "https://checkstyle.org/dtds/configuration_1_3.dtd">
<configLocation>
Specifies the location of the XML configuration to use.
Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle Checker module) configuration of rulesets.
This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory}/checkstyle-configuration.xml
file before being passed to Checkstyle as a configuration.
There are 2 predefined rulesets.
sun_checks.xml
: Sun Checks.google_checks.xml
: Google Checks.
- Type:
java.lang.String
- Since:
2.5
- Required:
No
- User Property:
checkstyle.config.location
- Default:
sun_checks.xml
<consoleOutput>
- Type:
boolean
- Required:
No
- User Property:
checkstyle.consoleOutput
- Default:
false
<excludeGeneratedSources>
- Type:
boolean
- Since:
3.3.1
- Required:
No
- User Property:
checkstyle.excludeGeneratedSources
- Default:
false
<excludes>
- Type:
java.lang.String
- Required:
No
- User Property:
checkstyle.excludes
<failOnViolation>
logViolationsToConsole
is true
). Compare this to failsOnError
which fails the build immediately before examining the output log.- Type:
boolean
- Required:
No
- User Property:
checkstyle.failOnViolation
- Default:
true
<failsOnError>
logViolationsToConsole
. If you want to use logViolationsToConsole
, use failOnViolation
instead of this.- Type:
boolean
- Required:
No
- Default:
false
<headerLocation>
Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header.
You need to use ${checkstyle.header.file}
in your Checkstyle xml configuration to reference the name of this header file.
For instance:
<module name="RegexpHeader"> <property name="headerFile" value="${checkstyle.header.file}"/> </module>
- Type:
java.lang.String
- Since:
2.0-beta-2
- Required:
No
- User Property:
checkstyle.header.file
- Default:
LICENSE.txt
<includeResources>
- Type:
boolean
- Since:
2.11
- Required:
Yes
- User Property:
checkstyle.includeResources
- Default:
true
<includeTestResources>
- Type:
boolean
- Since:
2.11
- Required:
Yes
- User Property:
checkstyle.includeTestResources
- Default:
true
<includeTestSourceDirectory>
- Type:
boolean
- Since:
2.2
- Required:
No
- Default:
false
<includes>
- Type:
java.lang.String
- Required:
Yes
- User Property:
checkstyle.includes
- Default:
**\/*.java
<inputEncoding>
project.build.sourceEncoding
is not set, the platform default encoding is used. Note: This parameter always overrides the property charset
from Checkstyle's TreeWalker
module.- Type:
java.lang.String
- Since:
2.2
- Required:
No
- User Property:
encoding
- Default:
${project.build.sourceEncoding}
<logViolationCountToConsole>
- Type:
boolean
- Since:
3.0.1
- Required:
No
- User Property:
checkstyle.logViolationCount
- Default:
true
<logViolationsToConsole>
- Type:
boolean
- Since:
2.3
- Required:
No
- User Property:
checkstyle.console
- Default:
true
<maxAllowedViolations>
- Type:
int
- Since:
2.3
- Required:
No
- User Property:
checkstyle.maxAllowedViolations
- Default:
0
<omitIgnoredModules>
ignore
should be omitted during Checkstyle invocation.- Type:
boolean
- Since:
3.0.0
- Required:
No
- Default:
false
<outputFile>
outputFileFormat
parameter.- Type:
java.io.File
- Required:
No
- User Property:
checkstyle.output.file
- Default:
${project.build.directory}/checkstyle-result.xml
<outputFileFormat>
plain
", "sarif
" and "xml
".- Type:
java.lang.String
- Required:
No
- User Property:
checkstyle.output.format
- Default:
xml
<propertiesLocation>
Specifies the location of the properties file.
This parameter is resolved as URL, File then resource. If successfully resolved, the contents of the properties location is copied into the ${project.build.directory}/checkstyle-checker.properties
file before being passed to Checkstyle for loading.
The contents of the propertiesLocation
will be made available to Checkstyle for specifying values for parameters within the xml configuration (specified in the configLocation
parameter).
- Type:
java.lang.String
- Since:
2.5
- Required:
No
- User Property:
checkstyle.properties.location
<propertyExpansion>
- Type:
java.lang.String
- Required:
No
<resourceExcludes>
- Type:
java.lang.String
- Since:
2.11
- Required:
No
- User Property:
checkstyle.resourceExcludes
<resourceIncludes>
- Type:
java.lang.String
- Since:
2.11
- Required:
Yes
- User Property:
checkstyle.resourceIncludes
- Default:
**/*.properties
<rulesFiles>
- Type:
java.io.File
- Required:
No
- User Property:
checkstyle.output.rules.file
- Default:
${project.build.directory}/checkstyle-rules.xml
<skip>
- Type:
boolean
- Since:
2.2
- Required:
No
- User Property:
checkstyle.skip
- Default:
false
<skipExec>
- Type:
boolean
- Since:
2.5
- Required:
No
- User Property:
checkstyle.skipExec
- Default:
false
<sourceDirectories>
${project.compileSourceRoots}
.- Type:
java.util.List<java.lang.String>
- Since:
2.13
- Required:
No
<sourceDirectory>
instead use
sourceDirectories
. For version 3.0.0, this parameter is only defined to break the build if you use it!- Type:
java.io.File
- Required:
No
<suppressionsFileExpression>
- Type:
java.lang.String
- Since:
2.1
- Required:
No
- User Property:
checkstyle.suppression.expression
- Default:
checkstyle.suppressions.file
<suppressionsLocation>
Specifies the location of the suppressions XML file to use.
This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the suppressions XML is copied into the ${project.build.directory}/checkstyle-suppressions.xml
file before being passed to Checkstyle for loading.
See suppressionsFileExpression
for the property that will be made available to your Checkstyle configuration.
- Type:
java.lang.String
- Since:
2.0-beta-2
- Required:
No
- User Property:
checkstyle.suppressions.location
<testSourceDirectories>
${project.testCompileSourceRoots}
.- Type:
java.util.List<java.lang.String>
- Since:
2.13
- Required:
No
<testSourceDirectory>
instead use
testSourceDirectories
. For version 3.0.0, this parameter is only defined to break the build if you use it!- Type:
java.io.File
- Since:
2.2
- Required:
No
<useFile>
null
, the Checkstyle plugin will display violations on stdout. Otherwise, a text file will be created with the violations.- Type:
java.io.File
- Required:
No
<violationIgnore>
- Type:
java.lang.String
- Since:
2.13
- Required:
No
- User Property:
checkstyle.violation.ignore
<violationSeverity>
error
", "warning
" and "info
".- Type:
java.lang.String
- Since:
2.2
- Required:
No
- User Property:
checkstyle.violationSeverity
- Default:
error