com.puppycrawl.tools.checkstyle.filters

Class SuppressWithNearbyCommentFilter

java.lang.Object

com.puppycrawl.tools.checkstyle.api.AutomaticBean

com.puppycrawl.tools.checkstyle.filters.SuppressWithNearbyCommentFilter

All Implemented Interfaces:

Configurable, Contextualizable, Filter

public class SuppressWithNearbyCommentFilter
extends AutomaticBean
implements Filter

A filter that uses nearby comments to suppress audit events.

This check is philosophically similar to SuppressionCommentFilter. Unlike SuppressionCommentFilter, this filter does not require pairs of comments. This check may be used to suppress warnings in the current line:

    offendingLine(for, whatever, reason); // SUPPRESS ParameterNumberCheck
 

or it may be configured to span multiple lines, either forward:

    // PERMIT MultipleVariableDeclarations NEXT 3 LINES
    double x1 = 1.0, y1 = 0.0, z1 = 0.0;
    double x2 = 0.0, y2 = 1.0, z2 = 0.0;
    double x3 = 0.0, y3 = 0.0, z3 = 1.0;
 

or reverse:

   try {
     thirdPartyLibrary.method();
   } catch (RuntimeException e) {
     // ALLOW ILLEGAL CATCH BECAUSE third party API wraps everything
     // in RuntimeExceptions.
     ...
   }
 

See SuppressionCommentFilter for usage notes.

Author:

Mick Killianey

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SuppressWithNearbyCommentFilter.Tag A Tag holds a suppression comment and its location.

Constructor Summary

Constructors

Constructor and Description
SuppressWithNearbyCommentFilter() Constructs a SuppressionCommentFilter.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	accept(AuditEvent event) Determines whether or not a filtered AuditEvent is accepted.
FileContents	getFileContents()
void	setCheckC(boolean checkC) Set whether to look in C comments.
void	setCheckCPP(boolean checkCPP) Set whether to look in C++ comments.
void	setCheckFormat(String format) Set the format for a check.
void	setCommentFormat(String format) Set the format for a comment that turns off reporting.
void	setFileContents(FileContents fileContents) Set the FileContents for this filter.
void	setInfluenceFormat(String format) Set the format for the influence of this check.
void	setMessageFormat(String format) Set the format for a message.

Methods inherited from class com.puppycrawl.tools.checkstyle.api.AutomaticBean

configure, contextualize, finishLocalSetup, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Constructor Detail

SuppressWithNearbyCommentFilter

public SuppressWithNearbyCommentFilter()

Constructs a SuppressionCommentFilter. Initializes comment on, comment off, and check formats to defaults.

Method Detail

setCommentFormat

public void setCommentFormat(String format)
                      throws org.apache.commons.beanutils.ConversionException

Set the format for a comment that turns off reporting.

Parameters:

format - a String value.

Throws:

org.apache.commons.beanutils.ConversionException - unable to parse format.

getFileContents

public FileContents getFileContents()

Returns:

the FileContents for this filter.

setFileContents

public void setFileContents(FileContents fileContents)

Set the FileContents for this filter.

Parameters:

fileContents - the FileContents for this filter.

setCheckFormat

public void setCheckFormat(String format)
                    throws org.apache.commons.beanutils.ConversionException

Set the format for a check.

Parameters:

format - a String value

Throws:

org.apache.commons.beanutils.ConversionException - unable to parse format

setMessageFormat

public void setMessageFormat(String format)
                      throws org.apache.commons.beanutils.ConversionException

Set the format for a message.

Parameters:

format - a String value

Throws:

org.apache.commons.beanutils.ConversionException - unable to parse format

setInfluenceFormat

public void setInfluenceFormat(String format)
                        throws org.apache.commons.beanutils.ConversionException

Set the format for the influence of this check.

Parameters:

format - a String value

Throws:

org.apache.commons.beanutils.ConversionException - unable to parse format

setCheckCPP

public void setCheckCPP(boolean checkCPP)

Set whether to look in C++ comments.

Parameters:

checkCPP - true if C++ comments are checked.

setCheckC

public void setCheckC(boolean checkC)

Set whether to look in C comments.

Parameters:

checkC - true if C comments are checked.

accept

public boolean accept(AuditEvent event)

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.