开发人员可以通过对比,选择比较喜欢的方式。个人是比较喜欢第二种,简洁易懂
1.早期常用的方式:
引用方式:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
</dependency>
注解使用:@Api/@ApiOperation
请求调用:port/swagger-ui.html
效果图:
2.最新好用的方式:从展示上更加人性化,通过文档结构图的方式更清晰易懂
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.8.1</version>
</dependency>
请求调用:port/doc.html
效果展示: