使用 PlantUML 绘制 UML - PlantUML 语言参考指引(Version 1.2019.1)

• 语言: 中文（简体）
• 格式: .pdf
• 来源: pdf.plantuml.net

摘要

文档系统阐述了 PlantUML 的使用方法及其支持的图表类型。PlantUML 是一个开源工具，支持绘制多种 UML 图表，包括时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图和定时图等。此外，PlantUML 还支持非 UML 图表，如线框图形界面、架构图、规范和描述语言 (SDL)、Ditaa 图、甘特图以及 AsciiMath 或 JLaTeXMath 符号的数学公式。文档详细介绍了各类图表的绘制语法和示例，包括时序图的消息传递、活动图的新语法、类图的关系定义、组件图的样式设置以及数学公式的插入方法。

AI总结

《使用 PlantUML 绘制 UML - PlantUML 语言参考指引(Version 1.2019.1)》摘要如下：

### 1. **概述**
PlantUML 是一个开源项目，支持通过简单的文本语言快速绘制多种类型的图表，包括：
- UML 图表：时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图、定时图
- 非 UML 图表：线框图形界面、架构图、规范和描述语言 (SDL)、Ditaa 图、甘特图、数学公式（支持 AsciiMath 和 JLaTeXMath）

### 2. **时序图**
- 使用 `->` 表示消息传递，`-->` 表示虚线箭头，`<-` 和 `<--` 表示反向消息传递。
- 通过 `participant` 关键字声明参与者，支持的角色类型包括：`actor`、`boundary`、`control`、`entity`、`database`。
- 示例：

  @startuml
  Alice -> Bob: Authentication Request
  Bob --> Alice: Authentication Response
  @enduml

### 3. **活动图**
- 新语法（从 V7947 开始）取代旧语法，且不依赖 Graphviz。旧语法仍兼容。
- 活动标签以冒号开始，以分号结束，支持 Creole wiki 语法。
- 使用 `start` 和 `stop`（或 `end`）表示图示的开始和结束。
- 示例：

  @startuml
  start
  :Hello world;
  stop
  @enduml

### 4. **组件图**
- 使用 `skinparam componentStyle uml2` 切换到 UML2 标记符。
- 支持长描述、颜色声明和在组件中使用 Sprite。
- 示例：

  @startuml
  skinparam componentStyle uml2
  component "Data Access" as DA
  DA - [First Component]
  @enduml

### 5. **类图**
- 类之间的关系通过符号定义：
- 组合：<|--
- 聚合：*--
- 关联：o--
- 支持点线（`..`）、箭头 direction（如 `^--`、`|--`、`}--`）等。
- 示例：

  @startuml
  Class01 <|-- Class02
  Class03 *-- Class04
  @enduml

### 6. **数学公式**
- 支持通过 `` 和 `` 插入 AsciiMath 和 JLaTeXMath 公式。
- 示例：

  @startuml
  Bob -> Alice : ax^2+bx+c=0
  Alice --> Bob: x = (-b+-sqrt(b^2-4ac))/(2a)
  @enduml

### 7. **其他图表**
- **甘特图**：支持通过 `@startgantt` 和 `@endgantt` 创建。
- **表格**：通过 `skinparam titleFontSize` 和 `|=|` 创建表格，支持背景颜色。
- **Creole 语法**：支持在图表中插入表格、注释等。

### 8. **实现依赖**
- 数学公式依赖于 AsciiMath 和 JLaTeXMath，需手动下载相关库。
- 部分功能依赖 Graphviz，需注意使用规范。

总结：PlantUML 是一款功能强大的工具，支持通过简单的文本语言快速创建多种类型的图表，适合用于软件设计、系统分析和文档编写。