public abstract class AbstractIncrementingRenderer extends AbstractRenderer
Renderer
implementations which can produce
output incrementally for RuleViolation
s as source files are
processed. Such Renderer
s are able to produce large reports with
significantly less working memory at any given time. Variations in the
delivery of source file reports are reflected in the output of the
Renderer
, so report output can be different between runs.
Only processing errors and suppressed violations are accumulated across all
files. These are intended to be processed in the end()
method.Modifier and Type | Field and Description |
---|---|
protected List<Report.ProcessingError> |
errors
Accumulated processing errors.
|
protected List<Report.SuppressedViolation> |
suppressed
Accumulated suppressed violations.
|
description, name, propertyDefinitions, showSuppressedViolations, writer
propertyDescriptors, propertyValuesByDescriptor
Constructor and Description |
---|
AbstractIncrementingRenderer(String name,
String description) |
Modifier and Type | Method and Description |
---|---|
void |
end()
This method is at the very end of the Rendering process, after
Renderer.renderFileReport(Report) . |
void |
renderFileReport(Report report)
Render the given file Report.
|
abstract void |
renderFileViolations(Iterator<RuleViolation> violations)
Render a series of
RuleViolation s. |
void |
start()
This method is called before any source files are processed.
|
void |
startFileAnalysis(DataSource dataSource)
This method is called each time a source file is processed.
|
defineProperty, flush, getDescription, getName, getPropertyDefinitions, getWriter, isShowSuppressedViolations, setDescription, setName, setShowSuppressedViolations, setWriter
copyPropertyDescriptors, copyPropertyValues, definePropertyDescriptor, dysfunctionReason, getPropertiesByPropertyDescriptor, getProperty, getPropertyDescriptor, getPropertyDescriptors, hasDescriptor, ignoredProperties, setProperty, useDefaultValueFor, usesDefaultValues
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
defaultFileExtension
definePropertyDescriptor, dysfunctionReason, getPropertiesByPropertyDescriptor, getProperty, getPropertyDescriptor, getPropertyDescriptors, hasDescriptor, ignoredProperties, setProperty, useDefaultValueFor, usesDefaultValues
protected List<Report.ProcessingError> errors
protected List<Report.SuppressedViolation> suppressed
public void start() throws IOException
IOException
public void startFileAnalysis(DataSource dataSource)
Renderer.start()
, but before
Renderer.renderFileReport(Report)
and Renderer.end()
.
This method may be invoked by different threads which are processing
files independently. Therefore, any non-trivial implementation of this
method needs to be thread-safe.dataSource
- The source file.public void renderFileReport(Report report) throws IOException
Renderer.start()
and
Renderer.startFileAnalysis(DataSource)
, but before Renderer.end()
.report
- A file Report.IOException
Report
public abstract void renderFileViolations(Iterator<RuleViolation> violations) throws IOException
RuleViolation
s.violations
- The iterator of violations to render.IOException
public void end() throws IOException
Renderer.renderFileReport(Report)
.IOException
Copyright © 2002-2017 PMD. All Rights Reserved.