PlantUML入门
by tot in unsplash
1. 背景
随着工作时间的增长，越发觉得用专业的图形（用例图，时序图，ER图等等）去准确表达想法是很重要的。比如针对某个需求绘制的的用例图，比一段乏味的文字来的更加有意义，也便于别人理解。加之最近在学习源码的时候，发现很多书籍中都会使用类图，时序图等UML语言来描述逻辑关系。于是就在网上找了找绘制UML语言时，业界主流的一些工具都用什么，找了半天，大部分都用了下面的工具Visio，StartUML，PlantUML。最终经过比较选择了PlantUML。
2. 选择PlatnUML原因
- PlantUML是开源的，有一个相对比较成熟的网站，通过简单的UML语言来实现想要的效果，有点极客范
- PlantUML有比较详细的各类语言的guide文档
- PlantUML做了很多的适配，比如常用的编译器eclipse，IDEA intelliJ都有对应的插件，同时还和Maven和JQuery都做了集成，还提供了war包形式，可以在本地的JavaEE容器（比如Tomcat）中运行起来
- PlantUML语言简单直接易学，就好像Markdown语法一样，简单高效
3. UML语言介绍
简而言之，UML语言是一种面向对象的模型语言，通过UML语言的组合来表达某些事物之间的逻辑关系。
详细概念请参见https://www.w3cschool.cn/uml_tutorial/uml_tutorial-c1gf28pd.html
4. PlantUML语言参考文档
- HTML版本：http://plantuml.com/zh/
- pdf版本：百度云盘链接：https://pan.baidu.com/s/1Eq68CaSmqw3vo5972macNA ，提取码：g1f2
5. PlantUML语言编写环境
目前官方网站给出了好多种的环境搭建方式，下面着重介绍四种
-
在线通过PlantUML语言绘制对应的UML图，plantUML官网提供了免费的在线编辑服务，通过在左侧输入对应的UML语言来生成对应的UML图，地址如下：online-site
1553415664042.png
-
通过本地的JavaEE容器启动plantUML.war
下载Java J2EE WAR File(plantuml.war)，将其放在本地的Tomcat的webapps目录下，启动后然后访问http://localost:8080/plantuml，就可以看到如下图所示画面，左侧编写PlantUML语言的代码，下面是效果图
plantuml.war下载地址:https://sourceforge.net/projects/plantuml/files/plantuml.war/download
tomcat-plantuml.war.png
-
使用IDEA intelliJ插件绘制
使用之前请安装PlantUML integration插件，然后就可以愉快的书写UML语言，右侧会生成对应的预览图片，可以复制或保存生成的图片到指定的目录
1553416433082.png
- 使用SpringBoot集成plantUML
pom.xml中添加如下依赖，更多关于PlantUML api的使用请参见具体的官方文档。参考资料2是一个简单的demo。
<dependency>
<groupId>net.sourceforge.plantuml</groupId>
<artifactId>plantuml</artifactId>
<version>RELEASE</version>
</dependency>
5. 下面是引用标准库生成的一个逻辑图
- PlantUML语言如下
@startuml
!include <cloudinsight/tomcat>
!include <cloudinsight/kafka>
!include <cloudinsight/java>
!include <cloudinsight/cassandra>
title Cloudinsight sprites example
skinparam monochrome true
rectangle "<$tomcat>\nwebapp" as webapp
queue "<$kafka>" as kafka
rectangle "<$java>\ndaemon" as daemon
database "<$cassandra>" as cassandra
webapp -> kafka
kafka -> daemon
daemon --> cassandra
@enduml
-
效果图
sequence.png
