Checkstyle
Checkstyle est un outil de contrÎle de code, utilisé en développement de logiciel. Il permet de vérifier le style d'un code source écrit en langage Java.
IntĂ©rĂȘt et limites
Checkstyle peut ĂȘtre utilisĂ© dans les projets de dĂ©veloppement informatiques afin d'assurer un niveau bien dĂ©fini de qualitĂ© de code source. En effet, programmer ne se rĂ©sume pas Ă Ă©crire un code source qui puisse ĂȘtre compilĂ© et donc correct vis-Ă -vis du langage. Encore faut-il que le code source soit lisible et convenablement commentĂ©. Cela permet notamment Ă un autre dĂ©veloppeur de modifier le code existant ou au mĂȘme dĂ©veloppeur de s'y retrouver lorsqu'il reprend son propre code longtemps aprĂšs.
De mĂȘme, s'il respecte un certain nombre de conventions et de bonnes pratiques, le code produit par divers dĂ©veloppeurs s'assemble de façon plus cohĂ©rente.
Les vérifications de Checkstyle portent essentiellement sur la forme et ne permettent en rien de dire qu'un programme est correct ou complet.
En pratique, il est trĂšs fastidieux de respecter l'ensemble de toutes les contraintes de style que l'on peut imposer au travers de checkstyle. Ces contraintes peuvent par ailleurs nuire Ă la dynamique des Ă©tapes de programmation. Il s'agit donc de dĂ©terminer, selon le type du dĂ©veloppement et la qualitĂ© que l'on attend, quel doit ĂȘtre le niveau de vĂ©rification.
Exemples de modules disponibles
Checkstyle définit un ensemble de modules contenant des rÚgles que l'on peut configurer de façon plus ou moins stricte. Chaque rÚgle peut se traduire, selon le cas, par une notification, un avertissement ou par une erreur.
Checkstyle permet, par exemple, de vérifier :
- la présence de commentaires Javadoc pour les classes, les attributs et les méthodes
- les conventions de nommage des attributs et des méthodes
- une limitation du nombre de paramÚtres de méthodes, la longueur des lignes, etc.
- la prĂ©sence d'en-tĂȘtes obligatoires
- l'utilisation des importations de paquets, de classes, des modificateurs de portée et des blocs d'instructions
- l'espacement entre certains caractĂšres
- les bonnes pratiques d'Ă©criture de classe
- les sections de code dupliqué
- diverses mesures de complexité, notamment des expressions
Utilisation
Checkstyle se prĂ©sente sous la forme d'une archive Jar qui peut ĂȘtre exĂ©cutĂ©e :
- directement sur une machine virtuelle Java,
- via une tĂąche ANT,
- via un plugin maven.
Checkstyle peut Ă©galement ĂȘtre intĂ©grĂ© Ă des environnements de dĂ©veloppement intĂ©grĂ©s et d'autres outils comme NetBeans, Eclipse, jEdit, etc.
Un plugin Checkstyle permet, par exemple,
- de surcharger la coloration syntaxique ou les décorations dans l'éditeur de code
- de décorer l'explorateur de projets au niveau des ressources posant problÚme
- de rajouter des entrées dans les vues d'erreurs et d'avertissement.
Le développeur peut ainsi accéder directement aux parties de code qui ne respectent pas le style choisi.