Class FindBugsTask

  • All Implemented Interfaces:
    java.lang.Cloneable

    public class FindBugsTask
    extends AbstractFindBugsTask
    FindBugs in Java class files. This task can take the following arguments:
    • adjustExperimental (boolean default false)
    • adjustPriority (passed to -adjustPriority)
    • applySuppression (exclude any warnings that match a suppression filter supplied in a project file)
    • auxAnalyzepath (class, jar, zip files or directories containing classes to analyze)
    • auxClasspath (classpath or classpathRef)
    • baselineBugs (xml file containing baseline bugs)
    • class (class, jar, zip or directory containing classes to analyze)
    • classpath (classpath for running FindBugs)
    • cloud (cloud id)
    • conserveSpace (boolean - default false)
    • debug (boolean default false)
    • effort (enum min|default|max)
    • excludeFilter (filter filename)
    • failOnError (boolean - default false)
    • home (findbugs install dir)
    • includeFilter (filter filename)
    • maxRank (maximum rank issue to be reported)
    • jvm (Set the command used to start the VM)
    • jvmargs (any additional jvm arguments)
    • omitVisitors (collection - comma seperated)
    • onlyAnalyze (restrict analysis to find bugs to given comma-separated list of classes and packages - See the textui argument description for details)
    • output (enum text|xml|xml:withMessages|html - default xml)
    • outputFile (name of output file to create)
    • nested (boolean default true)
    • noClassOk (boolean default false)
    • pluginList (list of plugin Jar files to load)
    • projectFile (project filename)
    • projectName (project name, for display in generated HTML)
    • userPrefs (user preferences filename)
    • quietErrors (boolean - default false)
    • relaxed (boolean - default false)
    • reportLevel (enum experimental|low|medium|high)
    • sort (boolean default true)
    • stylesheet (name of stylesheet to generate HTML: default is "default.xsl")
    • systemProperty (a system property to set)
    • timestampNow (boolean - default false)
    • visitors (collection - comma seperated)
    • chooseVisitors (selectively enable/disable visitors)
    • workHard (boolean default false)
    • setSetExitCode (boolean default true)
    Of these arguments, the home is required. projectFile is required if nested <class> or <auxAnalyzepath> elements are not specified. the <class> tag defines the location of either a class, jar file, zip file, or directory containing classes.

    Since:
    Ant 1.5
    Version:
    $Revision: 1.56 $
    Author:
    Mike Fagan mfagan@tde.com, Michael Tamm mail@michaeltamm.de, Scott Wolk
    • Constructor Detail

      • FindBugsTask

        public FindBugsTask()
    • Method Detail

      • setWorkHard

        public void setWorkHard​(boolean workHard)
        Set the workHard flag.
        Parameters:
        workHard - true if we want findbugs to run with workHard option enabled
      • setSetExitCode

        public void setSetExitCode​(boolean setExitCode)
        Set the exit code flag.
        Parameters:
        setExitCode - If true then the exit code will be returned to the main ant job
      • setNested

        public void setNested​(boolean nested)
        Set the nested flag.
        Parameters:
        nested - This option enables or disables scanning of nested jar and zip files found in the list of files and directories to be analyzed. By default, scanning of nested jar/zip files is enabled
      • setNoClassOk

        public void setNoClassOk​(boolean noClassOk)
        Set the noClassOk flag.
        Parameters:
        noClassOk - true if we should generate no-error output if no classfiles are specified
      • setRelaxed

        public void setRelaxed​(boolean relaxed)
        Set the relaxed flag.
        Parameters:
        relaxed - true if we want findbugs to run with relaxed option enabled
      • setAdjustExperimental

        public void setAdjustExperimental​(boolean adjustExperimental)
        Set the adjustExperimental flag
        Parameters:
        adjustExperimental - true if we want experimental bug patterns to have lower priority
      • setAdjustPriority

        public void setAdjustPriority​(java.lang.String adjustPriorityString)
      • setVisitors

        public void setVisitors​(java.lang.String commaSeperatedString)
        Set the specific visitors to use
      • setChooseVisitors

        public void setChooseVisitors​(java.lang.String commaSeperatedString)
        Set the specific visitors to use
      • setOmitVisitors

        public void setOmitVisitors​(java.lang.String commaSeperatedString)
        Set the specific visitors to use
      • setOutput

        public void setOutput​(java.lang.String format)
        Set the output format
      • setStylesheet

        public void setStylesheet​(java.lang.String stylesheet)
        Set the stylesheet filename for HTML generation.
      • setReportLevel

        public void setReportLevel​(java.lang.String level)
        Set the report level
      • setSort

        public void setSort​(boolean flag)
        Set the sorted flag
      • setTimestampNow

        public void setTimestampNow​(boolean flag)
        Set the timestampNow flag
      • setQuietErrors

        public void setQuietErrors​(boolean flag)
        Set the quietErrors flag
      • setApplySuppression

        public void setApplySuppression​(boolean flag)
        Set the quietErrors flag
      • setWarningsProperty

        public void setWarningsProperty​(java.lang.String name)
        Tells this task to set the property with the given name to "true" when bugs were found.
      • setEffort

        public void setEffort​(java.lang.String effort)
        Set effort level.
        Parameters:
        effort - the effort level
      • setCloud

        public void setCloud​(java.lang.String cloudId)
      • setMaxRank

        public void setMaxRank​(int maxRank)
      • setProjectName

        public void setProjectName​(java.lang.String projectName)
        Set project name
        Parameters:
        projectName - the project name
      • setConserveSpace

        public void setConserveSpace​(boolean flag)
        Set the conserveSpace flag.
      • setExcludeFilter

        public void setExcludeFilter​(java.io.File filterFile)
        Set the exclude filter file
      • setIncludeFilter

        public void setIncludeFilter​(java.io.File filterFile)
        Set the exclude filter file
      • setBaselineBugs

        public void setBaselineBugs​(java.io.File baselineBugs)
        Set the exclude filter file
      • setProjectFile

        public void setProjectFile​(java.io.File projectFile)
        Set the project file
      • setUserPreferencesFile

        public void setUserPreferencesFile​(java.io.File userPreferencesFile)
        Set the project file
      • setAuxClasspath

        public void setAuxClasspath​(org.apache.tools.ant.types.Path src)
        the auxclasspath to use.
      • createAuxClasspath

        public org.apache.tools.ant.types.Path createAuxClasspath()
        Path to use for auxclasspath.
      • setAuxClasspathRef

        public void setAuxClasspathRef​(org.apache.tools.ant.types.Reference r)
        Adds a reference to a sourcepath defined elsewhere.
      • setAuxAnalyzepath

        public void setAuxAnalyzepath​(org.apache.tools.ant.types.Path src)
        the auxAnalyzepath to use.
      • createAuxAnalyzepath

        public org.apache.tools.ant.types.Path createAuxAnalyzepath()
        Path to use for auxAnalyzepath.
      • setAuxAnalyzepathRef

        public void setAuxAnalyzepathRef​(org.apache.tools.ant.types.Reference r)
        Adds a reference to a sourcepath defined elsewhere.
      • setSourcePath

        public void setSourcePath​(org.apache.tools.ant.types.Path src)
        the sourcepath to use.
      • createSourcePath

        public org.apache.tools.ant.types.Path createSourcePath()
        Path to use for sourcepath.
      • setSourcePathRef

        public void setSourcePathRef​(org.apache.tools.ant.types.Reference r)
        Adds a reference to a source path defined elsewhere.
      • setOutputFile

        public void setOutputFile​(java.lang.String outputFileName)
        Set name of output file.
      • setOnlyAnalyze

        public void setOnlyAnalyze​(java.lang.String filter)
        Set the packages or classes to analyze
      • addFileset

        public void addFileset​(org.apache.tools.ant.types.FileSet fs)
        Add a nested fileset of classes or jar files.