PlantUML Language specification Class Diagram

       

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Diagramme de classes

• Texte en entrée, diagramme en sortie. Déclarez classes, champs et relations en quelques lignes.
• Se lit comme du code. +, -, # pour la visibilité, : pour les types, () pour les méthodes.
• Annotez librement. Ajoutez notes, couleurs et stéréotypes sans quitter le texte.

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Élément déclaratif

@startuml abstract abstract abstract class "abstract class" annotation annotation circle circle () circle_short_form class class class class_stereo <<stereotype>> dataclass dataclass diamond diamond <> diamond_short_form entity entity enum enum exception exception interface interface metaclass metaclass protocol protocol record record stereotype stereotype struct struct @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Relations entre classes

@startuml Class01 <|-- Class02 Class03 *-- Class04 Class05 o-- Class06 Class07 .. Class08 Class09 -- Class10 @enduml

@startuml Class11 <|.. Class12 Class13 --> Class14 Class15 ..> Class16 Class17 ..|> Class18 Class19 <--* Class20 @enduml

@startuml Class21 #-- Class22 Class23 x-- Class24 Class25 }-- Class26 Class27 +-- Class28 Class29 ^-- Class30 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Étiquette sur les relations

@startuml Class01 "1" *-- "many" Class02 : contains Class03 o-- Class04 : aggregation Class05 --> "1" Class06 @enduml

@startuml class Car Driver - Car : drives > Car *- Wheel : have 4 > Car -- Person : < owns @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Caractères non alphabétiques dans les noms d'éléments et les étiquettes de relations

• Utiliser le mot-clé as dans la définition de la classe
• Metter des guillemets "" autour du nom de la classe

@startuml class "Voici ma classe" as classe1 class classe2 as "Cette façon fonctionne aussi" classe2 *-- "machin/truc" : utilise @enduml

Commencer un nom avec $

@startuml class $C1 class $C2 $C2 class "$C2" as dollarC2 remove $C1 remove $C2 remove dollarC2 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Ajouter des méthodes

@startuml Object <|-- ArrayList Object : equals() ArrayList : Object[] elementData ArrayList : size() @enduml

@startuml class Dummy { String data void methods() } class Flight { flightNumber : Integer departureTime : Date } @enduml

@startuml class Dummy { {field} Un champ (malgré les parenthèses) {method} Une méthode } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Définition de la visibilité

Caractère	Icône pour le champ	Icône de la méthode	Visibilité
-			private
#			protected
~			package private
+			public

@startuml class Machin { -champ1 #champ2 ~methode1() +methode2() } @enduml

@startuml skinparam classAttributeIconSize 0 class Machin { -champ1 #champ2 ~methode1() +methode2() } @enduml

@startuml class Machin { champ1 champ2 methode1() methode2() } @enduml

@startuml class Machin { champ1 \~Machin() methode1() } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Visibility on compositions and aggregations

@startuml class Aaa { -bbb : int +ccc : string #aa : float +void addEntry(mmm : Entry) +int setFactory(ddd : string) } class Factory { #fff : string } class Entry { -yyy : int } class Parent { } Aaa *--> "1..100" Entry : -entries Aaa o--> Factory : #factory Aaa o--> Parent : +parent @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Abstrait et statique

@startuml class Dummy { {static} String id {abstract} void methods() } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Corps de classe avancé

@startuml class Foo1 { You can use several lines .. as you want and group == things together. __ You can have as many groups as you want -- End of class } class User { .. Simple Getter .. + getName() + getAddress() .. Some setter .. + setName() __ private data __ int age -- encrypted -- String password } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Notes et stéréotypes

@startuml class Object << general >> Object <|--- ArrayList note top of Object : In java, every class\nextends this one. note "This is a floating note" as N1 note "This note is connected\nto several objects." as N2 Object .. N2 N2 .. ArrayList class Foo note left: On last defined class @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Plus de notes

• <b>
• <u>
• <i>
• <s> , <del>, <strike>
• <font color="#AAAAAA"> ou <font color="colorName">
• <color:#AAAAAA> ou <color:colorName>
• <size:nn> pour changer la taille de la police
• <img src="file"> ou <img:file>: le fichier doit être accessible par le système de fichiers

@startuml class Foo note left: On last defined class note top of Foo In java, <size:18>every</size> <u>class</u> <b>extends</b> <i>this</i> one. end note note as N1 This note is <u>also</u> <b><color:royalBlue>on several</color> <s>words</s> lines And this is hosted by <img:sourceforge.jpg> end note @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Note sur un champ (champ, attribut, membre) ou une méthode

⚠ Contrainte

• Ne peut pas être utilisé avec top ni bottom (seulsleft et right sont implementés)
• Ne peut pas être utilisé avec le séparateur d'espaces de nommage ::

Note sur un champ ou une méthode

@startuml class A { {static} int counter +void {abstract} start(int timeout) } note right of A::counter This member is annotated end note note right of A::start This method is now explained in a UML note end note @enduml

Note sur une méthode de même nom

@startuml class A { {static} int counter +void {abstract} start(int timeoutms) +void {abstract} start(Duration timeout) } note left of A::counter This member is annotated end note note right of A::"start(int timeoutms)" This method with int end note note right of A::"start(Duration timeout)" This method with Duration end note @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Note sur les liens

@startuml class Dummy Dummy --> Foo : A link note on link #red: note that is red Dummy --> Foo2 : Another link note right on link #blue this is my note on right link and in blue end note @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Classe et interface abstraites

@startuml abstract class AbstractList abstract AbstractCollection interface List interface Collection List <|-- AbstractList Collection <|-- AbstractCollection Collection <|- List AbstractCollection <|- AbstractList AbstractList <|-- ArrayList class ArrayList { Object[] elementData size() } enum TimeUnit { DAYS HOURS MINUTES } annotation SuppressWarnings annotation Annotation { annotation with members String foo() String bar() } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Masquer les attributs et les méthodes

• empty fields ou empty attributes pour des champs vides,
• empty methods pour des méthodes vides,
• fields or attributes qui masque les champs, même s'il y en a de définis,
• methods qui masque les méthodes, même s'il y en a de définies,
• members qui masque les méthodes ou les champs, même s'il y en a de définies,
• circle pour le caractère entouré en face du nom de la classe,
• stereotype pour le stéréotype.

• class pour toutes les classes,
• interface pour toutes les interfaces,
• enum pour tous les enums,
• <<foo1>> pour les classes qui sont stéréotypée avec foo1,
• Un nom de classe existant

@startuml class Dummy1 { +myMethods() } class Dummy2 { +hiddenMethod() } class Dummy3 <<Serializable>> { String name } hide members hide <<Serializable>> circle show Dummy1 methods show <<Serializable>> fields @enduml

@startuml hide private members hide protected members hide package members class Foo { - private # protected ~ package } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Masquer les classes

@startuml class Foo1 class Foo2 Foo2 *-- Foo1 hide Foo2 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Supprimer des classes

@startuml class Foo1 class Foo2 Foo2 *-- Foo1 remove Foo2 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Cacher, Supprimer ou Remettre des éléments marqués (tagged) ou wildcard

@startuml class C1 $tag13 enum E1 interface I1 $tag13 C1 -- I1 @enduml

• cacher le composant tag13 avec hide $tag13 :

@startuml class C1 $tag13 enum E1 interface I1 $tag13 C1 -- I1 hide $tag13 @enduml

• ou supprimer le composant $tag13 avec remove $tag13 :

@startuml class C1 $tag13 enum E1 interface I1 $tag13 C1 -- I1 remove $tag13 @enduml

• ou supprimer le composant tag13 et remettre le composant tag1 avec remove $tag13 et restore $tag1 :

@startuml class C1 $tag13 $tag1 enum E1 interface I1 $tag13 C1 -- I1 remove $tag13 restore $tag1 @enduml

• ou supprimer tous les composants sauf $tag1 avec remove * et restore $tag1 :

@startuml class C1 $tag13 $tag1 enum E1 interface I1 $tag13 C1 -- I1 remove * restore $tag1 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Masquer ou supprimer une classe non liée

@startuml class C1 class C2 class C3 C1 -- C2 @enduml

• hide @unlinked classes

@startuml class C1 class C2 class C3 C1 -- C2 hide @unlinked @enduml

• ou remove @unlinked classes

@startuml class C1 class C2 class C3 C1 -- C2 remove @unlinked @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Utilisation de la généricité

@startuml class Foo<? extends Element> { int size() } Foo *- Element @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Caractère spécial

@startuml class System << (S,#FF7700) Singleton >> class Date << (D,orchid) >> @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Packages

@startuml package "Classic Collections" #DDDDDD { Object <|-- ArrayList } package com.plantuml { Object <|-- Demo1 Demo1 *- Demo2 } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Modèle de paquet

@startuml scale 750 width package foo1 <<Node>> { class Class1 } package foo2 <<Rectangle>> { class Class2 } package foo3 <<Folder>> { class Class3 } package foo4 <<Frame>> { class Class4 } package foo5 <<Cloud>> { class Class5 } package foo6 <<Database>> { class Class6 } @enduml

@startuml skinparam packageStyle rectangle package foo1.foo2 { } package foo1.foo2.foo3 { class Object } foo1.foo2 +-- foo1.foo2.foo3 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Les espaces de nommage

@startuml class BaseClass namespace net.dummy #DDDDDD { .BaseClass <|-- Person Meeting o-- Person .BaseClass <|- Meeting } namespace net.foo { net.dummy.Person <|- Person .BaseClass <|-- Person net.dummy.Meeting o-- Person } BaseClass <|-- net.unused.Person @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Creation automatique d'espace de nommage

@startuml set separator :: class X1::X2::foo { some info } @enduml

@startuml set separator none class X1.X2.foo { some info } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Interface boucle

• bar ()- foo
• bar ()-- foo
• foo -() bar

@startuml class foo bar ()- foo @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Changer la direction des flèches

@startuml Room o- Student Room *-- Chair @enduml

@startuml Student -o Room Chair --* Room @enduml

@startuml foo -left-> dummyLeft foo -right-> dummyRight foo -up-> dummyUp foo -down-> dummyDown @enduml

@startuml left to right direction foo -left-> dummyLeft foo -right-> dummyRight foo -up-> dummyUp foo -down-> dummyDown @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Classes d'association

@startuml class Student { Name } Student "0..*" - "1..*" Course (Student, Course) .. Enrollment class Enrollment { drop() cancel() } @enduml

@startuml class Student { Name } Student "0..*" -- "1..*" Course (Student, Course) . Enrollment class Enrollment { drop() cancel() } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Association sur la même classe

@startuml class Station { +name: string } class StationCrossing { +cost: TimeInterval } <> diamond StationCrossing . diamond diamond - "from 0..*" Station diamond - "to 0..* " Station @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Personnalisation

• Dans le diagramme, comme toutes les autre commandes,
• Dans un fichier inclus,
• Dans un fichier de configuration précisé par la ligne de commande ou la tâche ANT.

@startuml skinparam class { BackgroundColor PaleGreen ArrowColor SeaGreen BorderColor SpringGreen } skinparam stereotypeCBackgroundColor YellowGreen Class01 "1" *-- "many" Class02 : contains Class03 o-- Class04 : aggregation @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Stéréotypes Personnalisés

@startuml skinparam class { BackgroundColor PaleGreen ArrowColor SeaGreen BorderColor SpringGreen BackgroundColor<<Foo>> Wheat BorderColor<<Foo>> Tomato } skinparam stereotypeCBackgroundColor YellowGreen skinparam stereotypeCBackgroundColor<< Foo >> DimGray class Class01 <<Foo>> class Class03 <<Foo>> Class01 "1" *-- "many" Class02 : contains Class03 o-- Class04 : aggregation @enduml

• BackgroundColor_<<Foo>> Wheat
• skinparam stereotypeCBackgroundColor_<<Foo>> DimGray

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Dégradé de couleurs

• | ,
• / ,
• \ , ou
• -

@startuml skinparam backgroundcolor AntiqueWhite/Gold skinparam classBackgroundColor Wheat|CornflowerBlue class Foo #red-green note left of Foo #blue\9932CC this is my note on this class end note package example #GreenYellow/LightGoldenRodYellow { class Dummy } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Aide pour la mise en page

@startuml class Bar1 class Bar2 together { class Together1 class Together2 class Together3 } Together1 - Together2 Together2 - Together3 Together2 -[hidden]--> Bar1 Bar1 -[hidden]> Bar2 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Découper les grands diagrammes

@startuml ' Split into 4 pages page 2x2 skinparam pageMargin 10 skinparam pageExternalColor gray skinparam pageBorderColor black class BaseClass namespace net.dummy #DDDDDD { .BaseClass <|-- Person Meeting o-- Person .BaseClass <|- Meeting } namespace net.foo { net.dummy.Person <|- Person .BaseClass <|-- Person net.dummy.Meeting o-- Person } BaseClass <|-- net.unused.Person @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Extension et implementation [extends, implements]

@startuml class ArrayList implements List class ArrayList extends AbstractList @enduml

@startuml class A extends B, C { } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Relations entre crochets (liens ou flèches) style

Style de ligne

• sans étiquette

@startuml title Bracketed line style without label class foo class bar bar1 : [bold] bar2 : [dashed] bar3 : [dotted] bar4 : [hidden] bar5 : [plain] foo --> bar foo -[bold]-> bar1 foo -[dashed]-> bar2 foo -[dotted]-> bar3 foo -[hidden]-> bar4 foo -[plain]-> bar5 @enduml

• avec étiquette

@startuml title Bracketed line style with label class foo class bar bar1 : [bold] bar2 : [dashed] bar3 : [dotted] bar4 : [hidden] bar5 : [plain] foo --> bar : ∅ foo -[bold]-> bar1 : [bold] foo -[dashed]-> bar2 : [dashed] foo -[dotted]-> bar3 : [dotted] foo -[hidden]-> bar4 : [hidden] foo -[plain]-> bar5 : [plain] @enduml

Couleur de ligne

@startuml title Bracketed line color class foo class bar bar1 : [#red] bar2 : [#green] bar3 : [#blue] foo --> bar foo -[#red]-> bar1 : [#red] foo -[#green]-> bar2 : [#green] foo -[#blue]-> bar3 : [#blue] 'foo -[#blue;#yellow;#green]-> bar4 @enduml

Épaisseur de ligne

@startuml title Bracketed line thickness class foo class bar bar1 : [thickness=1] bar2 : [thickness=2] bar3 : [thickness=4] bar4 : [thickness=8] bar5 : [thickness=16] foo --> bar : ∅ foo -[thickness=1]-> bar1 : [1] foo -[thickness=2]-> bar2 : [2] foo -[thickness=4]-> bar3 : [4] foo -[thickness=8]-> bar4 : [8] foo -[thickness=16]-> bar5 : [16] @enduml

Mélange

@startuml title Bracketed line style mix class foo class bar bar1 : [#red,thickness=1] bar2 : [#red,dashed,thickness=2] bar3 : [#green,dashed,thickness=4] bar4 : [#blue,dotted,thickness=8] bar5 : [#blue,plain,thickness=16] foo --> bar : ∅ foo -[#red,thickness=1]-> bar1 : [#red,1] foo -[#red,dashed,thickness=2]-> bar2 : [#red,dashed,2] foo -[#green,dashed,thickness=4]-> bar3 : [#green,dashed,4] foo -[#blue,dotted,thickness=8]-> bar4 : [blue,dotted,8] foo -[#blue,plain,thickness=16]-> bar5 : [blue,plain,16] @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Modifier la couleur et le style d'une relation (lien ou flèche) (style en ligne)

• #color;line.[bold|dashed|dotted];text:color

@startuml class foo foo --> bar : normal foo --> bar1 #line:red;line.bold;text:red : red bold foo --> bar2 #green;line.dashed;text:green : green dashed foo --> bar3 #blue;line.dotted;text:blue : blue dotted @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Modifier la couleur et le style d'une classe (style en ligne)

• #color ##[style]color

@startuml abstract abstract annotation annotation #pink ##[bold]red class class #palegreen ##[dashed]green interface interface #aliceblue ##[dotted]blue @enduml

• #[color|back:color];header:color;line:color;line.[bold|dashed|dotted];text:color

@startuml abstract abstract annotation annotation #pink;line:red;line.bold;text:red class class #palegreen;line:green;line.dashed;text:green interface interface #aliceblue;line:blue;line.dotted;text:blue @enduml

@startuml class bar #line:green;back:lightblue class bar2 #lightblue;line:green class Foo1 #back:red;line:00FFFF class FooDashed #line.dashed:blue class FooDotted #line.dotted:blue class FooBold #line.bold class Demo1 #back:lightgreen|yellow;header:blue/red @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Flèches de/vers les membres de la classe

@startuml class Foo { + field1 + field2 } class Bar { + field3 + field4 } Foo::field1 --> Bar::field3 : foo Foo::field2 --> Bar::field4 : bar @enduml

@startuml left to right direction class User { id : INTEGER .. other_id : INTEGER } class Email { id : INTEGER .. user_id : INTEGER address : INTEGER } User::id *-- Email::user_id @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Regroupement de flèche d'héritage

GroupInheritance 1 (pas de regroupement)

@startuml skinparam groupInheritance 1 A1 <|-- B1 A2 <|-- B2 A2 <|-- C2 A3 <|-- B3 A3 <|-- C3 A3 <|-- D3 A4 <|-- B4 A4 <|-- C4 A4 <|-- D4 A4 <|-- E4 @enduml

GroupInheritance 2 (regroupement à partir de 2)

@startuml skinparam groupInheritance 2 A1 <|-- B1 A2 <|-- B2 A2 <|-- C2 A3 <|-- B3 A3 <|-- C3 A3 <|-- D3 A4 <|-- B4 A4 <|-- C4 A4 <|-- D4 A4 <|-- E4 @enduml

GroupInheritance 3 (regroupement uniquement à partir de 3)

@startuml skinparam groupInheritance 3 A1 <|-- B1 A2 <|-- B2 A2 <|-- C2 A3 <|-- B3 A3 <|-- C3 A3 <|-- D3 A4 <|-- B4 A4 <|-- C4 A4 <|-- D4 A4 <|-- E4 @enduml

GroupInheritance 4 (regroupement uniquement à partir de 4)

@startuml skinparam groupInheritance 4 A1 <|-- B1 A2 <|-- B2 A2 <|-- C2 A3 <|-- B3 A3 <|-- C3 A3 <|-- D3 A4 <|-- B4 A4 <|-- C4 A4 <|-- D4 A4 <|-- E4 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Display JSON Data on Class or Object diagram

Simple example

@startuml class Class object Object json JSON { "fruit":"Apple", "size":"Large", "color": ["Red", "Green"] } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Packages and Namespaces Enhancement

@startuml class A.B.C.D.Z { } @enduml

@startuml set separator none class A.B.C.D.Z { } @enduml

@startuml !pragma useIntermediatePackages false class A.B.C.D.Z { } @enduml

@startuml set separator none package A.B.C.D { class Z { } } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Qualified associations

Minimal example

@startuml class class1 class class2 class1 [Qualifier] - class2 @enduml

Another example

@startuml interface Map<K,V> class HashMap<Long,Customer> Map <|.. HashMap Shop [customerId: long] ---> "customer\n1" Customer HashMap [id: Long] -r-> "value" Customer @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Change diagram orientation

• top to bottom direction (by default)
• left to right direction

Top to bottom (by default)

With Graphviz (layout engine by default)

@startuml class a class b package A { class a1 class a2 class a3 class a4 class a5 package sub_a { class sa1 class sa2 class sa3 } } package B { class b1 class b2 class b3 class b4 class b5 package sub_b { class sb1 class sb2 class sb3 } } @enduml

With Smetana (internal layout engine)

@startuml !pragma layout smetana class a class b package A { class a1 class a2 class a3 class a4 class a5 package sub_a { class sa1 class sa2 class sa3 } } package B { class b1 class b2 class b3 class b4 class b5 package sub_b { class sb1 class sb2 class sb3 } } @enduml

Left to right

With Graphviz (layout engine by default)

@startuml left to right direction class a class b package A { class a1 class a2 class a3 class a4 class a5 package sub_a { class sa1 class sa2 class sa3 } } package B { class b1 class b2 class b3 class b4 class b5 package sub_b { class sb1 class sb2 class sb3 } } @enduml

With Smetana (internal layout engine)

@startuml !pragma layout smetana left to right direction class a class b package A { class a1 class a2 class a3 class a4 class a5 package sub_a { class sa1 class sa2 class sa3 } } package B { class b1 class b2 class b3 class b4 class b5 package sub_b { class sb1 class sb2 class sb3 } } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Role label to associations

@startuml class User class Item User "owner which is very long"/1 -- "0..n"/items Item @enduml