Generazione di diagrammi UML con Maven

I diagrammi UML di un modulo software, sono sempre una documentazione utile per il nostro progetto. In questo articolo vediamo come crearli automaticamente utilizzando un plugin di Maven

Installazione di GraphViz

Prima di tutto dobbiamo installare, nel computer che effettua il build del progetto, GraphViz. Questo è un software opensource per la realizzazione di grafi di qualsiasi tipo, che possono essere generati a partire da una descrizione testuale. Ad esempio per realizzare un semplice grafo come il seguente

graph

 

Dobbiamo fornire la seguente descrizione testuale

e poi richiamare l’utility dot, presente nel pacchetto di GraphViz, per realizzare l’immagine

Per quello che riguarda la generazione di diagrammi UML, dobbiamo semplicemente installare il programma sul nostro computer e riavviarlo (o fare logout) perchè le variabili d’ambiente vengono impostate durante l’installazione.

 

Configurazione di UMLGraph

UMLGraph è il tool che utilizza GraphViz per realizzare dei diagrammi UML a partire dal nostro codice sorgente. Esiste un plugin Maven che ci permette di configurare la generazione di questi diagrammi durante la creazione della documentazione relativa al nostro progetto. Qui di seguito trovate la configurazione per un semplice progetto di test

 

Generazione dei diagrammi

Una volta configurato il nostro progetto Maven basta lanciare il comando per la generazione della documentazione legata al progetto

e quando è completata andare a vedere nella cartella $HOME_PROGETTO/target/site/apidocs. Qui dovreste trovare il file index.html che è praticamente la radice della vostra documentazione Javadoc. Visualizzandolo in un browser, troverete nei vostri package i diagrammi UML relativi.

diagrammaClassi

Semplice diagramma delle classi

 

 

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *