简介

标题不让写那么长,嗨嗨,原文主题应该为 spring Boot系列之四 使用Swagger2构建RESTful API文档

不知道会不会影响阅读量... 推荐越来越少了...

本来系列4和系列5的文章不打算发了的,一方面是应用机会很少,另一方面也是自己当时用的时候对Spring Boot的了解还不够透彻,有点小错误.不过有粉丝评论说直接从3到了6,中间少了两篇,不成系列了,哈哈哈.那我就把错误改改,再发出来吧.感谢粉丝~~.

正文:

可能大家受够了拿个Word写API文档了,现在Swagger2可以让大家节省很多劳动力,而且展示出来的文档,风格统一,功能强大.

但是!但是!!Swagger2毕竟是得等代码写好了,最起码也得等各个接口创建好了把相应的注解整理完整后文档才会生成.所以… 有些时候,你并不能逃避Word.

当然,当然.反过来讲,对于没有文档的老代码,我们只需要增加相应的Swagger2注解就能生成一份很好看的文档咯.

废话不多说.

实例

在pom.xml文件中引入

UTF-8

UTF-8

1.8

2.6.0

io.springfox

springfox-swagger2

${springfox-swagger2.version}

io.springfox

springfox-swagger-ui

${springfox-swagger2.version}

创建package

在`src/main/Java`目录下创建一个package`swagger2`

创建Swagger2配置类

basePackage说明

swag