SpringFox介绍

SpringFox是一个开源的API Doc的框架, 它的前身是swagger-springmvc,可以将我们的Controller中的方法以文档的形式展现。官方定义为:Automated JSON API documentation for API's built with Spring。

Swagger介绍

Swagger是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。

SpringFox使用教程

第一步:Maven框架机构Springboot项目,依赖SpringFox包:

<

第二步:在Springboot项目启动添加注解@EnableOpenApi:

第三步:创建测试API接口,包含实体类/控制器用户实体类:

package 

用户控制器:

package 

API统一响应工具类:

package 

第四步:启动Springboot项目,访问Swagger页面:http://localhost:8080/swagger-ui/index.html

打开其中一个API接口文档,可以包含接口的请求与响应的详细信息,并且支持在线接口测试。

注解说明
本文测试案例总共用到4个SpringFox注解,如下:

  • @Api:用在类上,说明该类的作用。可以标记一个Controller类做为swagger 文档资源。
  • @ApiOperation:用在方法上,说明方法的作用,每一个url资源的定义。
  • @ApiModel:描述一个Model的信息。
  • @ApiModelProperty:描述一个model的属性。

以上就是Springboot集成SpringFox生成Swagger接口文档的详细教程,虽然Swagger存在代码入侵性,但是在Api接口测试方面,它还是非常的不错,目前还多大公司使用改插件,可见其便捷性了。

springboot 接口文档 请求 enum_Spring Boot集成SpringFox 3:生成Swagger接口文档相关推荐

  1. spring boot 集成springfox,使用swagger对 API 接口进行测试管理的 demo 示例

    1. 描述 一个springboot项目集成 springfox 3.0,使用swagger对 API 接口进行测试管理的 demo示例. 环境: IDE(idea):2021.3 JDK:1.8 m ...

  2. 自动生成python接口文档_Django自动生成Swagger接口文档

    Django自动生成Swagger接口文档 1. 前言 当接口开发完成,紧接着需要编写接口文档.传统的接口文档通常都是使用Word或者一些接口文档管理平台进行编写,但此类接口文档维护更新比较麻烦,每次 ...

  3. swagger 扫描java文档_推荐一款在运行时通过javadoc生成Swagger API文档的库

    介绍 一般,我们使用Springfox生成swagger api文档,但Springfox不支持从javadoc中生成,只能通过注解的方式标注文档. 这样,当共享一些POJO类时,为了同时生成java ...

  4. Spring Boot(9)之 Swagger 接口文档生成器

    1.添加依赖 spring4all工具源码 <dependency><groupId>com.spring4all</groupId><artifactId& ...

  5. springboot 单测加入参数_Spring Boot集成Elasticsearch实战分享

    作者|java梦想口服液|简书 最近有读者问我能不能写下如何使用 Spring Boot 开发 Elasticsearch(以下简称 ES) 相关应用,今天就讲解下如何使用 Spring Boot 结 ...

  6. springboot(十八):使用Spring Boot集成FastDFS

    上篇文章介绍了如何使用Spring Boot上传文件,这篇文章我们介绍如何使用Spring Boot将文件上传到分布式文件系统FastDFS中. 这个项目会在上一个项目的基础上进行构建. 1.pom包 ...

  7. springboot 集成redis_一文详解Spring Boot 集成 Redis

    redis设置: 修改redis服务器的配置文件 vim /usr/local/redis/bin/redis.confbind 0.0.0.0 protected-mode no 重新启动redis ...

  8. laravel如何生成swagger接口文档

    php artisan serve --host 0.0.0.0 php artisan serve --port 8080 地址: http://127.0.0.1/blogkjh/public/a ...

  9. springfox源码_Spring boot整合Springfox在线生成restful的api doc

    Springfox是什么,有什么用? Springfox基于Swagger,能更方便的集成到spring boot 中,Swagger 是一个规范和完整的框架,用于生成.描述.调用和可视化 RESTf ...

最新文章

  1. 绿色数据中心空调技术研讨会福州召开
  2. 《Head First 设计模式》之命令模式——遥控器
  3. IIS 承载的WCF服务失败
  4. 合成人声、人脸替换等深度合成信息内容须进行显著标识
  5. Linux alias设置别名 Ubuntu设置别名创建简写指令短命令
  6. 处理器(CPU)发展简史
  7. 南阳58--最小步数(BFS)
  8. Bigendian 奇数内存地址取整形crash
  9. es 仅返回单个字段 查询_ES性能优化实战,几十亿数据查询 3 秒返回!
  10. 强大的 function adapters
  11. 可视化技巧:DataFrame画图并利用matplotlib保存(pandas)
  12. 《HTML5 2D游戏编程核心技术》——第3章,第3.8节绘制动画帧
  13. pandas之交叉表crosstab()
  14. docker添加加速器
  15. 计算机房电缆,机房设计常用计算公式大全
  16. maven-基本命令,打包包名问题
  17. 为什么理科男喜欢皈依佛门?
  18. 计算机制图怎么学,新手学电脑学习画图的方法
  19. Java实现99乘法表
  20. 哪些是python_什么是python?_【曾贤志】用Python处理Excel数据 - 第1季 基础篇_Excel视频-51CTO学院...

热门文章

  1. 坚果云开发团队分享高效代码审查经验
  2. Function spec
  3. webpack如何将css文件分离的,webpack--css:Less文件的打包和分离(八)
  4. git进入项目目录 windows_Windows下Git 怎么整个文件夹目录上传到代码仓库(不论GitHub、GitLab、Gitee、DevCloud)...
  5. 万字详述 MySQL ProxySQL
  6. Oracle坏块处理常用SQL
  7. 执行了rm-f,除了跑路,如何恢复?
  8. Oracle 19c 新特性:自动化索引 Automatic indexing 实践
  9. 深入解析:从源码窥探MySQL优化器
  10. 这才是大数据的正确打开方式