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
-
通过本地的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
-
使用IDEA intelliJ插件绘制
使用之前请安装PlantUML integration插件,然后就可以愉快的书写UML语言,右侧会生成对应的预览图片,可以复制或保存生成的图片到指定的目录
- 使用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
-
效果图