UML
Partie 4 sur 4
8Les autres diagrammes en bref
Les autres diagrammes sont les suivants : messages, composants, déploiement, collaboration, états-transitions, activités. En voici l’idée, avec la question de départ de chacun.
8.1Les messages et le diagramme de séquence
Des objets qui collaborent s’envoient des messages : un message est une demande d’exécuter une opération (« enregistre cet emprunt »), éventuellement avec des paramètres, et parfois une réponse. Le diagramme de séquence montre ces échanges dans l’ordre du temps. Chaque participant a une ligne de vie, un trait vertical qui descend, et les messages sont des flèches horizontales entre les lignes ; plus une flèche est basse, plus elle est tardive. C’est le diagramme le plus apprécié pour expliquer un scénario précis, par exemple la connexion d’un utilisateur.
Voici le même scénario écrit en texte (nous reviendrons sur cette façon de dessiner en partie 9) :
@startuml Adherent -> Portail : choisir un livre Portail -> Catalogue : estDisponible(livre) Catalogue --> Portail : oui Portail -> Prets : enregistrer(adherent, livre) Prets --> Portail : date de retour Portail --> Adherent : confirmation @enduml
Le texte se lit de haut en bas : l’adhérent s’adresse au portail, qui interroge le catalogue, puis enregistre le prêt. Les flèches en trait plein sont des demandes, celles en pointillés des réponses.
8.2Le diagramme de communication (ex-collaboration)
Il montre les mêmes échanges, mais en mettant l’accent sur qui parle à qui plutôt que sur l’ordre : les objets sont placés sur la page, reliés par des traits, et les messages sont numérotés (1, 2, 3...). Il est utile pour visualiser les liens entre éléments, moins pour suivre un long scénario. En pratique, on emploie beaucoup plus la séquence.
8.3Le diagramme d’états-transitions (machine à états)
Certains objets ont une vie avec des étapes bien distinctes : une commande est « créée », puis « payée », « expédiée », « livrée », et peut être « annulée » tant qu’elle n’est pas expédiée. Le diagramme de machine à états dessine les états (rectangles aux coins arrondis) et les transitions (flèches) qui les relient, chacune étiquetée par l’événement qui la déclenche, éventuellement avec une condition. Il aide à repérer des cas impossibles (« peut-on annuler une commande déjà livrée ? ») et à éviter les états absurdes. Il est précieux pour tout ce qui ressemble à un dossier qui avance : demande de congé, ticket d’assistance, paiement.
8.4Le diagramme d’activités
C’est l’ancêtre moderne de l’organigramme de programmation (le « logigramme »). Il montre les étapes d’un traitement, avec des choix (losanges), des actions en parallèle (barres épaisses qui séparent puis rejoignent des chemins) et des « couloirs » qui disent qui fait quoi. Il se lit facilement par les non-informaticiens, d’où son emploi pour décrire des processus d’organisation, comme « traiter une réclamation », avant même de parler de logiciel.
8.5Les diagrammes de composants et de déploiement
Ces deux diagrammes décrivent le logiciel tel qu’il est assemblé et installé. Le diagramme de composants montre les grands blocs remplaçables (le portail, le service de prêts, la base de données) et ce que chacun offre ou demande aux autres, un peu comme des prises mâles et femelles. Le diagramme de déploiement montre sur quels nœuds (serveurs, conteneurs, postes) chaque bloc s’exécute, et comment ils sont connectés. Aujourd’hui, ils servent à dessiner des architectures par services (voir les microservices) et leur installation dans des conteneurs (voir les conteneurs).
Pour s’exercer
Exercice 6 : dessiner une machine à états
Décrivez les états et les transitions d’une commande de la boutique d’un site : créée, payée, expédiée, livrée, annulée.
Voir la réponse
On part de l’état « créée ». L’événement « paiement reçu » mène à « payée ». L’événement « colis remis au transporteur » mène de « payée » à « expédiée », puis « livraison confirmée » de « expédiée » à « livrée ». L’événement « annulation » mène à « annulée », mais seulement depuis « créée » ou « payée » (dans ce dernier cas, avec remboursement) : il n’y a pas de transition d’annulation depuis « expédiée » ou « livrée », ce qui fixe une règle de gestion (après expédition, on passe par un retour, pas par une annulation). « Livrée » et « annulée » sont des états finaux.
Exercice 7 : quel dessin pour quel public ?
Vous devez présenter la même application à trois publics : la direction (qui finance), l’équipe qui va la programmer et l’équipe qui l’installera sur les serveurs. Quel diagramme choisissez-vous pour chacun ?
Voir la réponse
À la direction : les cas d’utilisation (qui en bénéficie, pour quoi faire) et peut-être un diagramme d’activités du processus métier : peu de jargon, vocabulaire du métier. À l’équipe de programmation : le diagramme de classes (structure), accompagné de séquences pour les scénarios délicats et de machines à états pour les objets au cycle de vie complexe. À l’équipe d’exploitation : le diagramme de déploiement (quels blocs sur quels serveurs, quels flux entre eux). Retenez le principe : le bon diagramme est celui que le public peut lire et dont il peut tirer une décision.
9UML aujourd’hui : comment on s’en sert vraiment
9.1Trois façons d’utiliser UML
Martin Fowler, auteur d’un petit livre très lu sur UML, distingue trois usages. Le croquis : on dessine à la main ou sur un tableau, pour réfléchir ou expliquer, sans souci de perfection ; le dessin est jeté ou refait. Le plan (blueprint) : on produit des diagrammes détaillés, que d’autres programmeront ; c’est la vision la plus ancienne et la plus lourde. Le langage de programmation : le modèle est si complet qu’un logiciel en génère tout le code. Dans la pratique actuelle, le croquis domine très largement. Le plan a ses amateurs dans des domaines où l’erreur coûte très cher (aéronautique, rail, dispositifs médicaux). Le « tout automatique » n’a jamais tenu toutes ses promesses : un modèle assez précis pour générer un programme complet devient aussi compliqué qu’un programme.
9.2Dessiner avec du texte
L’évolution la plus visible depuis une quinzaine d’années est le diagramme écrit en texte. Des outils comme PlantUML ou Mermaid transforment quelques lignes (comme l’exemple de la partie 8.1) en un dessin. L’avantage est considérable : un fichier texte se conserve avec le code dans un gestionnaire de versions (voir Git), se compare version par version, se relit en même temps que le code, et se met à jour en quelques secondes. Les diagrammes ne vieillissent plus dans un coin de disque dur. Beaucoup de sites de documentation les affichent automatiquement.
Autre évolution : les assistants d’écriture de code (voir l’intelligence artificielle pour le code) savent produire un diagramme à partir d’une description ou d’un code existant. C’est pratique pour comprendre un projet inconnu, avec une réserve : le dessin généré doit être relu comme tout le reste, car il peut montrer des liens qui n’existent pas.
9.3UML et ses voisins
- Merise : méthode française de conception des systèmes d’information, centrée sur les données (voir la méthode Merise). Le modèle conceptuel des données de Merise et le diagramme de classes d’UML se ressemblent beaucoup, mais le premier se prépare à devenir des tables de base de données (voir le modèle relationnel), le second à devenir du code objet. Beaucoup d’équipes utilisent les deux : l’un pour la base, l’autre pour le programme.
- SysML : une variante d’UML pour décrire des systèmes qui ne sont pas que du logiciel (avions, trains, satellites), mêlant mécanique, électronique et programmes.
- Le modèle C4 : une façon plus récente et plus simple de dessiner l’architecture logicielle en quatre niveaux de zoom (contexte, conteneurs, composants, code), apprécié parce qu’il demande peu de règles à apprendre.
- Les schémas libres : beaucoup d’équipes dessinent avec des rectangles et des flèches sans suivre UML. Ce n’est pas une faute, à condition de dire ce que signifient les formes.
9.4Les pièges
- Le dessin parfait que personne ne lit. Un modèle exhaustif coûte cher à entretenir ; quand le code change, il devient faux, et un dessin faux est pire que pas de dessin.
- Modéliser pour modéliser. Si personne ne tire de décision d’un diagramme, ne le dessinez pas.
- Confondre le modèle et la réalité. Le modèle est une simplification : ce qui n’y figure pas existe quand même.
- Le jargon. Montrer un diagramme de classes chargé à un client le perdra. Un cas d’utilisation ou un diagramme d’activités fera mieux l’affaire.
10Ce qui reste vrai et ce qui a changé
- « UML n’est pas une méthode » reste vrai. C’est même la phrase qu’il faut retenir : UML décrit comment dessiner, pas comment mener un projet.
- Les versions ont changé. La version 1.5 date de 2003 ; UML 2 (2005) a réorganisé le langage et la version actuelle est la 2.5.1 (2017).
- Les listes de vues ont évolué. Il y a quatorze diagrammes au lieu de neuf ; le cas d’utilisation est classé dans le comportement ; « collaboration » est devenu « communication » ; « états-transitions » est devenu « machine à états ».
- Le niveau de visibilité « de paquet » (
~) s’ajoute aux trois niveaux de base. - L’argument économique doit être nuancé. Corriger un dessin coûte moins cher que corriger un logiciel fini : vrai. Un modèle validé par le client comme garantie de conformité : de moins en moins en phase avec les pratiques agiles.
- « Savoir UML pour être embauché » était déjà une exagération et l’est davantage aujourd’hui : on attend surtout de savoir lire et dessiner quelques diagrammes simples, pas de maîtriser les quatorze.
- Les outils ont changé. De gros logiciels de dessin et de génération de code, on est passé à des diagrammes en texte versionnés avec le code.