Exercice 1.2 : Exécution d'une révision de code Analyse structurelle
On suppose ici que vous avez effectué les étapes
de l'Exercice 1.1 : Importation des ressources requises. Dans
l'exercice 1.2, vous commencez par lire un scénario mettant en jeu un ou plusieurs utilisateurs. Puis
vous prenez le rôle de l'architecte logiciel décrit dans ce scénario et utilisez le projet que vous
avez importé au cours de l'exercice 1.1 pour effectuer le présent
exercice.
Scénario utilisateurs
Pour réviser un code nouvellement écrit en vue d'évaluer sa qualité, l'architecte
souhaite rechercher les anti-modèles généraux. Les anti-modèles (ou "anti-patterns")
sont des problèmes connus qui apparaissent dans le code et qui ne respectent pas les
pratiques recommandées. Tandis que les modèles de conception sont, comme leur nom l'indique,
de bons modèles à suivre, les anti-modèles sont de mauvais modèles qu'il convient donc
d'éviter. Voici quelques types d'anti-modèles spécifiques :
- Breakable : L'objet dans le code a un si grand nombre de dépendances qu'il est susceptible de se "rompre" (d'où le
terme Breakable, qui signifie cassable) dès qu'un autre objet est modifié.
- Dépendance cyclique : Un groupe d'objets est interconnecté d'une manière telle, souvent circulaire,
qu'une modification de l'un d'eux pourrait affecter tous les autres. On parle aussi d'enchevêtrement (Tangle en anglais) pour
ce type d'anti-modèle.
- Hub (concentrateur) : L'objet comporte à la fois un grand nombre de dépendances et
de nombreux dépendants. Il est affecté lorsqu'un autre objet est
modifié. Inversement, lorsqu'il est lui-même modifié, les autres objets sont affectés.
Dans le premier exercice, l'architecte exécute une révision de code afin de rechercher les anti-modèles
décrits plus haut.
Exercice
Dans cet exercice, vous accomplissez les tâches suivantes :
- Sélectionner une révision de code à exécuter.
- Visualiser les règles appliquées dans la révision de code.
- Choisir sur quel code exécuter la révision.
- Exécuter la révision de code.
- Visualiser les anomalies constatées par l'exécution de la révision de code.
- Sélectionner une anomalie pour afficher les informations suivantes la concernant :
- Code source.
- Description, exemples et solutions.
Sélection d'une révision de code
Pour sélectionner une révision de code de type Analyse structurelle :
- Sur la barre d'outils de la vue Révision de code,
cliquez sur l'icône Gérer les règles,
.

- Dans la liste Sélectionnez la révision de code,
cliquez sur Révision de code Analyse structurelle.
- Développez le dossier Analyse structurelle et ses sous-dossiers
pour faire apparaître les règles appliquées dans la révision
de code (voir l'illustration ci-après). Cliquez sur OK.

Sélection d'une base de code à réviser
Pour sélectionner l'espace de travail comme base de code à réviser :
- Sur la barre d'outils de la vue Révision de code, cliquez
sur l'icône Révision (
) > Révision de Espace de travail.
Exécution de la révision de code
Une fois que vous avez sélectionné la base de code à réviser,
la révision de code s'exécute. Vous pouvez suivre son état en observant la barre de progression,
dans l'angle inférieur droit de la vue.
Visualisation des anomalies constatées par la révision de code
Une fois la révision de code terminée, les anomalies constatées sont présentées dans la
vue Révision de code, comme le montre l'illustration ci-après :

Les informations suivantes sont fournies dans la vue Révision de code :
- Statistiques : la ligne située au-dessus des anomalies constatées donne des détails sur la révision de code
la plus récente : nom, portée, nombre de règles et de fichiers inclus, nombre et gravité des anomalies constatées.
- Anomalies constatées : les anomalies constatées par la révision de code sont répertoriées sous forme de dossiers
dans la vue Révision de code. Chaque nom de dossier mentionne le nom de la révision de code ainsi que la catégorie et le
nombre d'anomalies.
Obtention d'informations complémentaires sur une anomalie constatée
Procédez comme suit pour obtenir plus d'informations sur une anomalie constatée dans la
révision de code :
- Développez le dossier Analyse structurelle : Dépendance cyclique. Il contient quatre anomalies, comme le montre
l'illustration ci-après :

Chaque anomalie est précédée d'une icône qui indique son niveau de gravité.

Si une icône comporte une ampoule (
), cela signifie
qu'il existe une correction rapide pour l'anomalie
correspondante. Une correction rapide est une solution automatisée, fournie dans le produit
pour résoudre une anomalie spécifique. Les icônes symbolisant les corrections rapides sont les suivantes :

- Cliquez deux fois sur l'anomalie commençant par Event.java. Les détails la concernant apparaissent
en deux endroits, comme décrit et illustré ci-après :
- Code source : affiche le code dans lequel l'anomalie est constatée et met en évidence l'endroit précis où
elle se situe.
- Vue Détails de la révision du code : décrit l'anomalie plus en détail et fournit des exemples et des solutions pour la corriger. Si
l'anomalie est une dépendance cyclique, cette vue comporte également une section intitulée Détails de la boucle.

Vous avez terminé l'exercice 1.2 : Exécution d'une révision de code Analyse structurelle.
Mettre à profit la puissance d'une révision de code
En exécutant une révision de code, vous êtes en mesure d'identifier très tôt les anomalies, si bien que vous
pouvez aussi les corriger très tôt, avant qu'elles n'entraînent les problèmes suivants :
- Affectation des performances, de la maintenabilité et de l'extensibilité de votre application.
- Augmentation du temps et des ressources nécessaires au développement, et donc du coût pour votre entreprise.
Dans l'exercice 1.4, vous allez tirer parti du travail accompli au cours de l'exercice 1.2 en corrigeant une anomalie
identifiée par la révision de code.
Conclusion de l'exercice 1.2
Vous avez terminé l'exercice 1.2 : Exécution d'une révision de code Analyse structurelle. Au cours de cet exercice, vous avez accompli les tâches suivantes :
- Sélectionner une révision de code à exécuter.
- Visualiser les règles appliquées dans la révision de code.
- Choisir sur quel corps de code exécuter la révision.
- Exécuter la révision de code.
- Visualiser les anomalies constatées par l'exécution de la révision de code.
- Sélectionner une anomalie pour afficher les informations suivantes la concernant :
- Code source.
- Description, exemples et solutions.
Vous êtes maintenant prêt à aborder l'Exercice 1.3 : Définition d'une règle de contrôle de l'architecture.