最近 SpringFox 3.0.0 发布了，距离上一次大版本2.9.2足足有2年多时间了。可能看到这个名字，很多读者会有点陌生。但是，只要给大家看一下这两个依赖，你就知道了！当我们在使用Spring MVC写接口的时候，为了生成API文档，为了方便整合S

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。接口的文档在线自动生成。@ApiImplicitParam(name = "te

Swagger 是一个规范且完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。Swagger 的目标是对 REST API 定义一个标准且和语言无关的接口，可以让人和计算机拥有无须访问源码、文档或网络流量监测就可以发现和理解服

* - Predicate<String> regex:符合正则的路径。* - Predicate<RequestHandler> basePackage：返回一个断言，该断言包含所有匹配basePackage下所有类的请求路径

不管Spring Boot整合还是SpringMVC整合Swagger都基本类似，重点就在于配置Swagger，它的精髓所在就在于配置。目前互联网时代前后端分离已成趋势，前后端混在一起，前端或者后端无法做到“及时协商，尽早解决”，最终导致问题集中爆发。解决

做过Java后端开发的同学应该都用使用过Springfox和Swagger，但我相信很多同学都对这两个工具的理解和使用都有问题。这就能解释那个swagger2的后缀了，这只是Springfox对Swagger的支持。因此Springfox的开发者不推荐大家

Swagger2是一个开源项目，用于为RESTful Web服务生成REST API文档。它提供了一个用户界面，可通过Web浏览器访问RESTful Web服务。要在Spring Boot应用程序中启用Swagger2，需要在构建配置文件中添加以下依赖项。

<!swagger 的benan实例docket;

　　Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。接口的文档在线自动生成。* 构建 api文档的详细信息函数,注意这里的注解引用的是哪个

　　本章介绍SpringBoot2.1.9 集成 Swagger2 生成在线的API接口文档。Docket protocols:设置协议，Sets为com.goolge.common下的类，Sets.newHashSet相当于new HashSet(){{

swagger2是一个用于生成、并能直接调用的可是话restful风格的服务。下面贴出springboot整合swagger2代码。// 生成api的包路径。// swagger ui 页面里面的一些信息。注意：@EnableSwagger2一定要加

//最重要的就是这里，定义了/test/.*开头的rest接口都分在了test分组里，可以通过/v2/api-docs?

需要在版本中指定版本。/*@Configuration 相当于是我们的配置文件

　　Swagger2这套自动化文档工具来生成文档，它可以轻松的整合到Spring Boot中，并与Spring MVC程序配合组织出强大RESTful API文档。@ApiImplicitParam//required是否是必填属性

　　使用在Api类的接口方法上，主要属性有value、notes(注释)、hidden、httpMethod、ignoreJsonView、response、responseHeaders等等，某些属性注解可自动识别，无需配置。　　使用在Api类的接口方法

--SpringBoot使用Swagger2构建API文档的依赖-->. @Configuration//表示该类为一个配置类，相当于spring中的xml配置文件。@EnableSwagger2 //开启在线文档。//1.声明 api 文档的属性。

因为公司使用的spring版本太高，在集成swagger的时候会存在一些问题，而网上的很多实例大多都是版本比较低的，为了是朋友们少才坑，我这边将集成的过程记录一下：

根据大神博客与书轻松搭建自己的swagger文档太厉害了

Swagger可以定义一个标准的RESTful风格的API，与语言无关，是一个API的规范。这里，提到Swagger就不得不说说Springfox,Springfox是一个开源的API Doc的框架， 它的前身是swagger-springmvc，可以将我

本文主要讲解mall是如何通过整合Swagger-UI来实现一份相当完善的在线API文档的。项目使用框架介绍。Swagger-UI是HTML, Javascript, CSS的一个集合，可以动态地根据注解生成在线API文档。@ApiModelPropert