本文主要介绍springboot整合swagger的全过程，从开始的swagger到Knife4j的进阶之路；Knife4j是swagger-bootstarp-ui的升级版，包括一些增强功能，关于Knife4j下篇文章中着重介绍
swagger特点：
Api框架
restful Api文档在线自动生成工具
可以直接运行，在线测试api接口
支持多种语言：java、php...
2. 实战步骤(1) 搭建springboot项目
springboot搭建项目就不介绍了，如果需要springboot整合swagger源码的，可以去我的仓库查看下载：点击跳转
(2) 添加依赖
<!-- swagger2 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> </dependency> <!-- swagger-ui，原生swagger-Ui界面，访问后缀（默认的）：swagger-ui.html--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> </dependency> <!-- bootstrap-ui,只是在改变页面效果，访问后缀：doc.html --> <dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>swagger-bootstrap-ui</artifactId> <version>1.9.2</version> </dependency>springfox-swagger-ui和swagger-bootstrap-ui都是纯swagger-ui的ui皮肤项目，渲染页面的，作用是一样的，只是swagger-bootstarp-ui在原来的基础上做了页面优化，页面更符合中国人的阅读习惯；
其实两种都不介意使用，因为springfox-swagger-ui原生的比较丑，功能也不齐全（不能导出，不能搜索...），swagger-bootstrap-ui已经停更了，最终版本是1.9.6；所有推荐使用使用最新的Knife4j，下边文章中着重介绍！！！
两种UI页面比较
(3) 注解标注
导入依赖之后，只要再启动类上开启注解@EnableSwagger2即可，就可以访问UI页面了；如果有自定义的配置类，可以标注到配置类上。
UI页面可以访问，但是需要使用其他注解来标注类，方法，参数，才可以看到接口等信息，注解后边一一罗列！！！
页面中有好多初始化的设置，如果需要修改为自己的，就需要添加配置类，就是第四步编写配置
(4) 编写配置
package com.ruyidan.swagger.config; import java.util.ArrayList; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.core.env.Environment; import org.springframework.core.env.Profiles; import springfox.documentation.builders.PathSelectors; import springfox.documentation.builders.RequestHandlerSelectors; import springfox.documentation.service.ApiInfo; import springfox.documentation.service.Contact; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2; /** * @ClassName: SwaggerConfig * @Description: * @Author: dangbo * @Date: 2021/3/25 14:13 * @Version */ @Configuration @EnableSwagger2 public class SwaggerConfig { @Autowired private Environment environment; @Bean public Docket docket() { // 设置显示的swagger环境信息 Profiles profiles = Profiles.of("dev", "test"); // 判断是否处在自己设定的环境当中 boolean flag = environment.acceptsProfiles(profiles); return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .groupName("分组名称") // 配置api文档的分组 .enable(flag) // 配置是否开启swagger .select() .apis(RequestHandlerSelectors.basePackage("com.ruyidan.swagger.controller")) //配置扫描路径 .paths(PathSelectors.any()) // 配置过滤哪些 .build(); } // api基本信息 private ApiInfo apiInfo() { return new ApiInfo("dxiaodang's swagger", "测试swagger-ui", "v1.0", "http://mail.qq.com", new Contact("dangbo", "http://mail.qq.com", "145xxxxx@qq.com"), //作者信息 "Apache 2.0", "http://www.apache.org/licenses/LICENSE-2.0", new ArrayList()); } }✌️ 注意点： ✌️
如果只需要在dev和test环境开启swagger，就使用springboot的Environment实例来判断当前配置文件时使用的哪种；
如果需要配置多个分组，就要创建多个docket实例；
如果页面无法正常访问， 请看是否配置拦截器了，是不是因为拦截器拦截了请求
(5) 启动服务验证
略...
实体类： ApiModel、实体属性：ModelProperty
Controller类:Api
接口方法的说明：ApiOperation
方法参数的说明：@ApiImplicitParams、@ApiImplicitParam
方法返回值的说明：@ApiResponses @ApiResponse
ParamType和dataType区别
ParamType：表示参数放在哪个位置
header-->请求参数的获取：@RequestHeader(代码中接收注解)
query-->请求参数的获取：@RequestParam(代码中接收注解)
path（用于restful接口）-->请求参数的获取：@PathVariable(代码中接收注解)
body-->请求参数的获取：@RequestBody(代码中接收注解)
form（不常用）
dataType：参数类型，可传基本类型、类、泛型类等
4. 常见问题汇总