提示6-9:使用文本符号来描述运行时场景!

提示6-9:使用文本符号来描述运行时场景!

#runtime-view #scenario #lean

我们对开发团队的建议:使用PlantUML描述或指定运行时场景。它有一个用于序
列和活动图的轻量文本语法(DSL)-易于理解,是讨论和可视化活动和过程的精益选项。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

@startuml
skinparam componentStyle uml2

actor Admin
participant "Import\nHandler" as IH
participant "ftp-in" as ftp
participant "Optical\nArchive" as OA
participant "Data\nManagement" as DM
participant "Error\nHandler" as EH

Admin -> IH: import( m )
IH -> Configuration: getMandatorCfg
IH -> ftp: readFile
ftp --> IH: file
IH -> OA : storeFile(file)
IH -> IH: setupFilterChain
IH -> IH: unzip(file)
IH -> IH: decrypt(uzFile)

alt parse file
loop all records
IH -> IH: parse record
IH -> DM : store client
else record error
IH -> EH: log record error
end
else file error
IH -> EH: log file error
end

@enduml

此文本描述中的(渲染)图表如下所示:

1705144232117

文本对开发人员来说更容易

这种文本描述(场景的DSL)类似于源代码-开发人员通常很容易创建和维护。

他们可以:

  • 使用此DSL绘制和讨论场景的变体
  • 使用已建立的分支和合并选项,在常见版本工具(git、subversion等)中维护文本表示
  • 如果此类场景(后来……)在源代码中实现,图表可能会被删除,这将导致更精简的文档(见提示6-5(讨论场景,而不是文档))。