swagger3.0 问题记录及解决

swagger升级到3.0了,看似比较方便,但其实有很多坑啊!首先就是排序问题

属性排序

升级到3.0后,ApiModelProperty的position 属性失效了!这就很坑啊!谁给你们的自信去掉这个排序的,哪有人会照着首字母排序的!我也是醉了!

@ApiModelProperty(position = 1)

属性为List时,只显示一个元素

我也是醉了,咱弄了一个list,肯定是要放多个元素啊,不然我直接放个对象就号了,为什么要放一个list呢!

然后这个直接固定写死一个List[0],也没有地方添加,还不如旧的可以直接点一下放到输入框,给一个格式手动操作,我还觉得更好一点!

@ApiOperation(value = "习题数据补录", notes = "补充一些漏掉的习题", response = VideoPo.class)
@GetMapping("/dataCollection")
public Result dataCollection(@RequestBody ExerciseBo exerciseBo){

    return Result.succ(exerciseService.dataCollection(exerciseBo),"插入成功,data为生成的习题id,请前往答案接口,补充答案");

}

无意中解决了这个问题,我给我的对象加了@RequestBody注解以后,他就转换为一个输入的大文本框,这样我的数组就可以手动写多个了!

在这里插入图片描述
但现在提交以后报了个错,

ypeError: Failed to execute 'fetch' on 'Window': Request with GET/HEAD method cannot have body.

我把@GetMapping改成了@PostMapping,然后就变成了无法解析字符串。

主要的问题是我封装了一个BO用来接收前端传过来的对象,必须要该有的字段都有,哪怕没有也得占个坑,不能直接去掉那个字段,不然就会解析失败!

接口排序

不只是属性排序失效了,接口的排序也是乱七八糟的,也就是我们controller里面一个个接口也按着首字母排序,就很乱很烦!

为什么以上只有问题,因为我还解决不了,我先用旧版本了,以后有时间再来解决!

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
Swagger 3.0 是一个用于构建、编写和管理 RESTful API 文档的工具。它提供了一种简单、易于理解和交互的方式来描述和测试 API,使开发者和客户端能够更好地了解和使用 API。Swagger 3.0 具有许多强大的功能,例如自动生成的 API 文档、交互式探索和调试界面、代码生成等等。 Swagger 3.0 的外网 Demo 可以是一个在线的展示页面,用于展示和测试一个特定的 RESTful API。在这个外网 Demo 中,用户可以看到该 API 的各个接口和其对应的请求参数、响应格式、请求方法等信息。同时,用户还可以在页面上进行接口的测试和调试,输入参数并查看对应的响应结果。 外网 Demo 的链接可以在 API 提供方的官方网站上找到。用户可以直接访问该链接,然后就可以开始使用 Swagger 3.0 的各项功能了。在 Demo 页面上,用户可以通过导航栏浏览 API 的各个接口,并查看每个接口的详细信息。用户还可以使用内置的测试界面进行请求参数的设置,并在发送请求后查看响应结果。 通过 Swagger 3.0 的外网 Demo,开发者和客户端可以更加直观地了解和使用 API。他们可以浏览 API 的各个接口,了解每个接口的功能和使用方法。同时,他们还可以通过 Demo 页面进行实际的测试和调试,验证 API 的正确性和稳定性。 总而言之,Swagger 3.0 的外网 Demo 是一个非常方便的工具,可以帮助开发者和客户端更好地了解和使用一个 RESTful API。它提供了简洁清晰的接口文档和交互式测试界面,使用户能够快速上手并使用 API。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值