Package com.puppycrawl.tools.checkstyle

Class Main

java.lang.Object

com.puppycrawl.tools.checkstyle.Main

public final class Main
extends Object

Wrapper command line program for the Checker.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	Main.CliOptions	Command line options.
private static class	Main.OnlyCheckstyleLoggersFilter	Log Filter used in debug mode.
(package private) static class	Main.OutputFormat	Enumeration over the possible output formats.

Field Summary

Fields

Modifier and Type	Field	Description
static String	CREATE_LISTENER_EXCEPTION	A key pointing to the create listener exception message in the "messages.properties" file.
static String	ERROR_COUNTER	A key pointing to the error counter message in the "messages.properties" file.
private static int	EXIT_WITH_CHECKSTYLE_EXCEPTION_CODE	Exit code returned when execution finishes with CheckstyleException.
private static int	EXIT_WITH_INVALID_USER_INPUT_CODE	Exit code returned when user specified invalid command line arguments.
static String	LOAD_PROPERTIES_EXCEPTION	A key pointing to the load properties exception message in the "messages.properties" file.
private static org.apache.commons.logging.Log	LOG	Logger for Main.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Main()	Client code should not create instances of this class, but use main(String[]) method instead.

Method Summary

Modifier and Type	Method	Description
private static AuditListener	createListener(Main.OutputFormat format, Path outputLocation)	This method creates in AuditListener an open stream for validation data, it must be closed by RootModule (default implementation is Checker) by calling AuditListener.auditFinished(AuditEvent).
private static int	execute(picocli.CommandLine.ParseResult parseResult, Main.CliOptions options)	Validates the user input and returns -1 if invalid, otherwise executes CheckStyle and returns the number of violations.
private static List<File>	getFilesToProcess(Main.CliOptions options)	Determines the files to process.
private static OutputStream	getOutputStream(Path outputPath)	Create output stream or return System.out
private static AbstractAutomaticBean.OutputStreamOptions	getOutputStreamOptions(Path outputPath)	Create AbstractAutomaticBean.OutputStreamOptions for the given location.
private static RootModule	getRootModule(String name, ClassLoader moduleClassLoader)	Creates a new instance of the root module that will control and run Checkstyle.
private static Configuration	getTreeWalkerConfig(Configuration config)	Returns TreeWalker module configuration.
private static String	getVersionString()	Returns the version string printed when the user requests version help (--version or -V).
private static boolean	isPathExcluded(String path, Iterable<Pattern> patternsToExclude)	Checks if a directory/file path should be excluded based on if it matches one of the patterns supplied.
private static List<File>	listFiles(File node, List<Pattern> patternsToExclude)	Traverses a specified node looking for files to check.
private static Properties	loadProperties(File file)	Loads properties from a File.
static void	main(String... args)	Loops over the files specified checking them for errors.
private static int	runCheckstyle(Main.CliOptions options, List<File> filesToProcess)	Executes required Checkstyle actions based on passed parameters.
private static int	runCli(Main.CliOptions options, List<File> filesToProcess)	Do execution of CheckStyle based on Command line options.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_COUNTER

public static final String ERROR_COUNTER

A key pointing to the error counter message in the "messages.properties" file.

See Also:

Constant Field Values

LOAD_PROPERTIES_EXCEPTION

public static final String LOAD_PROPERTIES_EXCEPTION

A key pointing to the load properties exception message in the "messages.properties" file.

See Also:

Constant Field Values

CREATE_LISTENER_EXCEPTION

public static final String CREATE_LISTENER_EXCEPTION

A key pointing to the create listener exception message in the "messages.properties" file.

See Also:

Constant Field Values

LOG

private static final org.apache.commons.logging.Log LOG

Logger for Main.

EXIT_WITH_INVALID_USER_INPUT_CODE

private static final int EXIT_WITH_INVALID_USER_INPUT_CODE

Exit code returned when user specified invalid command line arguments.

See Also:

Constant Field Values

EXIT_WITH_CHECKSTYLE_EXCEPTION_CODE

private static final int EXIT_WITH_CHECKSTYLE_EXCEPTION_CODE

Exit code returned when execution finishes with CheckstyleException.

See Also:

Constant Field Values

Constructor Detail

Main

private Main()

Client code should not create instances of this class, but use main(String[]) method instead.

Method Detail

main

public static void main(String... args)
                 throws IOException

Loops over the files specified checking them for errors. The exit code is the number of errors found in all the files.

Parameters:

args - the command line arguments.

Throws:

IOException - if there is a problem with files access

getVersionString

private static String getVersionString()

Returns the version string printed when the user requests version help (--version or -V).

Returns:

a version string based on the package implementation version

execute

private static int execute(picocli.CommandLine.ParseResult parseResult,
                           Main.CliOptions options)
                    throws IOException,
                           CheckstyleException

Validates the user input and returns -1 if invalid, otherwise executes CheckStyle and returns the number of violations.

Parameters:

parseResult - generic access to options and parameters found on the command line

options - encapsulates options and parameters specified on the command line

Returns:

number of violations

Throws:

IOException - if a file could not be read.

CheckstyleException - if something happens processing the files.

getFilesToProcess

private static List<File> getFilesToProcess(Main.CliOptions options)

Determines the files to process.

Parameters:

options - the user-specified options

Returns:

list of files to process

listFiles

private static List<File> listFiles(File node,
                                    List<Pattern> patternsToExclude)

Traverses a specified node looking for files to check. Found files are added to a specified list. Subdirectories are also traversed.

Parameters:

node - the node to process

patternsToExclude - The list of patterns to exclude from searching or being added as files.

Returns:

found files

isPathExcluded

private static boolean isPathExcluded(String path,
                                      Iterable<Pattern> patternsToExclude)

Checks if a directory/file path should be excluded based on if it matches one of the patterns supplied.

Parameters:

path - The path of the directory/file to check

patternsToExclude - The collection of patterns to exclude from searching or being added as files.

Returns:

True if the directory/file matches one of the patterns.

runCli

private static int runCli(Main.CliOptions options,
                          List<File> filesToProcess)
                   throws IOException,
                          CheckstyleException

Do execution of CheckStyle based on Command line options.

Parameters:

options - user-specified options

filesToProcess - the list of files whose style to check

Returns:

number of violations

Throws:

IOException - if a file could not be read.

CheckstyleException - if something happens processing the files.

runCheckstyle

private static int runCheckstyle(Main.CliOptions options,
                                 List<File> filesToProcess)
                          throws CheckstyleException,
                                 IOException

Executes required Checkstyle actions based on passed parameters.

Parameters:

options - user-specified options

filesToProcess - the list of files whose style to check

Returns:

number of violations of ERROR level

Throws:

IOException - when output file could not be found

CheckstyleException - when properties file could not be loaded

loadProperties

private static Properties loadProperties(File file)
                                  throws CheckstyleException

Loads properties from a File.

Parameters:

file - the properties file

Returns:

the properties in file

Throws:

CheckstyleException - when could not load properties file

getRootModule

private static RootModule getRootModule(String name,
                                        ClassLoader moduleClassLoader)
                                 throws CheckstyleException

Creates a new instance of the root module that will control and run Checkstyle.

Parameters:

name - The name of the module. This will either be a short name that will have to be found or the complete package name.

moduleClassLoader - Class loader used to load the root module.

Returns:

The new instance of the root module.

Throws:

CheckstyleException - if no module can be instantiated from name

getTreeWalkerConfig

private static Configuration getTreeWalkerConfig(Configuration config)

Returns TreeWalker module configuration.

Parameters:

config - The configuration object.

Returns:

The TreeWalker module configuration.

createListener

private static AuditListener createListener(Main.OutputFormat format,
                                            Path outputLocation)
                                     throws IOException

This method creates in AuditListener an open stream for validation data, it must be closed by RootModule (default implementation is Checker) by calling AuditListener.auditFinished(AuditEvent).

Parameters:

format - format of the audit listener

outputLocation - the location of output

Returns:

a fresh new AuditListener

Throws:

IOException - when provided output location is not found

getOutputStream

private static OutputStream getOutputStream(Path outputPath)
                                     throws IOException

Create output stream or return System.out

Parameters:

outputPath - output location

Returns:

output stream

Throws:

IOException - might happen

getOutputStreamOptions

private static AbstractAutomaticBean.OutputStreamOptions getOutputStreamOptions(Path outputPath)

Create AbstractAutomaticBean.OutputStreamOptions for the given location.

Parameters:

outputPath - output location

Returns:

output stream options