com.puppycrawl.tools.checkstyle.filters

Class SuppressFilterElement

java.lang.Object

com.puppycrawl.tools.checkstyle.filters.SuppressFilterElement

All Implemented Interfaces:

Filter

public class SuppressFilterElement
extends Object
implements Filter

This filter element is immutable and processes AuditEvent objects based on the criteria of file, check, module id, line, and column. It rejects an AuditEvent if the following match:

• the event's file name; and
• the check name or the module identifier; and
• (optionally) the event's line is in the filter's line CSV; and
• (optionally) the check's columns is in the filter's column CSV.

Field Summary

Fields

Modifier and Type	Field and Description
private String	checkPattern The pattern for check class names.
private Pattern	checkRegexp The regexp to match check names against.
private CsvFilterElement	columnFilter Column number filter.
private String	columnsCsv CSV for column number filter.
private String	filePattern The pattern for file names.
private Pattern	fileRegexp The regexp to match file names against.
private CsvFilterElement	lineFilter Line number filter.
private String	linesCsv CSV for line number filter.
private String	messagePattern The pattern for message names.
private Pattern	messageRegexp The regexp to match message names against.
private String	moduleId Module id filter.

Constructor Summary

Constructors

Constructor and Description
SuppressFilterElement(Pattern files, Pattern checks, Pattern message, String moduleId, String lines, String columns) Creates a SuppressFilterElement instance.
SuppressFilterElement(String files, String checks, String message, String modId, String lines, String columns) Constructs a SuppressFilterElement for a file name pattern.

Method Summary

Modifier and Type	Method and Description
boolean	accept(AuditEvent event) Determines whether or not a filtered AuditEvent is accepted.
boolean	equals(Object other)
int	hashCode()
private boolean	isFileNameAndModuleNameMatching(AuditEvent event) Is matching by file name, module id, and Check name.
private boolean	isLineAndColumnMatching(AuditEvent event) Whether line and column match.
private boolean	isMessageNameMatching(AuditEvent event) Is matching by message.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

fileRegexp

private final Pattern fileRegexp

The regexp to match file names against.

filePattern

private final String filePattern

The pattern for file names.

checkRegexp

private final Pattern checkRegexp

The regexp to match check names against.

checkPattern

private final String checkPattern

The pattern for check class names.

messageRegexp

private final Pattern messageRegexp

The regexp to match message names against.

messagePattern

private final String messagePattern

The pattern for message names.

moduleId

private final String moduleId

Module id filter.

lineFilter

private final CsvFilterElement lineFilter

Line number filter.

linesCsv

private final String linesCsv

CSV for line number filter.

columnFilter

private final CsvFilterElement columnFilter

Column number filter.

columnsCsv

private final String columnsCsv

CSV for column number filter.

Constructor Detail

SuppressFilterElement

public SuppressFilterElement(String files,
                             String checks,
                             String message,
                             String modId,
                             String lines,
                             String columns)

Constructs a SuppressFilterElement for a file name pattern.

Parameters:

files - regular expression for names of filtered files.

checks - regular expression for filtered check classes.

message - regular expression for messages.

modId - the id

lines - lines CSV values and ranges for line number filtering.

columns - columns CSV values and ranges for column number filtering.

SuppressFilterElement

public SuppressFilterElement(Pattern files,
                             Pattern checks,
                             Pattern message,
                             String moduleId,
                             String lines,
                             String columns)

Creates a SuppressFilterElement instance.

Parameters:

files - regular expression for filtered file names

checks - regular expression for filtered check classes

message - regular expression for messages.

moduleId - the module id

lines - CSV for lines

columns - CSV for columns

Method Detail

accept

public boolean accept(AuditEvent event)

Description copied from interface: Filter

Determines whether or not a filtered AuditEvent is accepted.

Specified by:

accept in interface Filter

Parameters:

event - the AuditEvent to filter.

Returns:

true if the event is accepted.

isFileNameAndModuleNameMatching

private boolean isFileNameAndModuleNameMatching(AuditEvent event)

Is matching by file name, module id, and Check name.

Parameters:

event - event

Returns:

true if it is matching

isMessageNameMatching

private boolean isMessageNameMatching(AuditEvent event)

Is matching by message.

Parameters:

event - event

Returns:

true if it is matching or not set.

isLineAndColumnMatching

private boolean isLineAndColumnMatching(AuditEvent event)

Whether line and column match.

Parameters:

event - event to process.

Returns:

true if line and column are matching or not set.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object