Swagger 获取不到参数，接口用对象接参，注解的使用等

最新推荐文章于 2024-05-23 10:40:35 发布
最新推荐文章于 2024-05-23 10:40:35 发布
阅读量6k 收藏 2
点赞数 2
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_44678295/article/details/104822746
版权

初次使用Swagger 踩了不少坑，总结一下

牢记一点，Swagger全部是以JSON的格式向后台传参的

当使用Vo类接收参数，用@ApiModel标注Vo类，如果需要在Swagger页面展示出Vo的每个属性，把方法参数前的@RequestBody去掉，反之，则是以JSON对象的格式在Swagger页面输入参数

当使用多个变量接收参数，在方法的上部用
@ApiImplictParams（{ @ApiImplictParam(name ="",value="",paramType ="query") }）
即可，paramType决定你的Swagger传递的参数后台在哪里获取

在前后端分离的情况下我浪费了很多时间改swagger的备注，因为前端模块把数据封装成了对象去请求后端，而很多时候前后端的控制层都是复制过来的。。。一般前端模块为了调试需要把参数对象的属性都暴露出来，如果直接复制到后端就会导致参数映射不上，所以后端使用@RequestBody加Vo类获取数据

面向钞票编程
关注
  • 2
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
swagger @ApiModel 返回内容注释不显示问题
11-17
swagger @ApiModel 返回内容注释不显示问题 展开无类信息
Swagger实战完整代码
11-08
在本实战项目中，我们将全面探索Swagger的核心概念、使用方法以及如何将其集成到实际的项目开发中。Swagger 2是Swagger的最新版本，提供了更加强大和灵活的功能。 Swagger的核心功能包括： 1. **API定义**: ...
Swagger字段属性说明不显示
qq_33240556的博客
05-23 1223
解决此问题的一般步骤是先检查模型类上的注解是否完整且正确，然后检查Swagger的配置，最后考虑是否存在版本兼容性或前端显示问题。：有时候问题可能不在后端配置，而是前端Swagger UI的显示问题。：如果使用了特定的JSON序列化库（如Jackson或Gson），确保它们的配置没有无意间排除了Swagger需要的元数据。：确保在模型类（实体类）的字段或getter/setter方法上使用了Swagger提供的注解来提供描述信息。：检查Swagger配置是否正确开启了模型属性的展示。
使用swagger3是项目无法启动 或 无法获取api信息解决方法
weixin_49245941的博客
08-13 1096
解决办法：将依赖中的spring-plugin-core去除，并添加高版本。
如何集成swagger2构建Restful API
08-25
// 如果某个接口不想暴露,可以使用以下注解 // @ApiIgnore 这样,该接口就不会暴露在 swagger2 的页面下 .apis(RequestHandlerSelectors.basePackage("cn.taosir.api.controller")) .paths(PathSelectors.any()) ...
jooby-apitool-param-obj:带有不正确的参数对象API文档的jooby项目示例
05-18
1. **参数注解**：确保对象的每个属性都用适当的注解进行标记，以便Jooby可以正确地解析和验证它们。例如，`@Path`、`@QueryParam`、`@Header`或`@Body`。 2. **模型绑定**：Jooby提供了自动模型绑定功能，能够将...
根据vo生成yapi文档：YapiFileGenerattor.zip
12-29
YapiFileGenerattor.java是这个项目的主要实现文件，它通常会包含一个Java类，该类负责解析VO（Value Object）类，从中提取方法、参数、返回类型等信息，并将这些信息转换为Yapi支持的JSON格式，以便导入到Yapi平台...
解法哦mysqlPython.txt
08-06
mysql解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlPython.txt解法哦mysqlP
相当易用的 Python 3D 渲染引擎.zip
08-06
python 相当易用的 Python 3D 渲染引擎.zip
毕业设计-c语言在线考试系统.zip
08-06
优质项目，资源经过严格测试可直接运行成功且功能正常的情况才上传，可轻松copy复刻，拿到资料包后可轻松复现出一样的项目。 本人系统开发经验充足，有任何使用问题欢迎随时与我联系，我会及时为你解惑，提供帮助。 【资源内容】：包含完整源码+工程文件+说明（若有），项目具体内容可查看下方的资源详情。 【附带帮助】： 若还需要相关开发工具、学习资料等，我会提供帮助，提供资料，鼓励学习进步。 【本人专注嵌入式领域】： 有任何使用问题欢迎随时与我联系，我会及时解答，第一时间为你提供帮助，CSDN博客端可私信，为你解惑，欢迎交流。 【适合场景】： 相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可以基于此项目进行扩展来开发出更多功能 【无积分此资源可联系获取】 # 注意 1. 本资源仅用于开源学习和技术交流。不可商用等，一切后果由使用者承担。 2. 部分字体以及插图等来自网络，若是侵权请联系删除。积分/付费仅作为资源整理辛苦费用。
基于微信PC端的Python接口，开发者可通过Python轻松调用 实现微信机器人、群管理等强大的功能
08-06
基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人、群管理等强大的功能基于微信PC端的Python接口，开发者可通过Python轻松调用。实现微信机器人
ILMergeUI 基于C#的dll合并Demo
08-06
ILMergeUI 基于C#的dll合并Demo，将多个动态链接库合并至exe或者主动态链接库。
pom.xml非常好用
08-06
1212
直销员用户信息台账.xlsx
08-06
销售管理表，财务报表，占比分析，消费能力分析，数据分析表，产品销售，客户关系 适用人群：学习不同技术领域的小白或进阶学习者；可作为毕设项目、课程设计、大作业、工程实训或初期项目立项。
【流程管理】LTC流程介绍.pptx
08-06
【流程管理】LTC流程介绍.pptx
基于python开发的腾讯JCE协议解析+源码（毕业设计&课程设计&项目开发）
08-06
基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~ 基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~ 基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~ 基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~ 基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~ 基于python开发的腾讯JCE协议解析+源码，适合毕业设计、课程设计、项目开发。项目源码已经过严格测试，可以放心参考并在此基础上延申使用~
斯坦福cs229课程笔记小抄
最新发布
08-06
斯坦福大学著名的cs229机器学习课程可谓无人不知无人不晓，但其丰富庞杂的内容有时候也令人望而却步。 资源里整理了全课程中最重要的概念重点，做成了高度凝练的笔记小抄，一方面可以作为学习者的快速复习资料，另一方面也方便那些没有时间深入了解课程但希望快速掌握核心知识点的专业人士。这份笔记小抄涵盖了以下几个方面： 基础概念：包括机器学习的定义、分类、以及监督学习、无监督学习、强化学习等基本类型。 主要算法：从线性回归、逻辑回归到决策树、随机森林，再到支持向量机和神经网络，每个算法的原理、优缺点和应用场景都进行了简要介绍。 模型评估：介绍了交叉验证、偏差-方差权衡、ROC曲线等模型评估方法，帮助学习者理解如何评估和选择模型。 优化技术：包括梯度下降、随机梯度下降等优化算法，以及正则化技术在防止过拟合中的应用。 特征工程：讨论了特征选择、特征提取和特征构造等关键步骤，以及它们在提高模型性能中的作用。 深度学习：特别强调了深度学习的重要性，包括卷积神经网络(CNN)、循环神经网络(RNN)、长短期记忆网络(LSTM)等高级模型。
月度销售业绩统计表（精美大方销售表）.xlsx
08-06
销售管理表，财务报表，占比分析，消费能力分析，数据分析表，产品销售，客户关系 适用人群：学习不同技术领域的小白或进阶学习者；可作为毕设项目、课程设计、大作业、工程实训或初期项目立项。
接口上说明参数的swagger注解
06-02
Swagger可以通过注解的方式来描述API的请求参数。常用的注解包括： - @Api：用于描述API的基本信息，包括名称、描述、版本等信息； - @ApiOperation：用于描述API的操作，包括HTTP方法、URL、操作名称、操作描述等信息； - @ApiParam：用于描述API的请求参数，包括参数名、数据类型、是否必填、默认值、描述等信息； - @ApiImplicitParam：用于描述API的请求参数，包括参数名、数据类型、是否必填、默认值、描述等信息； - @ApiImplicitParams：用于描述API的多个请求参数，可以包含多个@ApiImplicitParam注解； - @ApiModel：用于描述API的请求或响应参数的数据模型，包括模型名、字段、描述等信息； - @ApiModelProperty：用于描述API的请求或响应参数的数据模型的字段，包括字段名、数据类型、描述等信息。 例如，以下是一个使用Swagger注解的示例： ``` @RestController @Api(tags = "用户管理") @RequestMapping("/api/users") public class UserController { @GetMapping("/{id}") @ApiOperation(value = "根据ID获取用户信息", notes = "根据用户ID获取用户信息") public User getUserById(@PathVariable Long id) { // ... } @PostMapping @ApiOperation(value = "创建用户", notes = "创建新用户") public User createUser(@ApiParam(name = "用户信息", value = "用户对象", required = true) @RequestBody User user) { // ... } } ``` 在上面的示例中，@Api注解描述了API的基本信息，@ApiOperation注解描述了API的操作信息，@ApiParam注解描述了请求参数的信息。这些注解可以帮助开发者更好地理解API的含义和用法，提高API的可读性和可维护性。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值