PlantUML 1.2021.3 언어참조가이드

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

摘要

文档介绍了PlantUML语言的使用方法，包括断言（assert）功能、如何构建和使用自定义库、变量定义规则以及内置的标准库列表。文档还展示了如何通过预处理指令（如!include、!function）进行代码处理，并提供了多种图表绘制示例，涵盖网络图、活动图、状态图等。

AI总结

《PlantUML 1.2021.3 语言参考指南》总结：

1. **断言功能**：
- 可以在图表中添加断言（assertions），用于验证条件。
- 示例：`!assert %strpos("abcdef", "cd") == 3 : "This always fails"`，若条件不满足会触发断言错误。

2. **自定义库构建**：
- 使用 `!import` 和 `!include` 指令将多个文件打包为 `.zip` 或 `.jar`，并导入到图表中使用。
- 示例：`!import /path/to/customLibrary.zip`，然后 `!include` 其中的文件。

3. **网络定义中的节点分组**：
- 支持在 `nwdiag` 中定义组，便于管理网络拓扑结构。
- 示例：定义 `web` 组和 `db` 组，分别包含多个节点。

4. **变量定义**：
- 变量名建议以 `$` 开头，支持整数和字符串类型。
- 全局变量可直接访问，函数内变量需显式定义。
- 示例：`!$ab = "foo1"`，并在图表中使用变量值。

5. **预处理功能**：
- 类似 C 预处理器，使用 `!` 替代 `#`。
- 迁移注意事项：不再支持 `!define` 和 `!definelong`，建议使用 `!function` 和 `!procedure`。
- 示例：`!define` 替换为 `return !function`。

6. **标准库**：
- 内置多个第三方库，如 AWS、Azure、Kubernetes 等，提供丰富的图标和组件。
- 使用 `!include` 引入库文件，如 `!include `。

7. **图表示例**：
- 展示了如何结合标准库绘制复杂的图表，如 AWS 架构图和 Azure 事件流图。
- 示例：使用 `AzureEventHub` 和 `DynamoDB` 组件构建数据流图。

总结：文档详细介绍了 PlantUML 的高级功能，包括断言、变量、预处理、自定义库和标准库的使用，帮助用户更高效地创建复杂和动态的图表。