Introduction à Cobertura

Pour commencer à calculer la couverture de code dans votre projet Java, vous devezdeclare the Cobertura Maven plugin in your pom.xml file dans la section de création de rapports:

Vous pouvez toujours vérifier la dernière version du plugin dans leMaven central repository.

Une fois terminé, lancez Maven en spécifiantcobertura:cobertura comme objectif.

Cela créera un rapport de style HTML détaillé montrant les statistiques de couverture de code recueillies via l'instrumentation de code:

The line coverage metric shows how many statements are executed lors de l'exécution des tests unitaires, tandis quethe branch coverage metric focuses on how many branches are covered by those tests.

Pour chaque conditionnel, vous avez deux branches, donc en gros, vous finirez par avoir deux fois plus de branches que les conditionnelles.

The complexity factor reflects the complexity of the code - il augmente lorsque le nombre de branches dans le code augmente.

En théorie, plus vous avez de branches, plus vous avez besoin de tests pour augmenter le score de couverture des branches.

Vous pouvez ignorer / exclure un ensemble spécifique de classes de l'instrumentation de code à l'aide des balisesignore etexclude:

Après le calcul de la couverture de code vient la phasecheck. The check phase ensures that a certain level of code coverage is reached.

Voici un exemple de base sur la configuration de la phasecheck:

Lors de l'utilisation de l'indicateurhaltOnFailure, Cobertura provoquera l'échec de la construction si l'une des vérifications spécifiées échoue.

Les balisesbranchRate/lineRate spécifient le score de couverture de branche / ligne minimum acceptable requis après l'instrumentation du code. Ces vérifications peuvent être étendues au niveau du package en utilisant les balisespackageLineRate/packageBranchRate.

Il est également possible de déclarer des contrôles de règles spécifiques pour les classes dont les noms suivent un modèle spécifique en utilisant la baliseregex. Dans l'exemple ci-dessus, nous nous assurons qu'un score de couverture de ligne / branche spécifique doit être atteint pour les classes du packagecom.example.algorithms.dijkstra et ci-dessous.

Cobertura est également disponible sous forme de plugin Eclipse appeléeCobertura. Pour installereCobertura pour Eclipse, vous devez suivre les étapes ci-dessous et installer Eclipse version 3.5 ou supérieure:

Step 1: Dans le menu Eclipse, sélectionnezHelp →Install New Software. Ensuite, au champwork with, entrezhttp://ecobertura.johoop.de/update/:

Step 2: SélectionnezeCobertura Code Coverage, cliquez sur «suivant», puis suivez les étapes de l'assistant d'installation.

Maintenant queeCobertura est installé, redémarrez Eclipse et affichez la vue de session de couverture sousWindows → Show View → Other → Cobertura.

Pour la version plus récente d'Eclipse (Kepler, Luna, etc.), l'installation deeCobertura peut causer des problèmes liés à JUnit -the newer version of JUnit packaged with Eclipse is not fully compatible with eCobertura‘s dependencies checker:

Pour contourner ce problème, vous pouvez télécharger une version antérieure de JUnit et la placer dans le dossier des plugins Eclipse.

Cela peut être fait en supprimant le dossierorg.junit.*** de%ECLIPSE_HOME%/plugins, puis en copiant le même dossier à partir d'une ancienne installation Eclipse compatible aveceCobertura.

Une fois terminé,restart your Eclipse IDE and re-install the pluginutilise le site de mise à jour correspondant.

Afin de calculer la couverture de code par un test unitaire, cliquez avec le bouton droit sur votre projet / test pour ouvrir le menu contextuel, puis choisissez l'optionCover As → JUnit Test.

Sous la vueCoverage Session, vous pouvez consulter le rapport de couverture ligne / succursale par classe:

Les utilisateurs de Java 8 peuvent rencontrer une erreur courante lors du calcul de la couverture de code:

Dans ce cas, Java se plaint de certaines méthodes ne disposant pas d'une mappe de pile appropriée, en raison du vérificateur de bytecode plus strict introduit dans les versions plus récentes de Java.

Ce problème peut être résolu en désactivant la vérification dans la machine virtuelle Java.

Pour ce faire, cliquez avec le bouton droit sur votre projet pour ouvrir le menu contextuel, sélectionnezCover As, puis ouvrez la vueCoverage Configurations. Dans l'onglet arguments, ajoutez l'indicateur-noverify en tant qu'argument VM. Enfin, cliquez sur le boutoncoverage pour lancer le calcul de la couverture.

Vous pouvez également utiliser l'indicateur-XX:-UseSplitVerifier, mais cela ne fonctionne qu'avec Java 6 et 7, car le vérificateur fractionné n'est plus pris en charge dans Java 8.