PlantUML Language specification Class Diagram

       

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Diagrama de clases

• Texto entra, diagrama sale. Declare clases, campos y relaciones en pocas líneas.
• Se lee como código. +, -, # para la visibilidad, : para los tipos, () para los métodos.
• Anote con libertad. Añada notas, colores y estereotipos sin salir del texto.

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Elemento declarante

@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

Relación entre clases

@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

Etiqueta en las relaciones

@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

Sin usar letras

• Utilizar la palabra reservada as en la definición de la clase
• Colocar comillas "" alrededor del nombre de la clase

@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

Añadir métodos

@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

Definiendo la visibilidad

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

Abstracto y Estático

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Cuerpo avanzado de las clases

@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

Notas y estereotipos

@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

Más acerca de notas

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

Notas en enlaces

@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

Clases abstractas e 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

Atributos, métodos... ocultos

• empty fields o empty attributes para atributos vacíos.
• empty methods para métodos vacíos,
• fields o attributes que ocultará atributos, incluso si son descritos,
• methods que ocultará métodos, incluso si son descritos,
• members que ocultará atributos y métodos, incluso si son descritos.
• circle para el carácter encerrado en un círculo, en frente del nombre de clase.
• stereotype para el estereotipo.

• class para todas las clases,
• interface para todas las interfaces,
• enum para todos los enums,
• <<foo1>> para clases que son estereotipadas con foo1,
• un nombre de clase existente.

@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

Clases ocultas

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Remove classes

@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

Uso de clases genéricas

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Círculo enmarcador específico

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Paquetes

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Estilos de paquetes

@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

Espacios de nombre

@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

Creación automática del espacio de nombre

@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

Interface Lollipop

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

@startuml class foo bar ()- foo @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

Cambiando la dirección de las flechas

@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

Asociación de clases

@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 on same class

@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

Personalización (Skinparam)

• En la definición del diagrama, como cualquier otro comando,
• En un archivo incluido,
• En un archivo de configuración, proporcionado en la consola de comandos o en el ANT task.

@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

Estereotipos personalizados

@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

Degrado de colores

• |,
• /,
• \,
• o -

@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

Ayudar en el diseño

@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

Dividiendo archivos grandes

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

Bracketed relations (linking or arrow) style

Line style

• without label

@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

• with label

@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

Line color

@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

Line thickness

@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

Mix

@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

Change relation (linking or arrow) color and style (inline style)

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

Change class color and style (inline style)

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

Arrows from/to class members

@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

Grouping inheritance arrow heads

GroupInheritance 1 (no grouping)

@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 (grouping from 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 (grouping only from 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 (grouping only from 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

Cambiar la orientación del diagrama

• top to bottom direction (por defecto)
• left to right direction

De arriba a abajo (por defecto)

Con Graphviz (motor de diseño por defecto)

@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

Con Smetana ( motor de diseño interno)

@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

De izquierda a derecha

Con Graphviz (motor de diseño por defecto)

@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

Con Smetana (motor de diseño interno)

@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