一、前言

让我们先理一下springfox与swagger的关系。

swagger是一个流行的API开发框架，这个框架以“开放API声明”（OpenAPI Specification，OAS）为基础，对整个API的开发周期都提供了相应的解决方案，是一个非常庞大的项目（包括设计、编码和测试，几乎支持所有语言）。

OAS本身是一个API规范，它用于描述一整套API接口，包括一个接口是GET还是POST请求啊，有哪些参数哪些header啊，都会被包括在这个文件中。它在设计的时候通常是YAML格式，这种格式书写起来比较方便，而在网络中传输时又会以json形式居多，因为json的通用性比较强。

由于Spring的流行，Marty Pitt编写了一个基于Spring的组件swagger-springmvc，用于将swagger集成到springmvc中来。而springfox则是从这个组件发展而来，同时springfox也是一个新的项目，本文仍然是使用其中的一个组件springfox-swagger2。

pringfox-swagger2依然是依赖OSA规范文档，也就是一个描述API的json文件，而这个组件的功能就是帮助我们自动生成这个json文件，我们会用到的另外一个组件springfox-swagger-ui就是将这个json文件解析出来，用一种更友好的方式呈现出来。

这是入门，我们简单地介绍springfox-swagger2的配置，帮助各位顺利地实现使用，文中有很多自己的理解，若有错误，欢迎批评指正。

二、配置流程说明

在开始编码之前，我们先对配置的流程有个大致的了解。

在前言中，我们知道，我们的第一个任务就是生成一个满足OSA规范的json文件（当然，创建一个spring的项目就不说了）。对于这个任务，springfox为我们提供了一个Docket（摘要的意思）类，我们需要把它做成一个Bean注入到spring中，显然，我们需要一个配置文件，并通过一种方式（显然它会是一个注解）告诉程序，这是一个Swagger配置文件。

一个OSA规范文档需要许多信息来描述这个API，springfox允许我们将信息组合成一个ApiInfo的类，作为构造参数传给Docket（当然也可以不构造这个类，而直接使用null，但是你的这个API就太low了）。

接下来，我们要写控制器了，当然这不重要，不用springfox你依然要写控制器，重要的是要告诉springfox，这个控制器是一个需要他来收集API信息的控制器，不用说，这依然会采用注解的方式，同时，我们为了将配置文件与控制器结合起来，需要在配置文件中指明在什么位置收集可能是API的控制器的信息。

到这里，生成OSA规范的json文件的配置就结束了。虽然生成过程比我叙述的更复杂，但这些程序都会帮我们完成，我们可以通过类似http://localhost:8080/demo/v2/api-docs的路径来查看这个json文件。这个v2/api-docs就是springfox默认的生成文档的路径。

接下来，我们需要将它可视化显示出来，如果使用swagger-springmvc，我们需要单独去下载一个swagger ui的显示页面包，并将其中的路径改为上面的http://localhost:8080/demo/v2/api-docs，这里你就可以感受到，swagger ui就是在解析一个json文件了。你依然可以这么做，不过springfox专门提供了一个springfox-swagger-ui组件，不需要配置，我们只需要引入这个依赖的组件就可以看到最终的效果了，而这个路由会是http://localhost:8080/demo/swagger-ui.html。

三、引入依赖

如果我写的不错，相信看到这里，你就大致了解了springfox swagger2的使用流程了。那么，我们进入正式编码的第一步：引入依赖。

这里我们使用maven引入依赖，大家可以到http://mvnrepository.com上搜索springfox，便可以看到Springfox Swagger2和Springfox Swagger Ui，然后就可以从中获取最新的资源了。如下：

<dependency>

 <groupId>io.springfox</groupId>

 <artifactId>springfox-swagger2</artifactId>

 <version>2.7.0</version>

</dependency>

<dependency>

 <groupId>io.springfox</groupId>

 <artifactId>springfox-swagger-ui</artifactId>

 <version>2.7.0</version>

</dependency>

此外还需要一个依赖组件：

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-databind</artifactId>
  <version>2.6.6</version>
</dependency>
 

四、一个简单的配置文件

为了清晰，我们可以先在常用的源码包里建一个config目录，并在里面创建一个SwaggerConfig.java文件，这是一个spring的配置文件，所以位置和文件名都影响不大。

先上代码：

@Configuration //必须存在
@EnableSwagger2 //必须存在
@EnableWebMvc //必须存在
@ComponentScan(basePackages = {"com.xiaoming.SpringMVC.controller"}) //必须存在 扫描的API Controller package name 也可以直接扫描class (basePackageClasses)
public class SwaggerConfig{
 @Bean
 public Docket customDocket() {
  return new Docket(DocumentationType.SWAGGER_2)
    .apiInfo(apiInfo());
 }

 private ApiInfo apiInfo() {
  Contact contact = new Contact("小明", "https://www./", "zhaomin0018@126.com");
  return new ApiInfoBuilder()
    .title("前台API接口")
    .description("前台API接口")
    .contact(contact)
    .version("1.1.0")
    .build();
 }
}

由于各位肯定用的是IDE，这里就不写各种import了。

首先，这个SwaggerConfig类有四个注解，看名称就可以明白是什么意思。其中，@Configuration，@EnableWebMvc和@ComponentScan是Spring的注解，而@EnableSwagger2则是用来启动Swagger支持，表示这是一个Spring Swagger的配置文件。

之后，定义了一个Bean方法CustomDocket，Spring中名字并不重要，重要的是它返回一个Docket类，DocumentationType.SWAGGER_2作为Docket构造方法的参数，指定了所用的swagger版本2.0，官网上已经在预告3.0版本了。而之后的apiInfo则是调用接下来的apiInfo函数，来创建Docket的信息。apiInfo函数采用ApiInfoBuilder来创建ApiInfo类。

五、一个控制器

其实，控制器不需要配置，就已经会被springfox swagger识别了，不过我们这里象征性地加上一个描述信息：

@Controller
@RequestMapping("/test")
public class TestController {
 @ApiOperation(value="一个测试API",notes = "第一个测试api")
 @ResponseBody
 @RequestMapping(value = "/hello",method = RequestMethod.GET)
 public String hello()
 {
  return "hello";
 }
}
 

这里仅仅多了一个@ApiOperation注解，别的和一个普通的springmvc的控制器完全一致。

实际上，为了形成一个完整的api文档，需要添加的注解常常很多，若是都写在同一个文件里就会显得臃肿，我们常常会写一个接口文件，将注解都放在接口文件中，然后再用一个实体类来实现控制器，算是实现配置和逻辑分离了吧。

六、查看接口文件和文档

若是没有问题，现在可以部署项目，并打开http://localhost:8080/demo/v2/api-docs：

Firefox提供了查看JSON的插件，推荐大家搜索试试看。

废话不多说，这里可以看到之前配置的诸多信息。注入description，version，title等。并且确实有TestController的信息。

最后，我们打开http://localhost:8080/swagger-ui.html，便可以看到一个漂亮的界面了：

以上这篇详谈Springfox与swagger的整合使用就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持。

# springfox  # swagger  # 浅谈springfox-swagger原理解析与使用过程中遇到的坑  # Spring Boot集成springfox-swagger2构建restful API的方法教程  # Spring MVC集成springfox-swagger2构建restful API的方法详解  # 如何使用Springfox Swagger实现API自动生成单元测试  # 是一个  # 配置文件  # 的是  # 则是  # 文档  # 这是一个  # 就可以  # 第一个  # 不需要  # 我们可以  # 给大家  # 便可  # 创建一个  # 要写  # 自己的  # 这是  # 就会  # 放在  # 有个  # 在这个 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何在建站主机中优化服务器配置？  Laravel如何与Docker（Sail）协同开发？（环境搭建教程）  Android okhttputils现在进度显示实例代码  Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程  js代码实现下拉菜单【推荐】  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设？  Laravel表单请求验证类怎么用_Laravel Form Request分离验证逻辑教程  Laravel的辅助函数有哪些_Laravel常用Helpers函数提高开发效率  bootstrap日历插件datetimepicker使用方法  深圳网站制作的公司有哪些,dido官方网站？  Laravel如何使用Vite进行前端资源打包？（配置示例）  Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】  javascript中的数组方法有哪些_如何利用数组方法简化数据处理  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  通义万相免费版怎么用_通义万相免费版使用方法详细指南【教程】  轻松掌握MySQL函数中的last_insert_id()  Laravel如何发送邮件和通知_Laravel邮件与通知系统发送步骤  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  Android仿QQ列表左滑删除操作  Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】  Linux系统命令中screen命令详解  php静态变量怎么调试_php静态变量作用域调试技巧【解答】  如何快速搭建高效服务器建站系统？  网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  微信小程序 wx.uploadFile无法上传解决办法  Laravel用户认证怎么做_Laravel Breeze脚手架快速实现登录注册功能  如何在IIS服务器上快速部署高效网站？  Laravel怎么清理缓存_Laravel optimize clear命令详解  Laravel如何保护应用免受CSRF攻击？（原理和示例）  悟空识字怎么关闭自动续费_悟空识字取消会员自动扣费步骤  Windows11怎样设置电源计划_Windows11电源计划调整攻略【指南】  Laravel如何实现本地化和多语言支持_Laravel多语言配置与翻译文件管理  长沙企业网站制作哪家好,长沙水业集团官方网站？  如何在云主机上快速搭建多站点网站？  魔毅自助建站系统：模板定制与SEO优化一键生成指南  如何用免费手机建站系统零基础打造专业网站？  成都网站制作公司哪家好,四川省职工服务网是做什么用？  如何用AI一键生成爆款短视频文案？小红书AI文案写作指令【教程】  Laravel如何使用Eloquent ORM进行数据库操作？（CRUD示例）  Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  C++时间戳转换成日期时间的步骤和示例代码  ChatGPT常用指令模板大全 新手快速上手的万能Prompt合集  利用 Google AI 进行 YouTube 视频 SEO 描述优化  重庆市网站制作公司,重庆招聘网站哪个好？  Laravel路由怎么定义_Laravel核心路由系统完全入门指南  Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱？  公司门户网站制作流程,华为官网怎么做？  惠州网站建设制作推广,惠州市华视达文化传媒有限公司怎么样？  网站制作大概要多少钱一个,做一个平台网站大概多少钱？