Exercice 1.3 : Définition d'une règle de contrôle de l'architecture
On suppose ici que vous avez effectué les étapes
de l'Exercice 1.1 : Importation des ressources requises. Dans
l'exercice 1.3, 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 éviter les dépendances superflues, l'architecte souhaite mettre en place une protection
afin de garantir qu'aucune dépendance n'est introduite dans l'application. Pour cela,
il crée une règle à partir d'un assistant fourni dans le
produit. L'effet de cette règle est de l'alerter si le package utility devient dépendant
du package de l'application.
Après avoir créé la règle, l'architecte exécute une révision de code en l'appliquant
à une base de code. Les anomalies constatées révèlent alors toutes les dépendances superflues
dans l'application.
Exercice
Dans cet exercice, vous accomplissez les tâches suivantes :
- Définir une règle basée sur un assistant fourni.
- Vérifier que votre règle personnalisée est ajoutée à la révision de code Analyse structurelle.
- Exécuter la révision de code Analyse structurelle.
- Visualiser les anomalies détectées qui enfreignent les critères de votre règle.
Définition d'une règle
Pour définir une règle de contrôle d'architecture basée sur un assistant fourni :
- Sur la barre d'outils de la vue Révision de code,
cliquez sur l'icône Gérer les règles,
.

- Dans la fenêtre Préférences, cliquez sur Nouvelle règle. L'assistant
Nouvelle règle de révision de code s'ouvre.
L'assistant Nouvelle règle de révision de code, illustré ci-après, vous guide à travers quelques étapes
pour définir votre propre règle. Dans cet exercice, vous allez créer une règle de contrôle de l'architecture
visant à vous alerter en cas d'introduction d'une dépendance entre deux
composants.
- Dans la liste de règles de la
catégorie Contrôle de l'architecture, cliquez
sur [dépendance] entre composants introduite. Notez que lorsque vous sélectionnez
ce modèle de règle, le texte affiché en dessous de la liste vous indique de l'utiliser pour
interdire une dépendance entre deux composants. Cliquez sur Suivant.

- Dans la section Propriétés de base, acceptez les valeurs par défaut (règle placée
dans la catégorie Analyse structurelle avec le niveau de gravité Problème).

- Dans la section Propriétés spécifiques, désignez les composants indépendant et dépendant :
- Composant indépendant : workspace\StructuralAnalysis\src\com.ibm.r2a.rules.rsa.examples.architecturalcontrol\IndependentComponent.java
- Composant dépendant : workspace\StructuralAnalysis\src\com.ibm.r2a.rules.rsa.examples.architecturalcontrol\DependentComponent.java.
- Cliquez sur Fin.
Vérifier que votre règle est ajoutée à une révision de code
- Une fois votre règle définie, la fenêtre Préférences
s'affiche. Dans la liste Sélectionnez la révision de code,
cliquez sur Révision de code complète si elle n'est pas déjà sélectionnée. Vous voyez ainsi toutes les
catégories de révisions de code.
- Développez le dossier Analyse structurelle pour voir la règle que vous venez de créer.
- Cliquez sur la règle pour voir les propriétés que vous lui avez attribuées, comme illustré
ci-après :

Sélection d'une révision de code appliquant seulement votre règle
Pour exécuter une révision de code se limitant à appliquer votre règle,
désélectionnez tous les dossiers dans la liste excepté celui
intitulé Analyse structurelle (voir l'illustration précédente). 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. Située sous l'onglet, la ligne de
statistiques récapitule les caractéristiques et les résultats de la révision.

- Développez le dossier Analyse structurelle pour voir les anomalies qu'il contient.

- Cliquez deux fois sur la troisième anomalie pour visualiser le code source correspondant dans l'éditeur, comme
illustré ci-après :

Vous avez terminé l'exercice 1.3 : Définition d'une règle de contrôle de l'architecture.
Mettre à profit la puissance des règles définies par l'utilisateur
En créant vos propres règles, vous mettez en place des protections personnalisées afin de surveiller
l'implémentation de votre conception. Vous pouvez prendre les mesures suivantes :
- Spécifier les critères d'une règle.
- Affecter un niveau de gravité à la règle : problème, avertissement ou recommandation.
- Exécuter une révision de code se limitant à appliquer une ou plusieurs de vos règles personnalisées.
Conclusion de l'exercice 1.3
Vous avez terminé l'exercice 2 : Définition d'une règle de contrôle de l'architecture. Au cours de cet exercice, vous avez accompli les tâches suivantes :
- Définir une règle basée sur un assistant fourni.
- Vérifier que votre règle personnalisée a été ajoutée à la révision de code Analyse structurelle.
- Exécuter la révision de code Analyse structurelle.
- Visualiser les anomalies détectées qui enfreignent les critères de votre règle.
Vous êtes maintenant prêt à aborder l'Exercice 1.4 : Résolution d'un problème structurel.