服务器之家

服务器之家 > 正文

关于springboot集成swagger及knife4j的增强问题

时间:2021-08-26 11:29     来源/作者:潇 七

参考链接:狂神的Swagger笔记

  • 号称世界上最流行的API框架
  • Restful Api 文档在线自动生成器 => API 文档 与API 定义同步更新
  • 直接运行,在线测试API
  • 支持多种语言 (如:Java,PHP等)
  • 官网:swagger

SpringBoot集成Swagger 添加maven依赖

  1. <dependency>
  2. <groupId>io.springfox</groupId>
  3. <artifactId>springfox-swagger2</artifactId>
  4. <version>2.9.2</version>
  5. </dependency>
  6.  
  7. <dependency>
  8. <groupId>io.springfox</groupId>
  9. <artifactId>springfox-swagger-ui</artifactId>
  10. <version>2.9.2</version>
  11. </dependency>

要求:jdk 1.8 + 否则swagger2无法运行 要使用Swagger,我们需要编写一个配置类-SwaggerConfig来配置 Swagger

  1. package com.yf.exam.config;
  2.  
  3. import org.springframework.context.annotation.Bean;
  4. import org.springframework.context.annotation.Configuration;
  5. import springfox.documentation.service.ApiInfo;
  6. import springfox.documentation.service.Contact;
  7. import springfox.documentation.spi.DocumentationType;
  8. import springfox.documentation.spring.web.plugins.Docket;
  9. import springfox.documentation.swagger2.annotations.EnableSwagger2;
  10.  
  11. import java.util.ArrayList;
  12.  
  13. @Configuration
  14. @EnableSwagger2
  15. public class SwaggerConfig {
  16.  
  17. //配置了swagger的Docket 的 bean 实例
  18. @Bean
  19. public Docket docket(){
  20. return new Docket(DocumentationType.SWAGGER_2)
  21. .apiInfo(apiInfo());
  22. }
  23. //配置 swagger 信息 = apiInfo
  24. private ApiInfo apiInfo(){
  25. //作者信息
  26. Contact contact = new Contact("潇七", "https://www.xhost.vip/", "2278023068@qq.com");
  27. return new ApiInfo("API文档",
  28. "接口信息",
  29. "v1.0",
  30.  
  31. contact,
  32. "Apache 2.0",
  33. "http://www.apache.org/licenses/LICENSE-2.0",
  34. new ArrayList()
  35. );
  36. }
  37. }

访问测试 :http://localhost:8080/swagger-ui.html ,可以看到swagger的界面;
-

关于springboot集成swagger及knife4j的增强问题

knife4j

官网参考地址:knife4j
knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案(在非Java项目中也提供了前端UI的增强解决方案),前身是swagger-bootstrap-ui,取名knife4j是希望她能像一把匕首一样小巧,轻量,并且功能强悍!

简洁

基于左右菜单式的布局方式,是更符合国人的操作习惯吧.文档更清晰…

个性化配置

个性化配置项,支持接口地址、接口description属性、UI增强等个性化配置功能…

增强

接口排序、Swagger资源保护、导出Markdown、参数缓存众多强大功能.

SpringBoot集成Knife4j 添加maven依赖

  1. <dependency>
  2. <groupId>com.github.xiaoymin</groupId>
  3. <artifactId>knife4j-spring-boot-starter</artifactId>
  4. <!--在引用时请在maven中央仓库搜索最新版本号-->
  5. <version>2.0.4</version>
  6. </dependency>

-访问测试 :http://localhost:8080/doc.html ,可以看到knife4j的界面;

关于springboot集成swagger及knife4j的增强问题

离线文档导出

Knife4j提供导出4种格式的离线文档(Html\Markdown\Word\Pdf)

到此这篇关于springboot集成swagger以及knife4j的增强的文章就介绍到这了,更多相关springboot集成swagger内容请搜索服务器之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持服务器之家!

原文链接:https://blog.csdn.net/m0_48402871/article/details/114966519

相关文章

热门资讯

yue是什么意思 网络流行语yue了是什么梗
yue是什么意思 网络流行语yue了是什么梗 2020-10-11
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全 2019-12-26
背刺什么意思 网络词语背刺是什么梗
背刺什么意思 网络词语背刺是什么梗 2020-05-22
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总 2020-11-13
2021年耽改剧名单 2021要播出的59部耽改剧列表
2021年耽改剧名单 2021要播出的59部耽改剧列表 2021-03-05
返回顶部