Markdown 绘制 UML 图 -- PlantUML + Gravizo
来源：http://www.plantuml.com/plantuml/uml/Iyv9B2vMS2dDpQrKgERILIWeoYnBB4bLICjCpKanv5862kINf2QNfAP0X8ouj1KAIfDoCfCXV6EkEeM2nEJinFHKXTpKaepy54CDJIHp86B6G35aeo2Y9a1Hk6aG8IEWK2q0
我们在工作中会经常使用UML图，实现UML的工具有很多，首先是绘图软件，但是所有的绘图软件有这样一个问题：这些软件绘制成的图片无法进行版本控制。也就是说如果后面你想修改软件的话，如果在软件里面的原图没有保存的话，就要重新再画了。这对于我们习惯于版本控制的码农来说显然是无法忍受的。
那么下面介绍一种可以在Markdown中使用的绘制UML工具 —— PlantUML，以及渲染引擎 Gravizo。
PlantUML简介
可以登陆PlantUML官网看一下，里面有支持的UML类型以及使用方法。
使用方法
打开在线作图网址，在上面的代码框里面输入代码。
完成后点击 Submit 按钮提交查看预览图，同时在预览图下面的 URL 地址框里面会有生成的 UML 图的 png 地址图，当然你也可以选择生成 SVG 或者 ASCII Art。把这个图片地址复制到 Markdown 就可以使用了。
比如：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
@startuml
Title "BundleLauncher类图"
interface BundleExtractor
abstract class BundleLauncher
abstract class SoBundleLauncher
abstract class AssetBundleLauncher
BundleLauncher <|-- ActivityLauncher
BundleLauncher <|-- SoBundleLauncher
SoBundleLauncher <|-- ApkBundleLauncher
BundleExtractor <|.. SoBundleLauncher
SoBundleLauncher <|-- AssetBundleLauncher
AssetBundleLauncher <|-- WebBundleLauncher
class ActivityLauncher {
+ public preloadBundle(Bundle bundle)
}
class SoBundleLauncher {
+ public preloadBundle(Bundle bundle)
}
class ApkBundleLauncher {
+ public loadBundle(Bundle bundle)
}
class AssetBundleLauncher {
+ public loadBundle(Bundle bundle)
}
@enduml
|
如果想修改怎么办？
打开在线作图网址，把图片的
url 复制到下面的 url 框里面，点击 Submit ，在上面代码框里面会出现该图片对应的代码，然后修改即可。修改完成后再次生成图片即可。
是不是相当的方便呢？
基本语法教程
- 添加标题
可以用 Title 后面加标题
|
1
2
3
|
Title "继承关系图"
Father <|-- Son
|
类图
方法和属性的访问权限
| 标识 | 属性 |
|---|---|
| - | private |
| # | protected |
| + | public |
| ~ | package private |
|
1
2
3
4
5
6
7
8
9
|
class Dummy {
- private field1
# protected field2
+ public field3
~ package method1()
- private method3()
# protected method4()
+ public method2()
}
|
关系
- 继承
|
1
|
Father <|-- Son
|
- 实现
|
1
2
3
|
abstract class AbstractList
interface List
List <|.. AbstractList
|
- 组合
关联关系的一种特例，他体现的是一种contains-a的关系，这种关系比聚合更强，也称为强聚合；他同样体现整体与部分间的关系，但此时整体与部分是不可分的，整体的生命周期结束也就意味着部分的生命周期结束。
|
1
|
Human *-- Brain
|
- 聚合
关联关系的一种特例，他体现的是整体与部分、拥有的关系，即has-a的关系，此时整体与部分之间是可分离的，他们可以具有各自的生命周期。
|
1
|
Company o-- Human
|
- 关联
类与类之间的联接。强依赖关系，表现在代码层面，为被关联类B以类属性的形式出现在关联类A中。
|
1
2
3
|
class Water
class Human
Human --> Water
|
- 依赖
类与类之间的联接。一个类A使用到了另一个类B，而这种使用关系是具有偶然性的、临时性的、非常弱的，表现在代码层面，类B作为参数被类A在某个方法中使用，例如人和烟草的关系。
|
1
|
Human ..> Cigarette
|
域
在作图时，如果遇到了名称相同包名不同的类这时就要用域来进行区分。可以用 namespace，也可以直接用包名：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
class BaseClass
namespace net.dummy #DDDDDD {
.BaseClass <|-- Person
Meeting o-- Person
.BaseClass <|- Meeting
}
namespace net.foo {
net.dummy.Person <|- Person
.BaseClass <|-- Person
net.dummy.Meeting o-- Person
}
BaseClass <|-- net.unused.Person
class net.unused.Person {
+ public void test();
}
|
PlantUML + Gravizo
上面用 PlantUML 来绘制 UML 的方法，我们需要去在线编写代码生成 UML 图片，然后再把图片地址集成到 Markdown 里面，步骤还是稍微繁琐，现在介绍 Gravizo 的使用可以解决这个问题。
Gravizo 是一个绘图引擎，只需要用 Url 包含 PlantUML 代码放到一个 img 标签中，就可以在线实时的绘制出我们需要的
UML 图。
比如下面的代码：
|
1
2
3
4
5
|
<img src='https://g.gravizo.com/svg?
abstract class AbstractList;
interface List;
List <|.. AbstractList;
'/>
|
把上面的代码放到 Markdown 里面，就可以实时的把 UML 图绘制出来了。
当然这个也需要集成的 Markdown 里面支持 Gravizo 才能显示出来，Hexo 博客是可以显示出来的，**** 博客就显示不出来。