微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

如何在 SpringFox 生成的 Swagger 中将扩展值编写为未命名的属性?

如何解决如何在 SpringFox 生成的 Swagger 中将扩展值编写为未命名的属性?

我使用 my code 类中的 extensions 方法vendor extension添加一个名为 x-my-testApiInfo

new ApiInfoBuilder()
        ...
        .extensions(List.of(
         new ListvendorExtension<>("x-my-test",List.of("myvalue"))
         )).build();

生成yaml file属性 extensions显示此值,如下所示:

  ...     
  version: 1;2021-02-01
  extensions:
    x-my-test:
      - myvalue
  ...

我注意到,如果我将这个 yaml file 加载到 Swagger Editor 中,那么由于 extensions 属性,我会看到一个错误

Structural error at info
should NOT have additional properties
additionalProperty: extensions

是否可以在 extensions 属性之外写入 x-my-test 值?

并有这样的输出

  ...     
  version: 1;2021-02-01
  x-my-test:
    - myvalue
  ...

输出符合 swagger 规范,并且在 swagger 编辑器中成功加载。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。