Checkstyle

From Wikipedia, the free encyclopedia

This is an old revision of this page, as edited by SyntaxBlitz (talk | contribs) at 15:37, 16 May 2018. The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

Checkstyle
Stable release
8.10 / April 30, 2018; 6 years ago (2018-04-30)
Repository
Written inJava
Operating systemCross-platform
TypeStatic code analysis
LicenseLesser GNU General Public License
Websitecheckstyle.sourceforge.net Edit this at Wikidata

Checkstyle[1] is a static code analysis tool used in software development for checking if Java source code complies with coding rules.

Originally developed by Oliver Burn back in 2001, is maintained by a team of several developers around the world.

The current stable release is version 8.10[2] which is targeted towards the Java 8 language.

Advantages and limits

The programming style adopted by a software development project can help to comply with good programming practices which improve the code quality, readability, re-usability, and reduce the cost of development. The performed checks mainly limit themselves to the presentation and don't analyze content, and do not confirm the correctness or completeness of the program. In practice, it can be tedious to comply with all the style constraints, some of which could possibly harm the programming stages' dynamic; so, it may be useful to determine which level of check is needed for a certain type of program.

Examples of available modules

Checkstyle defines a set of available modules, each of which provides rules checking with a configurable level of strictness (mandatory, optional...). Each rule can raise notifications, warnings, and errors. For example, checkstyle can examine:

  • Javadoc comments for classes, attributes and methods;
  • Naming conventions of attributes and methods;
  • Limit of the number of function parameters, line lengths;
  • Presence of mandatory headers;
  • The use of packets imports, of classes, of scope modifiers and of instructions blocks;
  • The spaces between some characters;
  • The good practices of class construction;
  • Multiple complexity measurements, among which expressions.

Usage

Checkstyle is built in a JAR file which can run inside a Java VM or as an Apache Ant task. It can also integrate into an IDE or other tools.

A Checkstyle plug-in can provide new functionalities, like:

  • overload syntax coloring or decorations in code editor;
  • decorate the project explorer to highlight problem-posing resources;
  • add warnings and errors outputs to the outputs.

Thus, the developer can directly access the code parts highlighted by Checkstyle.

See also

References

  1. ^ "Checkstyle Home Page". 2010. Retrieved 2010-11-02.
  2. ^ "Checkstyle Release Notes". 2018. Retrieved 2018-05-16.

External links