knife4j-openapi3 使用笔记

ops/2024/9/22 15:33:57/

knife4j官方文档:https://doc.xiaominfo.com/docs/quick-start/start-knife4j-version
增强模式文档:https://doc.xiaominfo.com/docs/features/enhance

1.用法

(1)控制层 @Tag(name = “用户信息管理”)

java">@Tag(name = "用户信息管理")
@RestController
@RequestMapping("/test/user")
public class TestController {
}

(2)方法 @Operation(summary = “获取用户列表”),@Parameter(name = “userId”)

java">@Operation(summary = "获取用户列表")
@GetMapping("/list")
public R<List<UserEntity>> userList() {List<UserEntity> userList = new ArrayList<UserEntity>(users.values());return R.ok(userList);
}@Operation(summary = "获取用户详细")
@Parameter(name = "userId", description = "用户ID", required = true)
@GetMapping("/{userId}")
public R<UserEntity> getUser(@PathVariable Integer userId) {if (!users.isEmpty() && users.containsKey(userId)) {return R.ok(users.get(userId));} else {return R.fail("用户不存在");}
}

(3)实体

java">@Tag(name = "UserEntity", description = "用户实体")
class UserEntity {@Schema(name = "用户ID")private Integer userId;
}

http://www.ppmy.cn/ops/36356.html

相关文章

猫咪没精神不吃饭?这招主食冻干喂养教你让猫咪恢复食欲

猫突然不吃东西没精神是生病了吗&#xff1f;当猫咪不吃东西、精神不振时&#xff0c;可能的原因有健康问题、环境因素或食物原因。首先应进行身体检查&#xff0c;观察是否有其他并发症&#xff0c;如无则可排除健康问题。还要给猫咪提供一个舒适的环境&#xff0c;多给它们一…

MySQL从入门到高级 --- 3.DML基本操作

文章目录 第三章&#xff1a;3.基本操作 - DML3.1 数据插入3.2 数据修改3.3 数据删除3.4 练习 第三章&#xff1a; 3.基本操作 - DML DML&#xff1a;数据操作语言&#xff0c;用来对数据中表的数据记录进行更新 关键字&#xff1a; insert 插入 delete 删除 update 更新 …

SpringMVC响应数据

三、SpringMVC响应数据 3.1 handler方法分析 理解handler方法的作用和组成&#xff1a; /*** TODO: 一个controller的方法是控制层的一个处理器,我们称为handler* TODO: handler需要使用RequestMapping/GetMapping系列,声明路径,在HandlerMapping中注册,供DS查找!* TODO: ha…

揭秘 IEEE/ACM Trans/CCF/SCI,谁才是科研界的王者?

会议之眼 快讯 在学术探索的浩瀚星海中&#xff0c;每一篇论文都像是一颗璀璨的星辰&#xff0c;而那些被顶级期刊或会议收录的论文&#xff0c;则无疑是最耀眼的几颗。 在众多评价标准中&#xff0c;IEEE/ACM Transactions、CCF推荐期刊和会议、SCI分区期刊&#xff0c;它们…

怎么给切面增加开关

为切面添加开关功能&#xff0c;可以在运行时控制是否启用切面逻辑&#xff0c;这对于调试、性能优化或特定场景的灵活控制非常有用。下面是一个基于Spring AOP和配置属性实现的简单示例&#xff0c;展示了如何为切面逻辑添加开关。 步骤 1: 添加配置属性 首先&#xff0c;定…

Docker安装Jenkins

1.下载镜像 docker pull jenkins/jenkins:lts 2.创建挂载目录 需要修改下目录权限&#xff0c;因为当映射本地数据卷时&#xff0c;/data/jenkins_home/目录的拥有者为root用户&#xff0c; 而容器中jenkins用户的 uid 为 1000。 # 创建文件夹&#xff08;Jenkins工作空间…

安卓使用so库

最近需要给小伙伴扫盲一下如何使用Android Studio 生成一个SO文件&#xff0c;网上找了很多都没有合适的样例&#xff0c;那只能自己来写一个了。 原先生成SO是一个很麻烦的事情&#xff0c;现在Android Studio帮忙做了很多的事情&#xff0c;基本只要管好自己的C代码即可。 …

常见比较实用的Chrome命令/扩展程序

文章目录 一、Chrome命令二、Chrome操作三、Chrome扩展程序 一、Chrome命令 Chrome浏览器提供了一系列实用的内部命令和URL&#xff0c;这些命令可以帮助用户快速访问浏览器的各种功能和设置。以下是一些实用的Chrome命令&#xff1a; 查看所有支持的命令&#xff1a; 直接在…