fulei
5/22/2017 - 1:57 PM

Swagger的常见玩法

Swagger的常见玩法

1、采取spring-fox整合Swagger到我们的项目中来,这样的方式的缺点是我们的代码将变得比较冗余,但是同样的优点也十分的明显:那就是文档再也不需要我们手动的去维护了。 我们只需要去更新代码文档自然而然的就跟着去更新了。

2、Swagger采用的定义接口的方式有两种,一种是采取yaml语言,其实说是语言,和xml、json那种格式化的标签几乎差不多的。也很好学。 当然第二种的话就是采用json了,这种的话实际上已经很常见了。

3、Swagger还比较好玩的一点就是可以根据文档去生成代码甚至于说整个项目,这样做的好处是契约先行,大家先约定好,这样开发起来的效率我想会增加不少。