一、活动图 语法小结
简单活动图
活动标签(activity label)以冒号开始,以分号结束。活动默认安装它们定义的顺序就行连接。
@startuml:Hello world;:This is on defined onseveral **lines**;@enduml
开始/结束
可以使用关键字start
和stop
表示图示的开始和结束。
@startumlstart:Hello world;:This is on defined onseveral **lines**;stop@enduml
也可以使用 end
关键字。
@startumlstart:Hello world;:This is on defined onseveral **lines**;end@enduml
条件语句
在图示中可以使用关键字if
,then
和else
设置分支测试。标注文字则放在括号中。
@startumlstartif (Graphviz installed?) then (yes) :process all\ndiagrams;else (no) :process only __sequence__ and __activity__ diagrams;endifstop@enduml
也可以使用关键字elseif
设置多个分支测试。
@startumlstartif (condition A) then (yes) :Text 1;elseif (condition B) then (yes) :Text 2; stopelseif (condition C) then (yes) :Text 3;elseif (condition D) then (yes) :Text 4;else (nothing) :Text else;endifstop@enduml
重复循环
可以使用关键字repeat
和repeatwhile
进行重复循环。
@startumlstartrepeat :read data; :generate diagrams;repeat while (more data?)stop@enduml
while循环
可以使用关键字while
和end while
进行while循环。
@startumlstartwhile (data available?) :read data; :generate diagrams;endwhilestop@enduml
还可以在关键字endwhile
后添加标注,还有一种方式是使用关键字is
。
@startumlwhile (check filesize ?) is (not empty) :read file;endwhile (empty):close file;@enduml
并行处理
可以使用关键字fork
,fork again
和end fork
表示并行处理。
@startumlstartif (multiprocessor?) then (yes) fork :Treatment 1; fork again :Treatment 2; end forkelse (monoproc) :Treatment 1; :Treatment 2;endif@enduml
注释
@startumlstart:foo1;floating note left: This is a note:foo2;note right This note is on several //lines// and can contain HTML ==== * Calling the method ""foo()"" is prohibitedend notestop@enduml
颜色
@startumlstart:starting progress;#HotPink:reading configuration filesThese files should edited at this point!;#AAAAAA:ending of the process;@enduml
箭头
使用->
标记,你可以给箭头添加文字或者修改箭头颜色。同时,你也可以选择点状 (dotted),条状(dashed),加粗或者是隐式箭头。
@startuml:foo1;-> You can put text on arrows;if (test) then -[#blue]-> :foo2; -[#green,dashed]-> The text can also be on several lines and **very** long...; :foo3;else -[#black,dotted]-> :foo4;endif-[#gray,bold]->:foo5;@enduml
连接器
可以使用括号定义连接器
@startumlstart:Some activity;(A)detach(A):Other activity;@enduml
组合
通过定义分区(partition),你可以把多个活动组合(group)在一起。
@startumlstartpartition Initialization { :read config file; :init internal variable;}partition Running { :wait for user interaction; :print information;}stop@enduml
泳道
可以使用管道符|
来定义泳道。还可以改变泳道的颜色。
@startuml|Swimlane1|start:foo1;|#AntiqueWhite|Swimlane2|:foo2;:foo3;|Swimlane1|:foo4;|Swimlane2|:foo5;stop@enduml
分离
可以使用关键字detach
移除箭头。
@startuml :start; fork :foo1; :foo2; fork again :foo3; detach endfork if (foo4) then :foo5; detach endif :foo6; detach :foo7; stop@enduml
特殊领域语言
通过修改活动标签最后的分号分隔符(;
),可以为活动设置不同的形状。
@startuml:Ready;:next(o)|:Receiving;split :nak(i)< :ack(o)>split again :ack(i)< :next(o) on several line| :i := i + 1] :ack(o)>split again :err(i)< :nak(o)>split again :foo/split again :i > 5}stopend split:finish;@enduml
二、《超市购物》系统
系统中的活动主体:顾客、收银员、收款机;设置三个活动分区
- 顾客进入超市后,选择自己要购买的商品,并把商品拿到收银台给收银员。
- 收银员询问顾客是否是会员。如果是,向顾客索要会员卡,把会员卡扫描进系统并对会员进行认证。
- 然后逐一扫描顾客的商品条形码,收款机接受商品条形码,并累加商品金额。
- 扫描完后,收银员根据收款机上的金额收款,然后通过收款机打印售货单。
- 收银员把售货单和商品给顾客,购物过程结束。
@startuml|顾客|start :选择商品; :商品交给收银员;|#AntiqueWhite|收银员|floating note left: 是否是会员 if() then ([会员]) :扫描会员卡;|收款机|floating note left: 是否有效 if () then ([无效]) :提示会员卡无效; else ([有效]) :提示会员卡有效; :累计积分; endif|收银员| :扫描商品条码; else ([非会员])|收银员| :扫描商品条码; endif|收款机| :接收商品条码; :统计商品金额;|收银员| while(还有商品否?) is ([有]) :扫描商品条码; endwhile ([无])|顾客| :交付货款;|收银员| :接受货款;|收款机| :打印售货单;|收银员| :货单及货品交给顾客;|顾客| :接受货单及货品; stop@enduml