edu.umd.cs.findbugs
Interface BugReporter

All Superinterfaces:

IClassObserver, IErrorLogger, RepositoryLookupFailureCallback

All Known Implementing Classes:

AbstractBugReporter, BugCollectionBugReporter, CategoryFilteringBugReporter, DelegatingBugReporter, EmacsBugReporter, ErrorCountingBugReporter, ExcludingHashesBugReporter, FilterBugReporter, HTMLBugReporter, PrintingBugReporter, SortingBugReporter, SwingGUIBugReporter, TextUIBugReporter, XDocsBugReporter, XMLBugReporter

public interface BugReporter
extends RepositoryLookupFailureCallback, IClassObserver

Generic interface for bug reporter objects. A BugReporter accumulates all of the information reported by the analyses, which includes bug reports, and also auxiliary information such as analysis errors, missing classes, and class to source file mapping.

Author:

David Hovemeyer

Field Summary

static int	NORMAL Normal error-reporting verbosity level.
static int	SILENT Silent error-reporting verbosity level.

Method Summary

void	addObserver(BugReporterObserver observer) Add an observer.
void	finish() Finish reporting bugs.
ProjectStats	getProjectStats() Get ProjectStats object used to store statistics about the overall project being analyzed.
BugReporter	getRealBugReporter() Get the real bug reporter at the end of a chain of delegating bug reporters.
void	reportBug(BugInstance bugInstance) Report a bug.
void	reportQueuedErrors() Report any accumulated error messages.
void	setErrorVerbosity(int level) Set the error-reporting verbosity level.
void	setPriorityThreshold(int threshold) Set the priority threshold.

Methods inherited from interface edu.umd.cs.findbugs.classfile.IErrorLogger

logError, logError, reportMissingClass, reportMissingClass, reportSkippedAnalysis

Methods inherited from interface edu.umd.cs.findbugs.classfile.IClassObserver

observeClass

Field Detail

SILENT

static final int SILENT

Silent error-reporting verbosity level.

See Also:

Constant Field Values

NORMAL

static final int NORMAL

Normal error-reporting verbosity level.

See Also:

Constant Field Values

Method Detail

setErrorVerbosity

void setErrorVerbosity(int level)

Set the error-reporting verbosity level.

Parameters:

level - the verbosity level

setPriorityThreshold

void setPriorityThreshold(int threshold)

Set the priority threshold.

Parameters:

threshold - bug instances must be at least as important as this priority to be reported

reportBug

void reportBug(@NonNull
               BugInstance bugInstance)

Report a bug. The implementation may report the bug immediately, or queue it for later.

Parameters:

bugInstance - object describing the bug instance

finish

void finish()

Finish reporting bugs. If any bug reports have been queued, calling this method will flush them.

reportQueuedErrors

void reportQueuedErrors()

Report any accumulated error messages.

addObserver

void addObserver(BugReporterObserver observer)

Add an observer.

Parameters:

observer - the observer

getProjectStats

ProjectStats getProjectStats()

Get ProjectStats object used to store statistics about the overall project being analyzed.

getRealBugReporter

BugReporter getRealBugReporter()

Get the real bug reporter at the end of a chain of delegating bug reporters. All non-delegating bug reporters should simply "return this".

Returns:

the real bug reporter at the end of the chain, or this object if there is no delegation