Génération de diagrammes de classes UML avec UMLGraph

package com.developpez.rpouiller.umlgraph;

/**
 * Définit l'interface générale.
 * @note Definit l'interface generale. 
 */
public interface Abstraction {
    
    /**
     * Méthode générale.
     */
    public void operation();
}

package com.developpez.rpouiller.umlgraph;

/**
 * Implémente l'interface générale.
 * @note Implemente l'interface generale.
 */
public class Implementation implements Abstraction {
    
    /**
     * Implémentation de la méthode 
     * pour l'opération de base 
     */
    public void operation() {
        System.out.println("Implementation");
    }
}

package com.developpez.rpouiller.umlgraph;

/**
 * Implémente un décorateur.
 * @note Definit l'interface du decorateur et 
 * contient une reference vers un objet Abstraction.
 * @stereotype Decorator
 * @composed - - - Abstraction
 */
public class Decorateur implements Abstraction {
    private Abstraction abstraction;
    
    /**
     * Le constructeur du "Decorateur" reçoit un objet "Abstraction"
     * @param pAbstraction
     */
    public Decorateur(final Abstraction pAbstraction) {
        abstraction = pAbstraction;
    }
    
    /**
     * Implémentation de la méthode pour la décoration.
     * Des opérations sont effectuées avant et après l'appel 
     * à la méthode de l'objet "Abstraction" passé au constructeur.
     * La méthode ignore si cet objet est un autre décorateur ou l'implémentation.
     */
    public void operation() {
        System.out.println("Decorateur avant");
        abstraction.operation();
        System.out.println("Decorateur apres");
    }
}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -operations -visibility -package -output diagramme.dot src\com\developpez\rpouiller\umlgraph\*.java

dot -Tpng -odiagramme.png diagramme.dot

<project default="javadocs">
	<property name="src.dir" location="src"/>
	<property name="reports.dir" location="reports"/>
	<property name="umlgraph.dir" location="[emplacement du jar d'UMLGraph]"/>
	
	<target name="javadocs">
		<mkdir dir="${reports.dir}/javadoc" />
		<javadoc 
			sourcepath="${src.dir}" 
			packagenames="com.developpez.rpouiller.umlgraph.*" 
			destdir="${reports.dir}/javadoc" >
			
			<doclet name="org.umlgraph.doclet.UmlGraphDoc" path="${umlgraph.dir}/UMLGraph.jar">
				<param name="-operations" />
				<param name="-visibility" />
				<param name="-package" />
			</doclet>
		</javadoc>
	</target>
</project>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>
<groupId>com.developpez</groupId>
<artifactId>rpouiller-umlgraph</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>

<build>
	<plugins>
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-javadoc-plugin</artifactId>
			<configuration>
				<source>1.6</source>
				<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
				<docletArtifact>
					<groupId>org.umlgraph</groupId>
					<artifactId>doclet</artifactId>
					<version>5.2</version>
				</docletArtifact>
				<additionalparam>
					-operations -visibility
				</additionalparam>
      			<useStandardDocletOptions>true</useStandardDocletOptions>
			</configuration>
		</plugin>
	</plugins>
</build>	
</project>

mvn javadoc:javadoc

/**
 * @hidden
 * @opt constructors
 * @opt types
 */
class UMLOptions {}

/**
 * @hidden
 * @opt nodefillcolor orange
 */
class UMLNoteOptions {}

/**
 * @opt !bgcolor
 */
class UneClasse {}

/**
 * @view
 * @opt all
 * @opt bgcolor blue
 * 
 * @match class com.developpez.rpouiller.umlgraph.(Classe1|Classe3)
 * @opt nodefillcolor orange
 * @opt nodefontcolor red
 * 
 * @match class com.developpez.rpouiller.umlgraph.Classe2
 * @opt nodefillcolor yellow
 * @opt nodefontcolor green
 */
class Vue {} extends VueAbstraite

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape package
 */
public interface Package {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape component
 */
public class Component implements Package {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape collaboration
 */
public class Collaboration extends Component {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape usecase
 */
public class Usecase extends Component {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape node
 */
public class Node implements Package {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * Classe active
 * @opt commentname
 * @opt shape activeclass
 */
public class Activeclass extends Node {}

package com.developpez.rpouiller.umlgraph.formes;

/**
 * @opt shape class
 * @opt all
 */
public class Class extends Node {
	private int attributPrive;
	protected int attributProtege;
	int attributDefaut;
	public int attributPublic;
	private void methodePrivee() {};
	protected void methodeProtegee() {};
	void methodeDefaut() {};
	public void methodePublique() {};
}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -private src\com\developpez\rpouiller\umlgraph\formes\*.java && dot -Tpng -ograph.png graph.dot

package com.developpez.rpouiller.umlgraph.couleurs;

/**
 * @hidden
 * @opt horizontal
 * @opt ranksep 0.2
 * @opt bgcolor antiquewhite2
 * @opt nodefillcolor darkgoldenrod
 * @opt edgecolor red
 * @opt edgefontcolor forestgreen
 */
class UMLOptions {}

package com.developpez.rpouiller.umlgraph.couleurs;

/**
 * @hidden
 * @opt nodefillcolor crimson
 * @opt nodefontcolor blue
 */
class UMLNoteOptions {}

package com.developpez.rpouiller.umlgraph.couleurs;

/**
 * @note Une note
 * @opt nodefillcolor gold
 * @opt nodefontcolor green
 * 
 * @assoc 1\ninfo "nom\nRelation" 2 Classe2
 */
public class Classe1 {}

package com.developpez.rpouiller.umlgraph.couleurs;

/**
 * @opt constructors
 * @opt visibility
 */
public class Classe2 {}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -private src\com\developpez\rpouiller\umlgraph\couleurs\*.java && dot -Tpng -ograph.png graph.dot

package com.developpez.rpouiller.umlgraph.caracteres;

/**
 * @hidden
 * @opt attributes
 * @opt operations
 * @opt qualify
 * @opt types
 * @opt enumconstants
 * @opt enumerations
 * @opt postfixpackage
 * @opt nodesep 0.1
 * 
 * @opt nodefontclassname "Arial Bold"
 * @opt nodefontclassabstractname "Arial Italic"
 * @opt nodefontclasssize 16
 * 
 * @opt nodefontname "Times New Roman Bold"
 * @opt nodefontabstractname "Times New Roman Italic"
 * @opt nodefontsize 10
 * 
 * @opt nodefonttagname "Courier New Italic"
 * @opt nodefonttagsize 10
 * 
 * @opt nodefontpackagename "Comic Sans MS"
 * @opt nodefontpackagesize 10
 * 
 * @opt edgefontname "Courier New Bold"
 * @opt edgefontsize 12
 */
public class UMLOptions {}

package com.developpez.rpouiller.umlgraph.caracteres;

/**
 * @stereotype abstraction
 */
public abstract class ClasseAbstraite {
	/**
	 * @stereotype Champs
	 */
	private int unChamps;
	
	/**
	 * @stereotype Methode
	 */
	protected abstract long uneMethode();
}

package com.developpez.rpouiller.umlgraph.caracteres;

/**
 * @stereotype Implementation
 * @opt noguillemot
 * @tagvalue version 2.0
 * @assoc - relation - ClasseAssociee
 */
public class ClasseConcrete extends ClasseAbstraite {

	/**
	 * @tagvalue depuis 1.0
	 */
	public char caractere;
	
	/**
	 * @stereotype resultat
	 * @tagvalue retour 0
	 */
	protected long uneMethode() {
		return 0;
	}
}

package com.developpez.rpouiller.umlgraph.caracteres;

/**
 * @stereotype cache
 * @opt !qualify
 */
public class ClasseConcrete2 extends ClasseAbstraite {

	protected long uneMethode() {
		return 1;
	}
}

package com.developpez.rpouiller.umlgraph.caracteres;

/**
 * @opt !qualify
 */
public class ClasseAssociee {}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -private src\com\developpez\rpouiller\umlgraph\caracteres\*.java && dot -Tpng -ograph.png graph.dot

package com.developpez.rpouiller.umlgraph.relations;

import com.developpez.rpouiller.umlgraph.relations.souspack.Interface2;

public interface Interface extends Interface2 {}

package com.developpez.rpouiller.umlgraph.relations.souspack;

public interface Interface2 {}

package com.developpez.rpouiller.umlgraph.relations;

public class Element {}

package com.developpez.rpouiller.umlgraph.relations.souspack;

public class Element2 {}

package com.developpez.rpouiller.umlgraph.relations;

public class Dependance {}

package com.developpez.rpouiller.umlgraph.relations.souspack;

public class Dependance2 {}

package com.developpez.rpouiller.umlgraph.relations;

public class Classe2 {}

package com.developpez.rpouiller.umlgraph.relations;

public class Classe3 {}

package com.developpez.rpouiller.umlgraph.relations;

/**
 * @opt inferrel
 * @opt collpackages java.util.*
 * @opt inferdep
 * @opt inferdepinpackage
 * @opt useimports
 * @opt hide java.*
 * @opt postfixpackage
 * @opt all
 * @opt !constructors
 * @opt nodefontpackagesize 8
 * @hidden
 */
public class UMLOptions {

	// Explication des annotations :
	// @opt inferrel et collpackages      : permet le lien entre ClasseAbstraite et Element
	// @opt inferdep et inferdepinpackage : permet les liens entre ClasseAbstraite-Classe et Dependance
	// @opt useimports                    : permet le lien entre Interface et Interface2

}

package com.developpez.rpouiller.umlgraph.relations;

import java.util.List;

/**
 * @opt inferreltype composed
 * @has 1 possede * com.developpez.rpouiller.umlgraph.relations.souspack.Element2
 * @navassoc - gere - Interface
 */
public abstract class ClasseAbstraite {

	// Explication des annotations :
	// @opt inferreltype : indique que le lien entre ClasseAbstraite et Element sera une composition
	// @has              : permet le lien entre ClasseAbstraite et Element2
	// @navassoc         : permet le lien entre ClasseAbstraite et Interface

	protected List<Element> listeElements;
	
	public abstract Dependance getDependance();
}

package com.developpez.rpouiller.umlgraph.relations;

/**
 * @depend - utilise - com.developpez.rpouiller.umlgraph.relations.souspack.Dependance2
 * @composed - comporte 4 Classe2
 * @assoc * associe * Classe3
 */
public class Classe extends ClasseAbstraite implements Interface {

	// Explication des annotations :
	// @depend   : permet le lien entre Classe et Dependance2
	// @composed : permet le lien entre Classe et Classe2
	// @assoc    : permet le lien entre Classe et Classe3
	
	public Dependance getDependance() {
		return null;
	}
}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -private src\com\developpez\rpouiller\umlgraph\relations\*.java && dot -Tpng -ograph.png graph.dot

class ClassGraph {
    ...
    static {
	associationMap.put(RelationType.ASSOC, "arrowhead=none");
	associationMap.put(RelationType.NAVASSOC, "arrowhead=open");
	associationMap.put(RelationType.HAS, "arrowhead=none, arrowtail=ediamond, dir=back");
	associationMap.put(RelationType.COMPOSED, "arrowhead=none, arrowtail=diamond, dir=back");
	associationMap.put(RelationType.DEPEND, "arrowhead=open, style=dashed");
    }
    ...

package com.developpez.rpouiller.umlgraph.vues;

public class Classe1 {
	private int champs;
}

package com.developpez.rpouiller.umlgraph.vues;

/**
 * @depend - - - Classe3
 */
public class Classe2 {
	protected Classe3 methode() {
		return null;
	};
}

package com.developpez.rpouiller.umlgraph.vues;

public class Classe3 extends Classe1 {
	public Valeur valeur;
}

package com.developpez.rpouiller.umlgraph.vues;

public enum Valeur {
	VALEUR_1, VALEUR_2, VALEUR_3
}

package com.developpez.rpouiller.umlgraph.vues;

/**
 * @view
 * @opt types
 * @opt visibility
 */
public abstract class AbstractVue {}

package com.developpez.rpouiller.umlgraph.vues;

/**
 * @view
 * @opt attributes
 * @opt hide
 * 
 * @match class com.developpez.rpouiller.umlgraph.vues.(Classe1|Classe3)
 * @opt !hide
 */
public class Vue1 extends AbstractVue {}

package com.developpez.rpouiller.umlgraph.vues;

/**
 * @view
 * @opt operations
 * 
 * @match class com.developpez.rpouiller.umlgraph.vues.Classe1
 * @opt hide
 */
public class Vue2 extends AbstractVue {}

package com.developpez.rpouiller.umlgraph.vues;

/**
 * @view
 * @opt enumerations
 * @opt enumconstants
 * 
 * @match class com.developpez.rpouiller.umlgraph.vues.(Classe1|Classe2|Classe3)
 * @opt nodefillcolor LightGray
 * 
 * @match class com.developpez.rpouiller.umlgraph.vues.Valeur
 * @opt nodefillcolor antiquewhite2
 */
public class Vue3 {}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -views -private src\com\developpez\rpouiller\umlgraph\vues\*.java 
				&& dot -Tpng -oVue1.png Vue1.dot && dot -Tpng -oVue2.png Vue2.dot && dot -Tpng -oVue3.png Vue3.dot

LazyList http://commons.apache.org/collections/api-release/org/apache/commons/collections/list
StringUtils http://commons.apache.org/lang/api-release/org/apache/commons/lang

package com.developpez.rpouiller.umlgraph.liens;

/**
 * @view
 * @opt all
 * @opt qualify
 * @opt inferrel
 * @opt inferdep
 * @opt apidocmap liens.txt
 * @opt apidocroot http://rpouiller.developpez.com/tutoriels/java/generation-diagrammes-uml-avec-umlgraph
 * @opt link http://java.sun.com/j2se/1.5.0/docs/api
 */
public class Vue {}

package com.developpez.rpouiller.umlgraph.liens;

import java.util.List;

import org.apache.commons.collections.Factory;
import org.apache.commons.collections.list.LazyList;
import org.apache.commons.lang.StringUtils;

/**
 * @depend - - - java.math.BigDecimal
 * @has - - - StringUtils
 */
public class Classe extends LazyList {

	StringUtils util;
	
	protected Classe(List list, Factory factory) {
		super(list, factory);
	}	
}

java -classpath "%UMLGRAPH_HOME%\UmlGraph.jar;%JAVA_HOME%\lib\Tools.jar" org.umlgraph.doclet.UmlGraph -view com.developpez.rpouiller.umlgraph.liens.Vue 
				-private src\com\developpez\rpouiller\umlgraph\liens\*.java && dot -Tsvg -oVue.svg Vue.dot