CheckStyle
Installation in Maven
To set CheckStyle in Maven or {{Maven 2]] add the following line of code to the settings of the project.xml, project.properties.
Project.xml
<reports>
...
<report>maven-checkstyle-plugin</report>
...
</reports>
Project.properties
Add the name of the file containing the checkstyle settings:
# Checkstyle settings #
maven.checkstyle.excludes=**/*generated*/**
maven.checkstyle.properties=${basedir}/AAB_checks.xml
Configuration
The default CheckStyle is highly configurable. The installation come with sample configuration files:
- Apache Avalon (avalon_checks.xml)
- Sun coding conventions (sun_checks.xml)
- Apache Turbine Framework (turbine_checks.xml), this is the base of Frame
The AAB uses its own CheckStyle convention (AAB_checks.xml), which is configured for each project separately. The format of the configuration file:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.1//EN" "http://www.puppycrawl.com/dtds/configuration_1_1.dtd">
<module name="Checker">
<module name="TreeWalker">
<module name="com.puppycrawl.tools.checkstyle.checks.GenericIllegalRegexpCheck">
<property name="format" value="System.err"/>
<property name="ignoreCase" value="false"/>
<property name="ignoreComments" value="false"/>
<property name="message" value="Do not use System.err"/>
<property name="severity" value="warning"/>
</module>
...
<module name="com.puppycrawl.tools.checkstyle.checks.sizes.LineLengthCheck">
<property name="ignorePattern" value="^$"/>
<property name="max" value="110"/>
<property name="severity" value="warning"/>
<property name="tabWidth" value="4"/>
</module>
...
</module>
</module>
Problem
The CheckStyle report becomes very long and difficult to handel. There are a few checks which delivers very much lines of report lines. A comparison of the size of checkstyle-report.html file for the different checkstyles
|
