SpringBoot3和SpringBoot2分别整合knife4j(openApi)

文章目录

  • 一、SpringBoot2进行整合knife4j
    • 1.1 导入依赖
    • 1.2 配置knife4j 配置文件
    • 1.3 可以在接口上配置 注解进行信息的配置
  • 二、SpringBoot3 整合kinfe4j(openApi)
    • 2.1 导入依赖
    • 2.2 yaml配置文件
    • 2.3 swagger初始化配置
    • 2.4 创建接口

一、SpringBoot2进行整合knife4j

1.1 导入依赖

        <dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-spring-boot-starter</artifactId></dependency>

1.2 配置knife4j 配置文件

package com.ds.common.knife4j; //com.atguigu.common.config.knife4j;import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;import java.util.ArrayList;
import java.util.List;/**
* knife4j配置信息
*/
@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfig {@Beanpublic Docket adminApiConfig(){List<Parameter> pars = new ArrayList<>();ParameterBuilder tokenPar = new ParameterBuilder();tokenPar.name("token").description("用户token").defaultValue("").modelRef(new ModelRef("string")).parameterType("header").required(false).build();pars.add(tokenPar.build());//添加head参数endDocket adminApi = new Docket(DocumentationType.SWAGGER_2).groupName("adminApi").apiInfo(adminApiInfo()).select()//只显示admin路径下的页面.apis(RequestHandlerSelectors.basePackage("com.ds")).paths(PathSelectors.regex("/admin/.*"))  // "/admin/.*".build().globalOperationParameters(pars);return adminApi;}private ApiInfo adminApiInfo(){return new ApiInfoBuilder().title("后台管理系统-API文档").description("本文档描述了后台管理系统微服务接口定义").version("1.0").contact(new Contact("DS-ERP", "http://DS.com", "DS@qq.com")).build();}}

1.3 可以在接口上配置 注解进行信息的配置

package com.ds.process.controller;import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.ds.common.result.Result;
import com.ds.model.vo.process.ProcessQueryVo;
import com.ds.model.vo.process.ProcessVo;
import com.ds.process.service.OaProcessService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;/*** <p>* 审批类型 前端控制器* </p>**/
@Api("审批页面")
@RestController
@RequestMapping(value = "/admin/process")
public class OaProcessController {@Autowiredprivate OaProcessService processService;//审批管理列表@ApiOperation(value = "获取分页列表")@GetMapping("{page}/{limit}")public Result index(@PathVariable Long page,@PathVariable Long limit,ProcessQueryVo processQueryVo) {Page<ProcessVo> pageParam = new Page<>(page,limit);IPage<ProcessVo> pageModel =processService.selectPage(pageParam,processQueryVo);return Result.ok(pageModel);}
}

二、SpringBoot3 整合kinfe4j(openApi)

2.1 导入依赖

<dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId><version>4.1.0</version>
</dependency>
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional>
</dependency>

2.2 yaml配置文件

server:port: 8080
# springdoc-openapi项目配置,访问地址:http://127.0.0.1:8080/doc.html
springdoc:swagger-ui:path: /swagger-ui.htmltags-sorter: alphaoperations-sorter: alphaapi-docs:path: /v3/api-docsgroup-configs:- group: 'default'paths-to-match: '/**'packages-to-scan: com.hexadecimal.example# knife4j的增强配置,不需要增强可以不配
knife4j:enable: truesetting:language: zh_cn# Logger Config
logging:level:com.hexadecimal: debug
  1. springdoc.swagger-ui.path配置UI界面的访问路径。
  2. knife4j.enable是否开启增强配置。
  3. 配置项目的日志级别为debug。

2.3 swagger初始化配置

@Configuration
public class SwaggerConfig {@Beanpublic OpenAPI springShopOpenAPI() {return new OpenAPI().info(new Info().title("十六进制说").description("十六进制说API文档").version("v1").license(new License().name("Apache 2.0").url("http://springdoc.org"))).externalDocs(new ExternalDocumentation().description("外部文档").url("https://springshop.wiki.github.org/docs"));}}

2.4 创建接口

@Tag(name = "用户管理")
@RestController
@Slf4j
public class UserController {@Operation(summary = "查询")@GetMapping("query")public UserDO query(@Parameter(name = "name", description = "名称") String name) {UserDO userDO = new UserDO();userDO.setName(name);return userDO;}@Operation(summary = "列表")@PostMapping("list")public List<UserDO> list() {return new ArrayList<UserDO>();}@Operation(summary ="新增")@PostMapping("add")public UserDO add(UserDO userDO) {return new UserDO();}@Operation(summary ="修改")@PostMapping("update")public UserDO update(UserDO userDO) {return new UserDO();}@Operation(summary ="删除")@PostMapping("delete")public Boolean delete(Integer id) {return true;}
}

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/web/11188.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

【云原生】kubernetes核心组件

引言&#xff1a; Kubernetes 是为运行分布式集群而建立的&#xff0c;分布式系统的本质使得网络成为 Kubernetes 的核心和必要组成部分&#xff0c;了解 Kubernetes 网络模型可以使你能够正确运行、监控和排查应用程序故障。 一、Kubernetes的核心组件 1.1、Master组件 1.1.…

基于Springboot+Vue的Java项目-农产品直卖平台系统开发实战(附演示视频+源码+LW)

大家好&#xff01;我是程序员一帆&#xff0c;感谢您阅读本文&#xff0c;欢迎一键三连哦。 &#x1f49e;当前专栏&#xff1a;Java毕业设计 精彩专栏推荐&#x1f447;&#x1f3fb;&#x1f447;&#x1f3fb;&#x1f447;&#x1f3fb; &#x1f380; Python毕业设计 &am…

Kubernetes之Headless Services

Kubernetes中的Headless Services&#xff08;无头服务&#xff09;是一种特殊类型的服务&#xff08;Service&#xff09;定义&#xff0c;它不提供传统意义上的负载均衡和集群IP地址分配。在无头服务中&#xff0c;spec.clusterIP 字段被显式设置为None &#xff0c;Kubernet…

可道云teamOS企业网盘实用插件介绍:实时在线流程图编辑与分享,用在线流程图打造数字化工作流程

在使用企业网盘用于日常办公的情况下&#xff0c;有一些实用的在线小工具能为团队效率和协作带来一定的提升。 今天要给大家介绍的可道云teamOS的在线画流程图&#xff0c;是很值得介绍的一个在线工具。 在线流程图&#xff1a;直观展示&#xff0c;高效便捷 以往我们想要梳理…

FANUC机器人单轴零点标定时提示无法执行零点标定,由于重力补偿已启用,所有机器人轴的脉冲计数必须有效

FANUC机器人单轴零点标定时提示无法执行零点标定,由于重力补偿已启用,所有机器人轴的脉冲计数必须有效 首先,机器人由于长时间断电未使用,6个轴的编码器数据全部丢失,上电后报警SRVO-062, 有关SRVO-062故障报警的相关内容可参考以下链接: FANUC机器人SRVO-062报警原因分…

LeetCode 2391. 收集垃圾的最少总时间

Problem: 2391. 收集垃圾的最少总时间 问题分解 我们将这个问题分解为以下几个小问题&#xff1a; 计算每种垃圾&#xff08;金属、纸、玻璃&#xff09;在每个房子中的数量。确定每种垃圾车最后到达的房子。计算每种垃圾车行驶的总时间。计算每种垃圾车收拾垃圾的总时间。返…

SQLite 语法大全

SQLite EXPLAIN 语句&#xff1a; EXPLAIN INSERT statement...; or EXPLAIN QUERY PLAN SELECT statement...; SQLite GLOB 子句&#xff1a; SELECT column1, column2....columnN FROM table_name WHERE column_name GLOB { PATTERN }; SQLite GROUP BY 子句&#xff1…

journalctl参数详解

journalctl 是 Systemd 日志管理工具&#xff0c;用于查看、查询和管理 Systemd 系统日志。 #-x: 详细模式&#xff08;Verbose&#xff09;。这个选项会使 journalctl 输出完整的日志消息&#xff0c;包括其原始结构&#xff0c;如嵌套的JSON消息、未展开的环境变量等。这对于…

Scratch四级:第08讲 排序算法

第08讲 排序算法 教练&#xff1a;老马的程序人生 微信&#xff1a;ProgrammingAssistant 博客&#xff1a;https://lsgogroup.blog.csdn.net/ 讲课目录 常考的排序算法项目制作&#xff1a;“三个数排序”项目制作&#xff1a;“成绩查询”项目制作&#xff1a;“排序”项目制…

单片机智能灯控制系统源程序仿真原理图与论文全套资料

目录 1、设计描述 2、仿真图 3、程序 4、资料内容 资料下载地址&#xff1a;单片机智能灯控制系统源程序仿真原理图与论文全套资料下载 1、设计描述 设计了一款智能控制系统。 AT89C51LCD1602DS1302按键LED组成了这样一个完整的设计。 P2.0-P2.3 4个LED等代表庭院内的4…

计算机视觉——Opencv blobFromImage与torchvision实现数据标准化

1.blobFromImage blobFromImage 是 OpenCV 的深度神经网络&#xff08;DNN&#xff09;模块中的一个函数&#xff0c;它用于将图像转换为深度学习模型所需的输入格式&#xff0c;主要是对传入的图像进行的转换包括图像尺寸调整、均值减法、缩放等预处理步骤&#xff0c;以便图…

架构设计之学新而知故

缘由 因为一些特殊的机缘&#xff0c;接触到洋葱架构等一些新架构设计概念。 尝试理解了一段时间&#xff0c;就想简单梳理下对它们的理解&#xff0c;以达到学新而知故 &#x1f603; 信息增益 以前计算机专业并不设置通信领域的信息论的专业课程&#xff0c;但是&#xf…

输出指定日期区间内的所有天、周、月

hutool获取指定时间周几 Slf4j public class DateWeekUtil {public static List<String> getDateWeek(String startDateString, String endDateString, List<Integer> codeList) {List<String> dateInfoList new ArrayList<>();List<Integer> v…

工作随机:linux 挂载LVM管理模式的磁盘

文章目录 前言一、创建一个分区二、创建PV三、创建VG四、创建LV五、格式化并挂载目录 前言 在数据库管理中&#xff0c;常有比较头疼的问题&#xff0c;就是一段时间发展后我的磁盘空间不够了&#xff0c;想要扩容原有的目录很是头疼&#xff0c;那么LVM管理的优势就体现出来了…

JAVA学习-练习试用Java实现改写字符串

问题&#xff1a; 键盘录入一个字符串&#xff0c;将字符串中的大写改成小写&#xff0c;小写改成大写&#xff0c;数字改成。例如heLLO123,输出后为HEllo** 解答思路&#xff1a; import java.util.Scanner;public class StringConversion {public static void main(String…

单元测试之JUnit5知识点总结及代码示例

单元测试是软件开发过程中的一种验证手段&#xff0c;它针对最小的可测试部分&#xff08;通常是函数或方法&#xff09;进行检查和验证。其实单元测试还是挺重要的&#xff0c;不过国内很多公司的项目其实并没有做好单元测试&#xff0c;或者根本就没做单元测试&#xff0c;原…

英语复习之英语形近词总结(四)

英语形近词总结复习第四部分&#xff1a; 单词 释义例句 genuine 英 /ˈdʒenjuɪn/ 美 /ˈdʒenjuɪn/ adj.真实的&#xff0c;真正的&#xff1b;诚恳的 1.Only genuine refugees can apply for asylum. 只有真正的难民才能申请政治避难。 《牛津词典》 2.This isnt a genui…

C++笔试强训day19

目录 1.小易的升级之路 2.礼物的最大价值 3.对称之美 1.小易的升级之路 链接 模拟就行&#xff0c;唯一可能是难点得就是gcd&#xff08;最大公约数&#xff09; #include <iostream> using namespace std; #define int long long const int N 1e5 10; int arr[N];…

儿童悬吊训练系统如何进行制动肌的动力训练

儿童悬吊训练系统进行制动肌的动力训练&#xff0c;可以按照以下步骤进行&#xff1a; 评估&#xff1a;首先&#xff0c;治疗师需要对儿童的制动肌进行评估&#xff0c;确定其稳定性和力量水平&#xff0c;从而制定合适的训练计划。 选择训练方式&#xff1a;根据评估结果&am…

利用IP地址查询解决被“薅羊毛”的方法

在互联网时代&#xff0c;随着各种网络诈骗手段的不断更新和演变&#xff0c;“薅羊毛”成为了一种常见的网络犯罪行为。其中&#xff0c;利用查询IP地址进行欺诈活动已经成为一种普遍的手段。当个人或组织的IP地址被不法分子查询后&#xff0c;可能会面临虚假注册、盗取个人信…