目录

目录

一、基础用法

1.1 开始和结束

1.2 操作步骤

1.3 条件判断

1.4 并行处理

1.5 循环

1.6 分区

1.7 泳道

一、基础用法

1.1 开始和结束

开始一般使用start关键字；结束一般使用stop/end关键字。基础用法包括：

• start ... stop
• start ... end

@startuml
start
:执行操作A;
stop
@enduml

1.2 操作步骤

语法为 :operation，其中 operation 是你为该步骤定义的名称。例如：

@startuml
:开始;
:执行操作A;
:执行操作B;
:结束;
@enduml

1.3 条件判断

使用PlantUML语法通常使用if-else关键字。通常由三种语法：

• if (...) then (...) ... [else (...) ...] endif
• if (...) is (...) then ... [else (...) ...] endif
• if (...) equals (...) then ... [else (...) ...] endif

例如：

@startuml
:开始;
:执行操作A;
:判断是否满足条件;
if (满足条件) then (是)
  :执行操作B;
else (否)
  :执行操作C;
endif

if (条件) is (是) then
   :执行操作D;
else
   :执行操作E;
endif

if (条件) equals (是) then
   :执行操作F;
else
   :执行操作G;
endif
:结束;
@enduml

多分支判断使用elseif关键字，其中包含水平模式、垂直模式；

• 水平模式：

@startuml
start
if (condition A) then (yes)
  :Text 1;
elseif (condition B) then (yes)
  :Text 2;
  stop
(no) elseif (condition C) then (yes)
  :Text 3;
(no) elseif (condition D) then (yes)
  :Text 4;
else (nothing)
  :Text else;
endif
stop
@enduml

• 垂直模式：使用!pragma useVerticalIf on进入垂直模式。

​@startuml
start
!pragma useVerticalIf on
if (condition A) then (yes)
  :Text 1;
elseif (condition B) then (yes)
  :Text 2;
  stop
(no) elseif (condition C) then (yes)
  :Text 3;
(no) elseif (condition D) then (yes)
  :Text 4;
else (nothing)
  :Text else;
endif
stop
@enduml

1.4 并行处理

并行处理可以用 fork 和 join 来表示，fork 表示分支开始，merge 表示分支合并。

• fork ... fork again ... end fork
• fork ... fork again ... end merge

@startuml
start
fork
  :action 1;
fork again
  :action 2;
end fork

fork
  :action 3;
fork again
  :action 4;
end merge
stop
@enduml

1.5 循环

循环包括无条件循环（Repeat loop）、有条件循环（While loop），典型的写法包括：

• repeat ... repeat while (...) is (...) not (...)
• repeat ... backward ... repeat while (...) is (...) -> (...)
• while (...) end while

repeat案例：

@startuml
start

repeat
  :read data;
  :generate diagrams;
repeat while (more data?) is (yes) not (no)

repeat
  :read data;
  :generate diagrams;
backward :write data;
repeat while (more data?) is (yes)
-> no;
  :next action;

while (check filesize ?) is (not empty)
  :read file;
  backward:log;
endwhile (empty)
:close file;

stop
@enduml

1.6 分区

在PlantUML中，Partition 是用来定义分区的关键字，它允许你将多个活动组合在一起。

@startuml
start
partition Initialization {
    :read config file;
    :init internal variable;
}
partition Running {
    :wait for user interaction;
    :print information;
}

stop
@enduml

1.7 泳道

在PlantUML中，使用|Swimlane1|来表示泳道，例如：

@startuml
|Swimlane1|
start
:foo1;
|#AntiqueWhite|Swimlane2|
:foo2;
:foo3;
|Swimlane1|
:foo4;
|Swimlane2|
:foo5;
stop
@enduml

参考资料：New Activity Diagram Beta syntax and features