findbugs:findbugs

Note:This goal should be used as a Maven report.

Full name:

org.codehaus.mojo:findbugs-maven-plugin:2.3.1:findbugs

Description:

Generates a FindBugs Report when the site plugin is run. The HTML report is generated for site commands only. To see more documentation about FindBugs' options, please see the FindBugs Manual.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • Invokes the execution of the lifecycle phase compile prior to executing itself.

Required Parameters

Name Type Since Description
classFilesDirectory File - Directory containing the class files for FindBugs to analyze.
Default value is: ${project.build.outputDirectory}.
findbugsXmlOutputDirectory File 1.2.0 Specifies the directory where the findbugs native xml output will be generated.
Default value is: ${project.build.directory}.
outputDirectory File - Location where generated html will be created.
Default value is: ${project.reporting.outputDirectory}.
testClassFilesDirectory File - Directory containing the test class files for FindBugs to analyze.
Default value is: ${project.build.testOutputDirectory}.
xmlOutputDirectory File 1.0.0 Specifies the directory where the xml output will be generated.
Default value is: ${project.build.directory}.

Optional Parameters

Name Type Since Description
debug Boolean - turn on Findbugs debugging
Default value is: false.
effort String 1.0-beta-1 Effort of the bug finders. Valid values are Min, Default and Max.
Default value is: Default.
excludeFilterFile String 1.0-beta-1

File name of the exclude filter. Bugs matching the filters are not reported.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a filter file.
failOnError boolean 2.0 Fail the build on an error.
Default value is: true.
findbugsXmlOutput boolean 1.2.0 Turn on and off findbugs native xml output of the Findbugs report.
Default value is: false.
includeFilterFile String 1.0-beta-1

File name of the include filter. Only bugs in matching the filters are reported.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a filter file.
includeTests boolean 2.0 Run Findbugs on the tests.
Default value is: false.
maxHeap int 2.2 Maximum Java heap size in megabytes (default=512).
Default value is: 512.
omitVisitors String 1.0-beta-1 The visitor list to omit. This is a comma-delimited list.
onlyAnalyze String 1.1 Restrict analysis to the given comma-separated list of classes and packages.
outputEncoding String 2.2 The file encoding to use when creating the HTML reports. If the property project.reporting.outputEncoding is not set, the platform default encoding is used.
Default value is: ${project.reporting.outputEncoding}.
pluginList String 1.0-beta-1

The plugin list to include in the report. This is a comma-delimited list.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a plugin file.
relaxed Boolean 1.1 Relaxed reporting mode. For many detectors, this option suppresses the heuristics used to avoid reporting false positives.
Default value is: false.
skip boolean 1.1 Skip entire check.
Default value is: false.
sourceEncoding 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.
Default value is: ${project.build.sourceEncoding}.
threshold String - Threshold of minimum bug severity to report. Valid values are High, Default, Low, Ignore, and Exp (for experimental).
Default value is: Default.
timeout int 2.2 Specifies the amount of time, in milliseconds, that FindBugs may run before it is assumed to be hung and is terminated. The default is 600,000 milliseconds, which is ten minutes.
Default value is: 600000.
visitors String 1.0-beta-1 The visitor list to run. This is a comma-delimited list.
xmlOutput boolean 1.0.0 Turn on and off xml output of the Findbugs report.
Default value is: false.
xrefLocation File - Location of the Xrefs to link to.
Default value is: ${project.reporting.outputDirectory}/xref.
xrefTestLocation File - Location of the Test Xrefs to link to.
Default value is: ${project.reporting.outputDirectory}/xref-test.

Parameter Details

classFilesDirectory:

Directory containing the class files for FindBugs to analyze.
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.build.outputDirectory}

debug:

turn on Findbugs debugging
  • Type: java.lang.Boolean
  • Required: No
  • Default: false

effort:

Effort of the bug finders. Valid values are Min, Default and Max.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Default: Default

excludeFilterFile:

File name of the exclude filter. Bugs matching the filters are not reported.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a filter file.

  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No

failOnError:

Fail the build on an error.
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Default: true

findbugsXmlOutput:

Turn on and off findbugs native xml output of the Findbugs report.
  • Type: boolean
  • Since: 1.2.0
  • Required: No
  • Default: false

findbugsXmlOutputDirectory:

Specifies the directory where the findbugs native xml output will be generated.
  • Type: java.io.File
  • Since: 1.2.0
  • Required: Yes
  • Default: ${project.build.directory}

includeFilterFile:

File name of the include filter. Only bugs in matching the filters are reported.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a filter file.

  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No

includeTests:

Run Findbugs on the tests.
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Default: false

maxHeap:

Maximum Java heap size in megabytes (default=512).
  • Type: int
  • Since: 2.2
  • Required: No
  • Default: 512

omitVisitors:

The visitor list to omit. This is a comma-delimited list.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No

onlyAnalyze:

Restrict analysis to the given comma-separated list of classes and packages.
  • Type: java.lang.String
  • Since: 1.1
  • Required: No

outputDirectory:

Location where generated html will be created.
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.reporting.outputDirectory}

outputEncoding:

The file encoding to use when creating the HTML reports. If the property project.reporting.outputEncoding is not set, the platform default encoding is used.
  • Type: java.lang.String
  • Since: 2.2
  • Required: No
  • Expression: ${outputEncoding}
  • Default: ${project.reporting.outputEncoding}

pluginList:

The plugin list to include in the report. This is a comma-delimited list.

Potential values are a filesystem path, a URL, or a classpath resource.

This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the ${project.build.directory} directory before being passed to Findbugs as a plugin file.

  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No

relaxed:

Relaxed reporting mode. For many detectors, this option suppresses the heuristics used to avoid reporting false positives.
  • Type: java.lang.Boolean
  • Since: 1.1
  • Required: No
  • Default: false

skip:

Skip entire check.
  • Type: boolean
  • Since: 1.1
  • Required: No
  • Expression: ${findbugs.skip}
  • Default: false

sourceEncoding:

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.
  • Type: java.lang.String
  • Since: 2.2
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

testClassFilesDirectory:

Directory containing the test class files for FindBugs to analyze.
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.build.testOutputDirectory}

threshold:

Threshold of minimum bug severity to report. Valid values are High, Default, Low, Ignore, and Exp (for experimental).
  • Type: java.lang.String
  • Required: No
  • Default: Default

timeout:

Specifies the amount of time, in milliseconds, that FindBugs may run before it is assumed to be hung and is terminated. The default is 600,000 milliseconds, which is ten minutes.
  • Type: int
  • Since: 2.2
  • Required: No
  • Default: 600000

visitors:

The visitor list to run. This is a comma-delimited list.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No

xmlOutput:

Turn on and off xml output of the Findbugs report.
  • Type: boolean
  • Since: 1.0.0
  • Required: No
  • Default: false

xmlOutputDirectory:

Specifies the directory where the xml output will be generated.
  • Type: java.io.File
  • Since: 1.0.0
  • Required: Yes
  • Default: ${project.build.directory}

xrefLocation:

Location of the Xrefs to link to.
  • Type: java.io.File
  • Required: No
  • Default: ${project.reporting.outputDirectory}/xref

xrefTestLocation:

Location of the Test Xrefs to link to.
  • Type: java.io.File
  • Required: No
  • Default: ${project.reporting.outputDirectory}/xref-test