Package com.puppycrawl.tools.checkstyle.checks.whitespace

Class FileTabCharacterCheck

java.lang.Object

com.puppycrawl.tools.checkstyle.AbstractAutomaticBean

com.puppycrawl.tools.checkstyle.api.AbstractViolationReporter

com.puppycrawl.tools.checkstyle.api.AbstractFileSetCheck

com.puppycrawl.tools.checkstyle.checks.whitespace.FileTabCharacterCheck

All Implemented Interfaces:

Configurable, Contextualizable, FileSetCheck

public class FileTabCharacterCheck
extends AbstractFileSetCheck

Checks that there are no tab characters ('\t') in the source code.

Rationale:

• Developers should not need to configure the tab width of their text editors in order to be able to read source code.
• From the Apache jakarta coding standards: In a distributed development environment, when the commit messages get sent to a mailing list, they are almost impossible to read if you use tabs.

Notes: When the FileTabCharacter check is used with the default configuration, only the first instance of a tab character is reported.

• Property eachLine - Control whether to report on each line containing a tab, or just the first instance. Type is boolean. Default value is false.
• Property fileExtensions - Specify the file extensions of the files to process. Type is java.lang.String[]. Default value is "".

Parent is com.puppycrawl.tools.checkstyle.Checker

Violation Message Keys:

• containsTab
• file.containsTab

Since:

5.0

Nested Class Summary

Nested classes/interfaces inherited from class com.puppycrawl.tools.checkstyle.AbstractAutomaticBean

AbstractAutomaticBean.OutputStreamOptions

Field Summary

Fields

Modifier and Type	Field	Description
private boolean	eachLine	Control whether to report on each line containing a tab, or just the first instance.
static final String	MSG_CONTAINS_TAB	A key is pointing to the warning message text in "messages.properties" file.
static final String	MSG_FILE_CONTAINS_TAB	A key is pointing to the warning message text in "messages.properties" file.

Constructor Summary

Constructors

Constructor	Description
FileTabCharacterCheck()

Method Summary

Modifier and Type	Method	Description
protected void	processFiltered(File file, FileText fileText)	Called to process a file that matches the specified file extensions.
void	setEachLine(boolean eachLine)	Setter to control whether to report on each line containing a tab, or just the first instance.

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

addViolations, beginProcessing, destroy, finishProcessing, fireErrors, getFileContents, getFileExtensions, getMessageDispatcher, getTabWidth, getViolations, init, log, log, process, setFileContents, setFileExtensions, setMessageDispatcher, setTabWidth

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

finishLocalSetup, getCustomMessages, getId, getMessageBundle, getSeverity, getSeverityLevel, setId, setSeverity

Methods inherited from class com.puppycrawl.tools.checkstyle.AbstractAutomaticBean

configure, contextualize, getConfiguration, setupChild

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.puppycrawl.tools.checkstyle.api.Configurable

configure

Methods inherited from interface com.puppycrawl.tools.checkstyle.api.Contextualizable

contextualize

Field Details

MSG_CONTAINS_TAB

public static final String MSG_CONTAINS_TAB

A key is pointing to the warning message text in "messages.properties" file.

See Also:

• Constant Field Values

MSG_FILE_CONTAINS_TAB

public static final String MSG_FILE_CONTAINS_TAB

A key is pointing to the warning message text in "messages.properties" file.

See Also:

• Constant Field Values

eachLine

private boolean eachLine

Control whether to report on each line containing a tab, or just the first instance.

Constructor Details

FileTabCharacterCheck

public FileTabCharacterCheck()

Method Details

processFiltered

protected void processFiltered(File file,
 FileText fileText)

Description copied from class: AbstractFileSetCheck

Called to process a file that matches the specified file extensions.

Specified by:

processFiltered in class AbstractFileSetCheck

Parameters:

file - the file to be processed

fileText - the contents of the file.

setEachLine

public void setEachLine(boolean eachLine)

Setter to control whether to report on each line containing a tab, or just the first instance.

Parameters:

eachLine - Whether report on each line containing a tab.

Since:

5.0