Package com.puppycrawl.tools.checkstyle.checks.header

Class MultiFileRegexpHeaderCheck

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.header.MultiFileRegexpHeaderCheck

All Implemented Interfaces:

Configurable, Contextualizable, ExternalResourceHolder, FileSetCheck

public class MultiFileRegexpHeaderCheck
extends AbstractFileSetCheck
implements ExternalResourceHolder

Checks the header of a source file against multiple header files that contain a pattern for each line of the source header.

Since:

10.24.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	MultiFileRegexpHeaderCheck.HeaderFileMetadata	Metadata holder for a header file, storing its URI, compiled patterns, and line contents.
private static final record	MultiFileRegexpHeaderCheck.MatchResult	Represents the result of a header match check, containing information about any mismatch.

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

AbstractAutomaticBean.OutputStreamOptions

Field Summary

Fields

Modifier and Type	Field	Description
private static final Pattern	BLANK_LINE	Compiled regex pattern for a blank line.
private static final String	EMPTY_LINE_PATTERN	Regex pattern for a blank line.
private static final String	HEADER_FILE_SEPARATOR	Separator for multiple header file paths in the configuration and messages.
private String	headerFiles	Specify a comma-separated list of files containing the required headers.
private final List<MultiFileRegexpHeaderCheck.HeaderFileMetadata>	headerFilesMetadata	List of metadata objects for each configured header file, containing patterns and line contents.
static final int	MISMATCH_CODE	Constant indicating that no header line mismatch was found.
static final String	MSG_HEADER_MISMATCH	A key is pointing to the warning message text in "messages.properties" file.
static final String	MSG_HEADER_MISSING	A key is pointing to the warning message text in "messages.properties" file.

Constructor Summary

Constructors

Constructor	Description
MultiFileRegexpHeaderCheck()

Method Summary

Modifier and Type	Method	Description
private static MultiFileRegexpHeaderCheck.MatchResult	createMismatchResult(MultiFileRegexpHeaderCheck.HeaderFileMetadata headerFile, FileText fileText, int mismatchLine)	Creates a MatchResult for a mismatch case.
Set<String>	getExternalResourceLocations()	Returns a set of external configuration resource locations which are used by the module.
static List<String>	getLines(String headerFile, URI uri)	Reads all lines from the specified header file URI.
private static MultiFileRegexpHeaderCheck.MatchResult	matchHeader(FileText fileText, MultiFileRegexpHeaderCheck.HeaderFileMetadata headerFile)	Analyzes if the file text matches the header file patterns and generates a detailed result.
protected void	processFiltered(File file, FileText fileText)	Called to process a file that matches the specified file extensions.
void	setHeaderFiles(String... headerFiles)	Setter to specify a comma-separated list of files containing the required headers.

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

MISMATCH_CODE

public static final int MISMATCH_CODE

Constant indicating that no header line mismatch was found.

See Also:

• Constant Field Values

MSG_HEADER_MISSING

public static final String MSG_HEADER_MISSING

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

See Also:

• Constant Field Values

MSG_HEADER_MISMATCH

public static final String MSG_HEADER_MISMATCH

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

See Also:

• Constant Field Values

EMPTY_LINE_PATTERN

private static final String EMPTY_LINE_PATTERN

Regex pattern for a blank line.

See Also:

• Constant Field Values

HEADER_FILE_SEPARATOR

private static final String HEADER_FILE_SEPARATOR

Separator for multiple header file paths in the configuration and messages.

See Also:

• Constant Field Values

BLANK_LINE

private static final Pattern BLANK_LINE

Compiled regex pattern for a blank line.

headerFilesMetadata

private final List<MultiFileRegexpHeaderCheck.HeaderFileMetadata> headerFilesMetadata

List of metadata objects for each configured header file, containing patterns and line contents.

headerFiles

private String headerFiles

Specify a comma-separated list of files containing the required headers. If a file's header matches none, the violation references the first file in this list. Users can order files to set a preferred header for such reporting.

Constructor Details

MultiFileRegexpHeaderCheck

public MultiFileRegexpHeaderCheck()

Method Details

setHeaderFiles

public void setHeaderFiles(String... headerFiles)

Setter to specify a comma-separated list of files containing the required headers. If a file's header matches none, the violation references the first file in this list. Users can order files to set a preferred header for such reporting.

Parameters:

headerFiles - comma-separated list of header files

Throws:

IllegalArgumentException - if headerFiles is null or empty

Since:

10.24.0

getExternalResourceLocations

public Set<String> getExternalResourceLocations()

Description copied from interface: ExternalResourceHolder

Returns a set of external configuration resource locations which are used by the module. ATTENTION! If 'getExternalResourceLocations()' return null, there will be NullPointerException in Checker. Such behaviour will signal that your module (check or filter) is designed incorrectly. It makes sense to return an empty set from 'getExternalResourceLocations()' only for composite modules like TreeWalker.

Specified by:

getExternalResourceLocations in interface ExternalResourceHolder

Returns:

a set of external configuration resource locations which are used by the module.

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.

matchHeader

private static MultiFileRegexpHeaderCheck.MatchResult matchHeader(FileText fileText,
 MultiFileRegexpHeaderCheck.HeaderFileMetadata headerFile)

Analyzes if the file text matches the header file patterns and generates a detailed result.

Parameters:

fileText - the text of the file being checked

headerFile - the header file metadata to check against

Returns:

a MatchResult containing the result of the analysis

createMismatchResult

private static MultiFileRegexpHeaderCheck.MatchResult createMismatchResult(MultiFileRegexpHeaderCheck.HeaderFileMetadata headerFile,
 FileText fileText,
 int mismatchLine)

Creates a MatchResult for a mismatch case.

Parameters:

headerFile - the header file metadata

fileText - the text of the file being checked

mismatchLine - the line number of the mismatch (0-based)

Returns:

a MatchResult representing the mismatch

getLines

public static List<String> getLines(String headerFile,
 URI uri)

Reads all lines from the specified header file URI.

Parameters:

headerFile - path to the header file (for error messages)

uri - URI of the header file

Returns:

list of lines read from the header file

Throws:

IllegalArgumentException - if the file cannot be read or is empty