Spring boot配置 swagger的示例代码

Spring boot配置 swagger的示例代码

为什么使用Swagger

在实际开发中我们作为后端总是给前端或者其他系统提供接口，每次写完代码之后不可避免的都需要去写接口文档，首先写接口文档是一件繁琐的事，其次由接口到接口文档需要对字段、甚至是排版等。再加上如果我们是为多个系统提供接口时可能还需要按照不同系统的要求去书写文档，那么有没有一种方式让我们在开发阶段就给前端提供好接口文档，甚至我们可以把生成好的接口文档暴露出去供其他系统调用，那么这样我只需要一份代码即可。

Spring boot配置 swagger

1.导入maven依赖

io.springfox

springfox-swagger2

2.6.1

io.springfox

springfox-swagger-ui

2.6.1

com.github.xiaoymin

swagger-bootstrap-ui

1.9.6

2.swagger配置类

@EnableSwagger2 // Swagger的开关，表示已经启用Swagger

@Configuration // 声明当前配置类

public class SwaggerConfiguration {

@Value("${swagger.basePackage}")

private String basePackage; // controller接口所在的包

@Value("${swagger.title}")

private String title; // 当前文档的标题

@Value("${swagger.description}")

private String description; // 当前文档的详细描述

@Value("${swagger.version}")

private String version; // 当前文档的版本

@Bean

public Docket createRestApi() {

return new Docket(DocumentationType.SWAGGER_2)

.apiInfo(apiInfo())

.select()

.apis(RequestHandlerSelectors.basePackage(basePackage))

.paths(PathSelectors.any())

.build();

}

private ApiInfo apiInfo() {

return new ApiInfoBuilder()

.title(title)

.description(description)

.version(version)

.build();

}

}

3.application.yml

# 配置swagger

swagger:

http:// basePackage: com.xx.demo.controller #包名

title: 标题 #标题

description: 项目文档 #描述

version: V1.0 #版本号

4.在controller里使用

@Api(tags = {"测试类"})

@RestController

@RequestMapping("/test")

public class TestController {

@ApiOperation(value = "测试方法")

@GetMapping("/xrx")

public String xrx() {

return "hello";

}

}

5.访问swagger

http://localhost:8080/swagger-ui.html

http://localhost:8080/doc.html

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。