为什么使用Swagger
在实际开发中我们作为后端总是给前端或者其他系统提供接口，每次写完代码之后不可避免的都需要去写接口文档，首先写接口文档是一件繁琐的事，其次由接口到接口文档需要对字段、甚至是排版等。再加上如果我们是为多个系统提供接口时可能还需要按照不同系统的要求去书写文档，那么有没有一种方式让我们在开发阶段就给前端提供好接口文档，甚至我们可以把生成好的接口文档暴露出去供其他系统调用，那么这样我只需要一份代码即可。
Spring boot配置 swagger
1.导入maven依赖
<!--配置swagger-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfo<em>本文来源gao.dai.ma.com搞@代*码(网$</em>x-swagger2</artifactId>
<version>2.6.1</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.6.1</version>
</dependency>
<!--swagger第三方ui-->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.6</version>
</dependency>
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: 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
到此这篇关于Spring boot配置 swagger的示例代码的文章就介绍到这了,更多相关Spring boot配置 swagger内容请搜索搞代码以前的文章或继续浏览下面的相关文章希望大家以后多多支持搞代码！
搞代码网（gaodaima.com）提供的所有资源部分来自互联网，如果有侵犯您的版权或其他权益，请说明详细缘由并提供版权或权益证明然后发送到邮箱[email protected]，我们会在看到邮件的第一时间内为您处理，或直接联系QQ：872152909。本网站采用BY-NC-SA协议进行授权
转载请注明原文链接：Spring boot配置 swagger的示例代码
转载请注明原文链接：Spring boot配置 swagger的示例代码
