PlantUML Language specification Component Diagram

       

Edit in DokuwikiEdit in AsciidocEdit in Markdown

组件图

• 简单：使用 PlantUML，您可以使用简单直观的文本描述来创建组件图，无需使用复杂的绘图工具。
• 集成：PlantUML 可* 与各种工具和平台无缝集成，是开发人员和建筑师的多功能选择。
• 协作：PlantUML 论坛为用户提供了一个讨论、分享和寻求图表帮助的平台，从而培养了一个协作社区。

Edit in DokuwikiEdit in AsciidocEdit in Markdown

组件

@startuml [First component] [Another component] as Comp2 component Comp3 component [Last\ncomponent] as Comp4 @enduml

命名例外

@startuml component [$C1] component [$C2] $C2 component [$C2] as dollarC2 remove $C1 remove $C2 remove dollarC2 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

接口

@startuml () "First Interface" () "Another interface" as Interf2 interface Interf3 interface "Last\ninterface" as Interf4 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

基础示例

@startuml DataAccess - [First Component] [First Component] ..> HTTP : use @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

使用注释

@startuml interface "Data Access" as DA DA - [First Component] [First Component] ..> HTTP : use note left of HTTP : Web Service only note right of [First Component] A note can also be on several lines end note @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

组合组件

• package
• node
• folder
• frame
• cloud
• database

@startuml package "Some Group" { HTTP - [First Component] [Another Component] } node "Other Groups" { FTP - [Second Component] [First Component] --> FTP } cloud { [Example 1] } database "MySql" { folder "This is my folder" { [Folder 3] } frame "Foo" { [Frame 4] } } [Another Component] --> [Example 1] [Example 1] --> [Folder 3] [Folder 3] --> [Frame 4] @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

改变箭头方向

@startuml [Component] --> Interface1 [Component] -> Interface2 @enduml

@startuml Interface1 <-- [Component] Interface2 <- [Component] @enduml

@startuml [Component] -left-> left [Component] -right-> right [Component] -up-> up [Component] -down-> down @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

使用 UML2 标记

@startuml interface "Data Access" as DA DA - [First Component] [First Component] ..> HTTP : use @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

使用UML1标记符

@startuml skinparam componentStyle uml1 interface "Data Access" as DA DA - [First Component] [First Component] ..> HTTP : use @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

使用矩形符号（去除 UML 符号）

@startuml skinparam componentStyle rectangle interface "Data Access" as DA DA - [First Component] [First Component] ..> HTTP : use @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

长描述

@startuml component comp1 [ This component has a long comment on several lines ] @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

不同的颜色表示

@startuml component [Web Server] #Yellow @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

在定型组件中使用精灵图

@startuml sprite $businessProcess [16x16/16] { FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFF0FFFFF FFFFFFFFFF00FFFF FF00000000000FFF FF000000000000FF FF00000000000FFF FFFFFFFFFF00FFFF FFFFFFFFFF0FFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFF } rectangle " End to End\nbusiness process" <<$businessProcess>> { rectangle "inner process 1" <<$businessProcess>> as src rectangle "inner process 2" <<$businessProcess>> as tgt src -> tgt } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

显示参数

• 在图表的定义中；
• 在引用的文件中；
• 在命令行或者Ant 任务提供的配置文件中。

@startuml skinparam interface { backgroundColor RosyBrown borderColor orange } skinparam component { FontSize 13 BackgroundColor<<Apache>> Pink BorderColor<<Apache>> #FF6655 FontName Courier BorderColor black BackgroundColor gold ArrowFontName Impact ArrowColor #FF6655 ArrowFontColor #777777 } () "Data Access" as DA Component "Web Server" as WS << Apache >> DA - [First Component] [First Component] ..> () HTTP : use HTTP - WS @enduml

@startuml skinparam component { backgroundColor<<static_lib>> DarkKhaki backgroundColor<<shared_lib>> Green } skinparam node { borderColor Green backgroundColor Yellow backgroundColor<<shared_node>> Magenta } skinparam databaseBackgroundColor Aqua [AA] <<static_lib>> [BB] <<shared_lib>> [CC] <<static_lib>> node node1 node node2 <<shared node>> database Production @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

特定皮肤参数

组件样式

• 默认情况下（或使用skinparam componentStyle uml2 ），组件有一个图标。

@startuml skinparam BackgroundColor transparent skinparam componentStyle uml2 component A { component "A.1" { } component A.44 { [A4.1] } component "A.2" [A.3] component A.5 [ A.5] component A.6 [ ] } [a]->[b] @enduml

• 如果您想取消它，只使用矩形图标，可以使用skinparam componentStyle rectangle

@startuml skinparam BackgroundColor transparent skinparam componentStyle rectangle component A { component "A.1" { } component A.44 { [A4.1] } component "A.2" [A.3] component A.5 [ A.5] component A.6 [ ] } [a]->[b] @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

隐藏或删除未链接的组件

@startuml component C1 component C2 component C3 C1 -- C2 @enduml

• hide @unlinked 组件：

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

• 或remove @unlinked 组件：

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

Edit in DokuwikiEdit in AsciidocEdit in Markdown

隐藏、删除或恢复被标记的组件或通配符

@startuml component C1 $tag13 component C2 component C3 $tag13 C1 -- C2 @enduml

• hide $tag13 以隐藏组件组件:

@startuml component C1 $tag13 component C2 component C3 $tag13 C1 -- C2 hide $tag13 @enduml

• 或者 remove $tag13 以移除组件:

@startuml component C1 $tag13 component C2 component C3 $tag13 C1 -- C2 remove $tag13 @enduml

• 或者 remove $tag13 and restore $tag1 以移除一个标记下的组件并还原另一个标记下的组件:

@startuml component C1 $tag13 $tag1 component C2 component C3 $tag13 C1 -- C2 remove $tag13 restore $tag1 @enduml

• 或者 remove * and restore $tag1 以移除全部组件并且还原一个被标记的组件:

@startuml component C1 $tag13 $tag1 component C2 component C3 $tag13 C1 -- C2 remove * restore $tag1 @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

在组件图上显示JSON数据

简单的例子

@startuml allowmixing component Component () Interface json JSON { "fruit":"Apple", "size":"Large", "color": ["Red", "Green"] } @enduml

Edit in DokuwikiEdit in AsciidocEdit in Markdown

端口 [port, portIn, portOut]

端口

@startuml [c] component C { port p1 port p2 port p3 component c1 } c --> p1 c --> p2 c --> p3 p1 --> c1 p2 --> c1 @enduml

端口输入

@startuml [c] component C { portin p1 portin p2 portin p3 component c1 } c --> p1 c --> p2 c --> p3 p1 --> c1 p2 --> c1 @enduml

端口输出

@startuml component C { portout p1 portout p2 portout p3 component c1 } [o] p1 --> o p2 --> o p3 --> o c1 --> p1 @enduml

混合使用 PortIn 和 PortOut

@startuml [i] component C { portin p1 portin p2 portin p3 portout po1 portout po2 portout po3 component c1 } [o] i --> p1 i --> p2 i --> p3 p1 --> c1 p2 --> c1 po1 --> o po2 --> o po3 --> o c1 --> po1 @enduml