1、使用的swagger 版本
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.github.xiaoymin/swagger-bootstrap-ui -->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.6</version>
</dependency
2、swagger配置
@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUI
public class Swagger2 {
@Bean
public Docket createRestApi() {
...
}
private ApiInfo apiInfo() {
...
}
}
3、关键一点swagger注解的使用
@ApiSort(value = 5):给接口排序
@ApiOperationSupport(order = 1):给接口里面的方法排序,如下:
@RestController
@RequestMapping(value = "/api/message")
@Api(tags = "接口-短信")
@ApiSort(value = 5)
@ApiIgnore()
public class MessageController {
@RequestMapping(value = "/ct", method = {RequestMethod.GET}, produces = {"application/json"})
@ApiOperation(value = "短信总数", notes = "获取短信总数")
@ApiOperationSupport(order = 1)
public Result CT() {
...
}
4、最后也很重要,一定要开启增强功能,然后刷新页面就可以了
5、不想接口在页面上显示可以使用注解
@ApiIgnore()