小编给大家分享一下SpringBoot整合Swagger2的示例分析，相信大部分人都还不怎么了解，因此分享这篇文章给大家参考一下，希望大家阅读完这篇文章后大有收获，下面让我们一起去了解一下吧！
springBoot作为微服务首选框架，为其他服务提供大量的接口服务。接口对接方需要实时最近的接口文档。
swagger可以通过代码和注释自动为web项目生成在线文档，这里使用swagger。
当 SpringBoot 代码中 SpringMVC 使用自动化配置类 WebMvcAutoConfiguration 时，其整合 Swagger2 的方法如下。
如果 SpringMVC 的配置过程使用了 WebMvcConfigurationSupport；则如下的整合方法不适合。
Spring Boot Web 项目整合 Swagger2 主要有两个过程：
添加 Swagger2 相关依赖。
配置 Swagger2 配置类。
首先要对 Spring Boot Web 的项目，添加 Swagger2 相关的依赖：
计算
安全
数据库
网络和加速
企业服务
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>@Configuration
@EnableSwagger2
public class Swagger {
//创建 Docket 的Bean
@Bean
public Docket docket(){
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
//select() 函数返回一个 ApiSelectorBuilder实例用来控制哪些接口暴露给 Swagger 来展现
.select()
//要扫描的包
.apis(RequestHandlerSelectors.basePackage("com.example.controller"))
//选择API路径
.paths(PathSelectors.any())
.build();
}
//创建文档的基本信息
public ApiInfo apiInfo(){
return new ApiInfoBuilder()
.title("Swagger UI 的标题")
.description("用restful风格写接口")
.termsOfServiceUrl("")
.version("1.0")
.build();
}
}写在controller类定义上方,用于说明类的作用。
@Api(value = "Swagger Test Control",
description = "演示Swagger用法的Control类",
tags = "Swagger Test Control Tag")写在REST接口上方，用于说明方法的作用。
@ApiOperation(
value="创建用户",
notes="根据User对象创建用户")@ApiImplicitParams：用在请求的方法上，包含一组参数说明
@ApiImplicitParam：对单个参数的说明
name：参数名
value：参数的汉字说明、解释
required：参数是否必须传
paramType：参数放在哪个地方
· header --> 请求参数的获取：@RequestHeader
· query --> 请求参数的获取：@RequestParam
· path（用于restful接口）--> 请求参数的获取：@PathVariable
· body（请求体）--> @RequestBody User user
· form（普通表单提交）
dataType：参数类型，默认String，其它值dataType="int"
defaultValue：参数的默认值
--------------------------------------------------------------------
@ApiImplicitParams({
@ApiImplicitParam(name = "id", value = "ID", dataType = "Long"),
@ApiImplicitParam(name = "user", value = "用户", dataType = "User")
})@ApiResponses：方法返回对象的说明
@ApiResponse：每个参数的说明
code：数字，例如400
message：信息，例如"请求参数没填好"
response：抛出异常的类
-------------------------------------------------------------------
@ApiResponses({
@ApiResponse(code = 400, message = "权限不足"),
@ApiResponse(code = 500, message = "服务器内部异常") }
)@ApiModel 用于JavaBean 上面，表示一个JavaBean。这种一般用在post创建的时候，使用 @RequestBody 这样的场景，请求参数无法使用 @ApiImplicitParam 注解进行描述的时候。
@ApiModelProperty 用对象接收参数时，描述对象的一个字段。
@ApiModel( description = "学生")
public class Student {
@ApiModelProperty(value = "主键id")
private String id;
@ApiModelProperty(value = "名称", required = true)
private String name;
@ApiModelProperty(value = "年龄", required = true)
private int age;
}@ApiIgnore ：使用该注解忽略这个API，不对这个接口生成文档。
@ApiError：发生错误返回的信息
以上是“SpringBoot整合Swagger2的示例分析”这篇文章的所有内容，感谢各位的阅读！相信大家都有了一定的了解，希望分享的内容对大家有所帮助，如果还想学习更多知识，欢迎关注亿速云行业资讯频道！
亿速云「云服务器」，即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘，价格低至29元/月。点击查看>>
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。
