swagger踩过的坑

最新推荐文章于 2024-06-17 15:54:30 发布
最新推荐文章于 2024-06-17 15:54:30 发布
阅读量5.6k 收藏
点赞数 1
分类专栏： 框架入门总结 环境搭建 文章标签： swagger2
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/iechenyb/article/details/80420337
版权

关于ApiModel中的name和value属性，不能随意使用，默认的情况value等于类名，我们可以不填。通常情况下仅仅需要使用description字段就行。





如上图，value相同的model所有的属性都会在同一个目录下，不能达到IndexRQ2应用IndexRQParam的目的。

若将value改成不一样的，则，生成的json数据如下图：


iechenyb_
关注
  • 1
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Swagger注解 传参
shan317500的博客
08-14 5996
[@Api] @ Api用于声明Swagger资源API。 它有双重用途 - 它会 影响资源列表_和_ API声明。 只有使用@ Api注释的类才会被Swagger扫描。 在资源清单中，注释将转换为[资源对象] 在API声明中，它基本上将作为[API声明]本身的基础。 JAX-RS的用法是: @Api(tags = "区域：/area", description = "地区的增删查改...
swagger无法打开的说明
weixin_58276266的博客
01-17 7145
最近项目集成swagger2，结果本地swagger-ui.html可以打开，但是线上环境却无法打开。倒腾了一番终于解决问题，总结了以下几个解决方案： 1.@EnableWebMvc注解必须去掉！ 2.请实现WebMvcConfigurer，并添加如下代码 @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("swagger-ui.html")
swagger页面配置正常,常用的浏览器无法显示!
chrise_的博客
03-30 1万+
就是浏览器缓存的原因，你清一下浏览器的缓存就好了，就这么简单!是浏览器缓存的原因，你清一下浏览器的缓存就好了，就这么简单!浏览器缓存的原因，你清一下浏览器的缓存就好了，就这么简单!览器缓存的原因，你清一下浏览器的缓存就好了，就这么简单!器缓存的原因，你清一下浏览器的缓存就好了，就这么简单!存的原因，你清一下浏览器的缓存就好了，就这么简单!的原因，你清一下浏览器的缓存就好了，就这么简单!原因，你清一...
swagger 泛型T无法显示
最新发布
阿萨的专栏
06-17 477
1、基础封装泛型类中,不能使用@ApiModel注解来约束该泛型类的类名称，因为泛型类一旦用该注解进行约束后,在OpenAPI的结构中,类名称就只有一个，会导致字段属性找不到的情况。在返回结果如果为泛型封装的话，Response，swagger不展示T的文档说明。
swagger ui 页面地下出现error解决办法
热爱我的热爱
01-26 8354
关闭远程验证就好了，如图，在index.html中加入这一行就ok
使用 Swagger UI 与 Swashbuckle 创建 RESTful Web API 帮助文件
weixin_33698823的博客
04-14 196
作者：Sreekanth Mothukuru 2016年2月18日 本文旨在介绍如何使用常用的 Swagger 和 Swashbuckle 框架创建描述 Restful API 的交互界面，并为 API 用户提供丰富的探索、文件和操作体验。 源代码: 下载 SwaggerUi_2.zip 步骤 在本文中，我们将在 Asp.Net 创建一个简单的 Res...
swagger开启身份认证
04-08
### swagger开启身份认证 在现代Web开发中，API文档自动生成工具如Swagger变得越来越重要，它们不仅能够提高开发效率，还能够帮助团队更好地管理和维护API接口。然而，随着API暴露给外部用户，安全问题也日益突出。...
swagger swagger swagger
07-31
swagger swagger swagger
Swagger转JMeter脚本工具
05-24
Swagger转JMeter脚本工具是一种高效实用的自动化测试解决方案，它能够帮助IT专业人士将基于Swagger定义的RESTful API接口快速转换成JMeter测试脚本。Swagger是一个流行的API设计框架，用于构建、文档化和测试RESTful...
swagger官方文档离线版
10-26
Swagger官方文档离线版是开发人员和团队在不依赖互联网连接的情况下查阅Swagger 2.0规范的重要资源。Swagger是一个流行的API开发工具，它基于OpenAPI Specification（以前称为Swagger specification），用于设计、...
Swagger使用指南
02-24
本文来自于csdn，本文主要介绍了swagger配置类里面,要配置自己的controller包路径以及如何使用swagger，希望对您的学习有所帮助。Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务...
C#.net core WebAPI 使用EF连接MySQL并使用swagger生成API文档
qq_33931256的博客
05-20 3864
- 基于Visual Studio 2019 - ASP.NET Core 3.0 1.新建项目 从图中可以看到，默认的项目文件中已经包含了 Controllers。其为控制器文件夹，用来进行业务编写的代码，我们基本上需要在这个文件中进行数据的传出与接收。相应的，我们还可以进行各个文件创建，进行层次区分，也可以建立单独的类项目，进行层次区分，如控制层，服务业务层，数据连接层，模型实体层。 另...
SpringBoot添加swagger2接口文档并添加全局Authorization参数
热门推荐
develop
02-14 2万+
依赖包 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.6.1</version> </dependency&gt
swagger2入参属性首字母大写问题
u012521396的博客
09-28 7959
springBoot + Swagger2 用ApiModelProperty注解的hidden属性隐藏对应字段不生效，并在swagger-ui页面显示“action” 原因：字段首字母大些导致，将首字母改成小些问题解决。  ...
自定义JSR validation及Swagger的一些坑
z28126308的专栏
08-31 8755
validation的一些细节问题（项目测试时发现）、如何自定义bean validation与个人使用Swagger2测试时遇到的一些坑
swagger看json格式的数据页打不开
liuyancainiao的博客
06-27 4605
因为我们内部用了api-gateway，需要把写好的接口都放到上边做监控和调用，所以需要导入，因为api-gateway支持swagger的json格式的导入，所以我们用ip+端口号+“/v2/docs”,结果发现打不开那个页面，后来经过查询解决发现是因为少了一些东西我们的swagger有分页，一个系统中不同模块接口被放到了不同的swagger页面上，也就是分组了，这个时候需要ip+端口号+“/v...
springboot整合swagger打不开ui页面、打开访问页面控制台报错问题
魑魅魍魉
09-10 7596
Illegal DefaultValue null for parameter type number java.lang.NumberFormatException: empty String 如果控制台报这个错是因为实体类属性注解的example示例值没有填，Integer类型的属性必须填示例值，如果不填或者不写此属性，他会自动把一个空字符串转换Integer类型，故报错。 这个问题百度...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值