Exercice 1.2 : Révision de code Analyse structurelle
Dans cet exercice, on part du principe que vous avez terminé l'exercice 1.1 : Importation des ressources requises. Cet exercice contient un scénario utilisateur que vous devez lire en premier. Assumez ensuite le rôle d'architecte de logiciels qui est décrit dans le scénario utilisateur, puis utilisez le projet que vous avez importé dans l'exercice 1.1 pour terminer l'exercice.
Scénario utilisateur
Pour vérifier le code nouvellement écrit afin d'en évaluer la qualité, l'architecte souhaite rechercher des anti-patterns généraux. Les anti-patterns sont des problèmes connus qui surviennent dans le code et qui ne respectent pas les pratiques recommandées. Contrairement aux patterns de conception, qui doivent être utilisés, les anti-patterns sont à éviter. Certains anti-patterns spécifiques comportent les types suivants :
- Breakable : L'objet du code comporte un si grand nombre de dépendances qu'il est susceptible d'être affecté lorsqu'un autre objet est modifié.
- Dépendance cyclique : Un groupe d'objets est si interconnecté, généralement circulaire, qu'une modification apportée à un objet peut avoir une incidence sur tous les autres objets. Elle est également appelée enchevêtrement.
- Hub : L'objet possède un grand nombre de dépendances et de dépendants. Il est affecté lorsqu'un autre objet est modifié. De même, lorsqu'il est modifié, les autres objets sont affectés.
Dans le premier exercice, l'architecte exécute une révision de code pour rechercher les anti-patterns décrits ci-dessus.
Exercice
Dans cet exercice, vous allez exécuter les tâches suivantes :
- Sélection d'une révision de code à exécuter.
- Visualisation des règles appliquées dans la révision de code.
- Choix du code pour lequel exécuter la révision.
- Exécution de la révision de code.
- Visualisez les anomalies constatées par la révision de code.
- Sélection d'une anomalie pour afficher les informations correspondants suivantes :
- Code source
- Description, exemples et solutions
Sélection d'une révision de code
Pour sélectionner une révision de code Analyse structurelle, procédez comme suit :
- Dans 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 les sous-dossiers pour visualiser les règles appliquées dans la révision de code, comme illustré ci-dessous. 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, procédez comme suit :
- Dans la barre d'outils de la vue Révision de code, cliquez sur l'icône Révision (
) > Révision de l'espace de travail.
Exécution de la révision de code
Une fois que vous sélectionnez la base de code à réviser, la révision de code s'exécute. Vous pouvez suivre son état en vérifiant la barre de progression située dans l'angle inférieur droit de la vue.
Affichage des anomalies constatées par la révision de code
Une fois la révision de code terminée, les anomalies s'affichent dans la vue Révision de code, comme illustré dans la capture d'écran suivante :

Les informations ci-dessous s'affichent dans la vue Révision de code.
- Statistiques de la révision de code : la ligne située au-dessus des anomalies affiche des informations relatives à la révision de code la plus récente : nom, portée, nombre de règles et fichiers inclus, et nombre et gravité des anomalies.
- Anomalies constatées par la révision de code : les anomalies constatées par la révision de code sont répertoriées dans des dossiers de la vue Révision de code. Chaque nom de dossier indique le nom de la révision de code ainsi que la catégorie et le nombre d'anomalies.
Informations complémentaires relatives à une anomalie constatée par la révision de code
Pour obtenir des informations complémentaires sur une anomalie constatée par la révision de code, procédez comme suit :
- Développez le dossier Analyse structurelle : Dépendance cyclique. Celui-ci contient quatre anomalies, comme illustré dans la capture d'écran suivante :

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

Si une ampoule apparaît en regard d'une icône (
), cela signifie qu'un correctif rapide existe pour l'anomalie. Un correctif rapide est une solution fournie automatisée, destinée à une anomalie particulière. Les icônes de correctif rapide sont illustrées dans la figure suivante :

- Cliquez deux fois sur l'anomalie qui commence par Event.java. Les détails correspondants apparaissent dans deux emplacements, comme décrit dans les points et la capture d'écran suivants :
- Code source : affiche le code dans lequel l'anomalie se produit et met en évidence son emplacement exact.
- Vue Détails de la révision du code : décrit l'anomalie plus en détail et fournit des exemples et solutions permettant de la corriger. Si l'anomalie correspond à une dépendance cyclique, il existe également une section sur les détails de la boucle.

Vous avez terminé l'exercice 1.2 : Révision de code Analyse structurelle.
Avantages d'une révision de code
En exécutant une révision de code de façon proactive, vous êtes en mesure de repérer les incidents rapidement afin de les corriger avant qu'ils entraînent les problèmes suivants :
- Impact sur les performances, la maintenance ou l'extensibilité de votre application
- Augmentation des coûts, du temps et des ressources utilisés par votre société
L'exercice 1.4 vous permet de compléter le travail que vous avez effectué dans l'exercice 1.2 en corrigeant une anomalie constatée par la révision de code.
Récapitulatif de l'exercice 1.2
Vous avez terminé l'exercice 1.2 : Révision de code Analyse structurelle. Il vous a permis d'effectuer les tâches suivantes :
- Sélection d'une révision de code à exécuter.
- Visualisation des règles appliquées dans la révision de code.
- Choix d'un corps de code pour lequel exécuter la révision.
- Exécution de la révision de code.
- Visualisation des anomalies constatées par la révision de code.
- Sélection d'une anomalie pour afficher les informations correspondants suivantes :
- Code source
- Description, exemples et solutions
Maintenant, vous pouvez commencer l'exercice 1.3 : Définition d'une règle de contrôle architectural.