PlantUML Language specification Class Diagram

       

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Klassendiagramm

• Text rein, Diagramm raus. Klassen, Felder und Beziehungen in wenigen Zeilen deklarieren.
• Liest sich wie Code. +, -, # für Sichtbarkeit, : für Typen, () für Methoden.
• Frei annotierbar. Notizen, Farben und Stereotype hinzufügen, ohne den Text zu verlassen.

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Element deklarieren

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Beziehungen zwischen Klassen

@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

Beschriften von Beziehungen

@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

Verwendung von Sonderzeichen

• Verwenden Sie das as Schlüsselwort in der Definition
• Schließen Sie den Namen in Hochommas "" ein

@startuml class "This is my class" as class1 class class2 as "It works this way too" class2 *-- "foo/dummy" : use @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Methoden hinzufügen

@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} A field (despite parentheses) {method} Some method } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Sichtbarkeit festlegen

Character	Icon for field	Icon for method	Visibility
-			private
#			protected
~			package private
+			public

@startuml class Dummy { -field1 #field2 ~method1() +method2() } @enduml

@startuml skinparam classAttributeIconSize 0 class Dummy { -field1 #field2 ~method1() +method2() } @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

Abstract und Static

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Der Klassenrumpf für Fortgeschrittene

@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

Notizen und Stereotypen

@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

Mehr zu Notizen

• <b>
• <u>
• <i>
• <s>, <del>, <strike>
• <font color="#AAAAAA"> or <font color="colorName">
• <color:#AAAAAA> or <color:colorName>
• <size:nn> to change font size
• <img src="file"> or <img:file>: the file must be accessible by the filesystem

@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 on field (field, attribute, member) or method

⚠ Constraint

• This cannot be used with top or bottom (only left and right are implemented)
• This cannot be used with namespaceSeparator ::

Note on field or method

@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 on method with the same name

@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

Notizen zu Beziehungen

@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

Abstrakte Klassen und Interfaces

@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 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Verstecken von Attributen, Methoden ...

• empty fields oder empty attributes für leere Felder,
• empty methods für leere Methoden,
• fields oder attributes um Felder auszublenden, auch wenn diese definiert sind,
• methods um Methoden auszublenden, auch wenn diese definiert sind,
• members um Methoden und Felder auszublenden, auch wenn diese definiert sind,
• circle um einen in einen Kreis eingeschlossenen Buchstaben vor dem Klassennamen anzuzeigen,
• stereotype um einen Stereotypen anzuzeigen.

• class für alle Klassen,
• interface für alle Schnittstellen,
• enum für alle Enums,
• <<foo1>> für alle Klassen, die mit dem Stereotyp foo1 ausgezeichnet sind,
• einen namen einer existierenden Klasse.

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Verstecken von Klassen

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Klassen entfernen

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Hide, Remove or Restore tagged element or wildcard

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

• hide $tag13 components:

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

• or remove $tag13 components:

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

• or remove $tag13 and restore $tag1 components:

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

• or remove * and restore $tag1 components:

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Hide or Remove unlinked class

@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

• or remove @unlinked classes:

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Verwenden von Generics

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Besondere Hervorhebungen

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Pakete

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Paketarten

@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

Namensraum

@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

Automatische Erzeugung eines Namensraums

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

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Lollipop Schnittstellen

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

@startuml class foo bar ()- foo @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Ändern der Pfeilrichtung

@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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Assoziationsklassen

@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

Assoziation in derselben Klasse

@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

Der Skinparam-Befehl

• Wie alle ander Befehle In einer Diagrammdefinition,
• in einer Include-Datei,
• In einer Konfigurationsdatei, die durch die Kommandozeile oder den ANT-Task übergeben wird.

@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

Das Aussehen von Stereotypen verändern

@startuml skinparam class { BackgroundColor PaleGreen ArrowColor SeaGreen BorderColor SpringGreen BackgroundColor<<Foo>> Wheat BorderColor<<Foo>> Tomato } skinparam stereotypeCBackgroundColor YellowGreen skinparam stereotypeCBackgroundColor<< Foo >> DimGray Class01 <<Foo>> 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

Farbverlauf

• |,
• /,
• \,
• oder -

@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

Hilfe beim Layout

@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

Große Dateien aufteilen

@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

Extends und Implements

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Design Möglichkeiten für Beziehungen (Verknüpfungen oder Pfeile)

Linienstil

• ohne Label

@startuml title Linienstile ohne Beschriftung 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

• mit Beschriftung

@startuml title Linienstile mit Beschriftung 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

Linienfarbe

@startuml title Farbige Linien 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

Linienstärke

@startuml title Unterschiedlich dicke Linien 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

Mischung

@startuml title Gemischte Designs 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

Ändern der Farbe und des Stils von Beziehungen (Verknüpfungen oder Pfeilen) (Inline-Stil)

• #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

Ändern der Farbe und des Stils einer Klasse (Inline-Stil)

• #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

Pfeile von/zu Klassen Attributen und Methoden

@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

Gruppierung von Vererbungspfeilspitzen

GroupInheritance 1 (keine Gruppierung)

@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

Gruppenvererbung 2 (Gruppierung ab 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

Gruppenvererbung 3 (Gruppierung nur ab 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

Gruppenvererbung 4 (Gruppierung nur ab 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

Anzeige von JSON-Daten im Klassen- oder Objektdiagramm

Einfaches Beispiel

@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