PlantUML 1.2021.1 Справочное руководство по языку

• 语言: 俄语
• 格式: .pdf
• 来源: pdf.plantuml.net

摘要

PlantUML是一个开源项目，用于快速创建各种类型的UML图和其他非UML图。文档详细介绍了PlantUML的语言语法、预处理功能、变量定义、自定义库的构建以及标准库的使用。PlantUML支持包括类图、序列图、活动图、组件图、部署图、状态图、同步图等UML图，以及JSON数据图、网络图、界面图、ArchiMate图、SDL图、Ditaa图、甘特图、心智图、工作分解结构图和数学公式图等非UML图。

AI总结

### PlantUML 1.2021.1 功能与语法概览

**PlantUML** 是一个开源项目，支持通过简单直观的文本语法快速生成多种类型的UML图和其他图形。以下是其主要功能和关键特性：

---

#### 1. **支持的图类型**
PlantUML 支持以下 UML 图和非 UML 图：
- **UML 图**：
- 序列图
- 类图
- 对象图
- 活动图
- 组件图
- 部署图
- 状态图
- 同步图
- **非 UML 图**：
- JSON Data
- 网络图 (nwd)
- 界面原型图
- Archimate 图
- SDL 图
- Ditaa 图
- 甘特图
- 思维导图
- 工作分解结构图
- 数学公式（支持 AsciiMath 或 JLaTeXMath）
- 实体关系图

---

#### 2. **语法特点**
- 使用简单直观的文本语法创建图表。
- 支持嵌入代码片段进行动态内容生成。
- 示例：

  @startuml
  Alice -> Bob: Hello
  @enduml

---

#### 3. **断言功能**
- 可在图表中添加断言（assertions），用于验证条件。
- 示例：

  @startuml
  Alice -> Bob: Hello
  !assert %strpos("abcdef", "cd") == 3 : "This always fails"
  @enduml

---

#### 4. **预处理指令**
- 类似 C 预处理语言，使用 `!` 符号表示指令。
- 支持的功能包括：
- 变量定义（支持整数和字符串）。
- 函数定义（`!function` 和 `!procedure`）。
- 文件包含（`!include` 和 `!import`）。
- 示例：

  @startuml
  !$ab = "foo1"
  !$cd = "foo2"
  !$ef = $ab + $cd
  Alice -> Bob: $ab
  Alice -> Bob: $cd
  Alice -> Bob: $ef
  @enduml

---

#### 5. **标准库**
PlantUML 提供了丰富的标准库（stdlib），包含多种图标和宏，便于在图表中使用常见技术和组件。例如：
- **AWS 库**：支持 AWS 服务图标。
- **Azure 库**：支持 Azure 服务图标。
- **C4 模型**：支持架构设计图。
- **Cloud Insight**：支持常见技术的图标。

示例：

@startuml
!include 
!include 
!include 
!include 
!include 
!include 

left to right direction
Users(sources, "Events", "millions of users")
APIGateway(votingAPI, "Voting API", "user votes")
...
@enduml

---

#### 6. **其他特性**
- 支持多种字符集（UTF-8、UTF-16 等）。
- 提供皮肤参数（skinparam）用于自定义图表样式。
- 支持通过命令行工具（`plantuml.jar`）生成图表。

---

**总结**
PlantUML 是一个功能强大且灵活的工具，适用于多种类型的图表绘制，尤其适合需要动态内容和复杂逻辑的场景。其语法简洁，支持丰富的标准库和预处理功能，能够满足开发人员和架构师的多样化需求。