Plan de travail


GTD Power


- regarder une structure HTML cours pour modèle (approndissement Java) (Markdown → HTML conforme)
- Transcrire le sujet
- Rediger
- Faire relire
- Propriété Intellectuel ?

Sujet


  • mettre en oeuvre l'outil sur une application Java → diagramme UML,
  • annoter le code Java pour influencer le diagramme UML,
  • délivrables : tutorial
Plan


1) Introduction

Dans le cadre du projet de fin d'option ILOG, nous avons testé, analysé et utilisé et l'outil UMLGraph.
Cet outil permet de générer un diagramme UML à partir de source Java.

* UMLGraph ?

UMLGraph est un programme Doclet pour Javadoc permettant de générer des diagrammes UML (diagrammes de classes ou de diagrammes de séquences) à partir du code Java et plus particulièrement des annotations ajoutées au code. L'article présentera uniquement la génération des diagrammes de classes.
UMLGraph s'appuie sur Graphviz pour la génération de diagrammes de classes. GraphVizpermet de manipuler des graphes définis par le langage DOT et permet surtout de créer des fichiers d'images à partir de ces graphes. Ainsi, UMLGraph crée des fichiers .dot qui sont traités par GraphViz.
UMLGraph est utilisable de plusieurs manières : en ligne de commande ou depuis la tâche Ant ou le plugin Maven qui génèrent la Javadoc. Il existe également un plugin Maven (Dotuml) pour UMLGraph et un plugin Light UML Eclipse; mais les projets ne semblent plus actifs. La dernière release pour Dotuml date de 2007 pour Maven 1.1 et la dernière release pour Light UMl date de 2006.
UMLGraph a été principalement développé par Diomidis D. Spinellis.

* Les outils périphériques

Pour pouvoir visualiser les fichiers dot générés et les partager en ligne, il est possible d'utiliser http://graph.gafol.net.
Nous utilisons des scripts bat pour automatiser les tâches et les démonstrations.

* L'intérêt

UMLGraph facilite la compréhension des sources d'un programme Java.
Dans ce langage de programmation chaque classe doit être écrite dans un fichier différent.
Il est donc relativement fastidieux d'analyser le comportement d'un programme, plusieurs fichiers ouverts simultanément.
Le plus rapide est de regarder les diagrammes de conceptions UML, mais dans le cas ou ceux ci ne sont pas fournis UMLGraph est d'alors d'une grande utilité.

2) Mise en Oeuvre

Pour utilisé UMLGraph il est nécessaire d'installer le JDK de Sun 1.6.
La version d'UMLGraph que nous avons utiliser est la version 5.2 et la version de GraphViz est la dernière en date.
Les outils sont disposés dans un répertoire nommé Tools.
Le logiciel s'utilise ensuite en ligne de commande.

Positionnement des variables d'environement
set JAVA_HOME=Tools\jdk1.6.0_14
set GRAPHVIZ_HOME=Tools\GraphViz
set UMLGRAPH_HOMEDIR=Tools\UMLGraph-5.2
set PATH=%GRAPHVIZ_HOME%\bin;%UMLGRAPH_HOMEDIR%\bin;%JAVA_HOME%\bin;%PATH%

Lancement d'UMLGraph
java -classpath “UmlGraph.jar;jdk_tools.jar” org.umlgraph.doclet.UmlGraph -package Test.java

Génération du diagramme
dot -Tpng -o graph.png graph.dot

Le paramètre -Tpng définie le format de sortie du fichier image, le paramètre -o permet de définir les fichiers de sortie.

3) Démonstration

Dans un premier temps nous faisons une démonstration avec un exemple très simple test.java.
Il s'agit d'une classe Person qui dispose simplement d'un attribut Name (de type chaîne de caractère), et le prototype des classes Employee et Client.
Pour transformer cette classe en diagramme UML nous utilisons le fichier de script test.bat.
Le résultat est le suivant http://graph.gafol.net/bGALTYaPZ.

diagram_DesignPattern_Decorator.bat

4) Référence

- http://www.umlgraph.org/doc/indexw.html

 
umlgraph.txt · Dernière modification: Le 29/07/2010 à 20:20 par migrate-to-doku     Haut de page
Recent changes RSS feed Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki Design by Chirripó