如何在 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 (将#修改为@)