PmdExtension

API Documentation:PmdExtension

Configuration options for the PMD plugin.

Properties

PropertyDescription
consoleOutput

Whether or not to write PMD results to System.out.

ignoreFailures

Whether to allow the build to continue if there are warnings. Example: ignoreFailures = true

reportsDir

The directory where reports will be generated.

rulePriority

The rule priority threshold; violations for rules with a lower priority will not be reported. Default value is 5, which means that all violations will be reported. This is equivalent to PMD's Ant task minimumPriority property. See the official documentation for the list of priorities.

ruleSetConfig

The custom rule set to be used (if any). Replaces ruleSetFiles, except that it does not currently support multiple rule sets. See the official documentation for how to author a rule set.

ruleSetFiles

The custom rule set files to be used. See the official documentation for how to author a rule set file. If you want to only use custom rule sets, you must clear ruleSets.

ruleSets

The built-in rule sets to be used. See the official list of built-in rule sets.

sourceSets

The source sets to be analyzed as part of the check and build tasks.

targetJdk

The target jdk to use with pmd, 1.3, 1.4, 1.5, 1.6, 1.7 or jsp

toolVersion

The version of the code quality tool to be used.

Methods

MethodDescription
ruleSetFiles(ruleSetFiles)

Convenience method for adding rule set files.

ruleSets(ruleSets)

Convenience method for adding rule sets.

Script blocks

No script blocks

Property details

boolean consoleOutput

Whether or not to write PMD results to System.out.

Default:
false

boolean ignoreFailures

Whether to allow the build to continue if there are warnings. Example: ignoreFailures = true

File reportsDir

The directory where reports will be generated.

int rulePriority

The rule priority threshold; violations for rules with a lower priority will not be reported. Default value is 5, which means that all violations will be reported. This is equivalent to PMD's Ant task minimumPriority property. See the official documentation for the list of priorities.

rulePriority = 3
Default:
5

TextResource ruleSetConfig

The custom rule set to be used (if any). Replaces ruleSetFiles, except that it does not currently support multiple rule sets. See the official documentation for how to author a rule set.

ruleSetConfig = resources.text.fromFile("config/pmd/myRuleSet.xml")
Default:
null

FileCollection ruleSetFiles

The custom rule set files to be used. See the official documentation for how to author a rule set file. If you want to only use custom rule sets, you must clear ruleSets.

ruleSetFiles = files("config/pmd/myRuleSet.xml")
Default:
[]

List<String> ruleSets

The built-in rule sets to be used. See the official list of built-in rule sets.

ruleSets = ["category/java/errorprone.xml", "category/java/bestpractices.xml"]
Default:
["category/java/errorprone.xml"]

Collection<SourceSet> sourceSets

The source sets to be analyzed as part of the check and build tasks.

Default:
project.sourceSets

TargetJdk targetJdk

The target jdk to use with pmd, 1.3, 1.4, 1.5, 1.6, 1.7 or jsp

Default:
project.sourceCompatibility

String toolVersion

The version of the code quality tool to be used.

Method details

void ruleSetFiles(Object... ruleSetFiles)

Convenience method for adding rule set files.

ruleSetFiles "config/pmd/myRuleSet.xml"

void ruleSets(String... ruleSets)

Convenience method for adding rule sets.

ruleSets "category/java/errorprone.xml", "category/java/bestpractices.xml"