Configuration des indicateurs de couverture de code

La couverture de code par défaut qui apparaît dans l'explorateur de packages, dans l'éditeur Java et dans les vues peut être configurée. Pour chaque projet Java ou plug-in, vous pouvez configurer ces éléments dans les préférences :

• Décorations d'intitulés
• Couleurs et polices
• Indicateurs de couverture de code
• Indicateurs de l'éditeur Java
• Nombre de lancements Java mis en mémoire cache pour les rapports de couverture de code
• Options de collection

Vous pouvez activer ou désactiver les indicateurs d'intitulé pour les lignes entièrement couvertes, partiellement couvertes et non couvertes dans l'explorateur de packages, l'éditeur Java et les vues. Vous pouvez paramétrer les couleurs et les polices des indicateurs. Vous pouvez déterminer les indicateurs de couverture de code que vous souhaitez voir apparaître dans l'explorateur de packages et dans les vues. Vous pouvez également déterminer le nombre de lancements Java à mettre en mémoire cache pour les utiliser dans les rapports de couverture de code et vous pouvez aussi indiquer si vous souhaitez collecter les données de couverture de code sur les constructeurs par défaut.

Pour configurer vos préférences en matière de couverture de code :

1. Sélectionnez Fenêtre > Préférences, puis cliquez sur Java > Couverture de code :





2. Pour activer ou désactiver les décorations d'intitulé, cliquez sur le lien Décorations d'intitulés situé en haut de la page de préférences.
3. Dans la fenêtre Décorations d'intitulés, cochez ou décochez la case Statistiques de couverture de code, puis cliquez sur Appliquer.
4. Pour configurer les polices et les couleurs utilisées pour les indicateurs de couverture de code, cliquez sur le lien Couleurs et polices situé en haut de la page de préférences de la couverture de code.
5. Développez Couverture de code dans la fenêtre Couleurs et polices.
6. Cliquez sur la couleur d'élément que vous souhaitez modifier, puis cliquez sur le bouton de couleur situé à droite de la fenêtre.
7. Dans la palette, sélectionnez la couleur de votre choix, puis cliquez sur Appliquer, ou cliquez sur Réinitialiser pour restaurer les paramètres par défaut.
8. Pour configurer les polices utilisées dans l'explorateur de packages et les vues, cliquez sur la police de l'élément que vous souhaitez changer, par exemple, Police d'élément partiellement couvert, puis cliquez sur Modifier.
9. Sélectionnez la police de votre choix dans la liste, puis cliquez sur OK. Cliquez sur Appliquer ou cliquez sur Réinitialiser pour restaurer les paramètres par défaut.





10. Dans la page Préférences de couverture de code, vous pouvez configurer les indicateurs eux-mêmes. Sélectionnez un ou plusieurs indicateurs pour la couverture de packages, de fichiers source, de types (une classe précise ou une énumération) et de méthodes, puis cliquez sur Appliquer. Si vous en choisissez plusieurs, la hiérarchie est la suivante : type, méthode, bloc et ligne, dans l'ordre indiqué dans la case. Notez que la définition d'un bloc est un code (une partie de ligne, une seule ligne ou plusieurs lignes) qui ne peut être modifié par des embranchements. La totalité du code d'un bloc est exécutée comme un groupe unique d'instructions. Les blocs se terminent par un embranchement vers l'intérieur ou vers l'extérieur (par exemple, appeler une méthode, lancer une exception ou revenir en arrière).

Dans l'exemple suivant, seuls les indicateurs de blocs sont sélectionnés :


Ainsi, l'explorateur de packages et les vues présentent uniquement la couverture de code des blocs :


Si les deux types d'indicateur de couverture de bloc et de méthode sont sélectionnés, l'explorateur de packages affiche la couverture de méthode avant la couverture de bloc :




Notez que le fait de décocher la case Afficher les indicateurs de couleur dans les vues supprime les décorations de couleur de l'explorateur de packages et des vues (comme la vue Structure) tout en conservant l'affichage des pourcentages de couverture de code (sans couleur).

11. Dans la case de l'éditeur Java de la page de préférences de la couverture de code, sélectionnez les options de couverture de votre choix pour le projet, puis cliquez sur Appliquer. Dans cet exemple, les lignes partiellement couvertes ne sont pas activées :
    
    
12. Dans la case Lancement Java, entrez le nombre de lancements à mettre en mémoire cache pour l'utilisation de la couverture de code, puis cliquez sur Appliquer. Notez que cela ne concerne que les lancements déclenchés de l'espace de travail. Le nombre de lancements que vous mettez en mémoire cache dépend de l'espace disque.
13. Pour déterminer si les constructeurs par défaut sont inclus dans les calculs de couverture de code, utilisez la case à cocher "Inclure les données dans les constructeurs par défaut". Par défaut, les constructeurs sont inclus ; si une classe ne définit aucun constructeur, le compilateur génère un défaut indiquant aucun constructeur d'argument. Cependant, ce constructeur n'apparaît pas dans le fichier source réel. Au cours de l'exécution du programme, si cette classe n'est pas instanciée, ce constructeur par défaut masqué n'est pas exécuté et, par conséquent, la couverture n'est pas de 100 % comme prévu. Ce comportement peut être défini par ces préférences.

© Copyright IBM Corporation 2007, 2008. All Rights Reserved.