最新动态
配置最新 Docker Engine
2024-12-19 15:12


官网:https://swagger.io/

介绍:

  1. 号称世界上最流行的Api框架;
  2. RestFul Api文档在线自动生成工具=》Api文档与API定义同步更新;
  3. 直接运行,可以在线测试API接口;
  4. 支持多种语言:Java,Php...

SpringBoot集成Swagger2

在项目中使用Swagger需要Springbox(1、swagger2;2、ui )

1、在maven(官网:https://mvnrepository.com/)中查找相关依赖



2、配置Swagger ==> SwaggerConfig



3、运行测试,访问路径 :http://localhost:8080/swagger-ui.html

运行报错 “ Failed to start bean ‘documentationPluginsBootstrapper’; nested exception is java.lang.NullPointerException ” 

原因:版本问题。springboot高版本(2.6.x)和swagger2的低版本(2.9.2)不兼容,将springboot改为低版本如2.1.x,2.4.x等

4、配置swagger信息



5、swagger配置扫描接口



 Swagger在生产环境中使用,在发布时不使用?

  1. 判断是否是生产环境 flag=false
  2. 注入enable(flag)


 6、配置API文档的分组

.groupName("Form")

如何配置多个分组;多个Docket实例即可




总结:

  1. 我们可以通过Swagger给一些比较难理解的属性或接口,增加注释信息
  2. 接口文档实时更新
  3. 可以在线测试

【注意点】在正式发布的时候,一定要关闭Swagger!!!处于安全以及节省内存的考虑!

官网:https://doc.xiaominfo.com/

Knife4j是一款可以提供在线API文档的框架,是基于Swagger2框架实现的。

框架适配

  • Spring MVC
  • Spring Boot 2.2、2.3、2.4、2.5、2.6、2.7

SpringBoot集成knife4j

1、导入依赖



2、配置Knife4j==> Knife4jConfig



3、接口测试



4、访问路径

默认:http://localhost:8080/doc.html


 版本说明:

Knife4j 2.0.6及以上的版本兼容SpringBoot大于等于2.2.x

(2.6.0之后的需要设置)

官网下载地址:https://www.postman.com/downloads/


    以上就是本篇文章【配置最新 Docker Engine】的全部内容了,欢迎阅览 ! 文章地址:http://fabua.ksxb.net/quote/4151.html 
     动态      相关文章      文章      同类文章      热门文章      栏目首页      网站地图      返回首页 海之东岸资讯移动站 http://fabua.ksxb.net/mobile/ , 查看更多