0

使用可重用枚举时创建文档的问题我的 yaml 文件如下所示

openapi: 3.0.2 components:   schemas:
    Countries:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - American Samoa
        - "\u00c5landIslands"
        - NotOtherwiseSpecified

，当我编译它时，它会正确创建 java 类，但是，不是创建文档，只是给了我：

国家 - 该特定方案仅显示任何内容。对于其他方案，显示枚举选项等。你能帮我解决这个问题吗？这是大摇大摆的问题还是我在某个地方弄错了。swagger 网站中的示例和我的代码遵循相同的规则：https ://swagger.io/docs/specification/data-models/enums/ 。我在这里也发布了类似的问题：https ://community.smartbear.com/t5/SwaggerHub/Issue-with-creating-a-documentation-when-using-re-usable-enums/mp/191938

PS我以为问题是由于特殊字符而出现的，但事实并非如此。我试过没有那个特定的枚举条目，而且我还有另一种类似的方式可重用枚举，它的行为方式相同。

4

1 回答 1

0

这对我来说很好。我附上了一个例子，以供参考我是如何做到的。

route.yaml 中的参数

      parameters:
        - name: Country
          in: query
          required: true
          schema:
            $ref: "#/components/schemas/test"

parameters.yaml 中的声明

components:
  schemas:
    test:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - "\u00c5landIslands"

从 Swagger UI 附加图像 在此处输入图像描述

请添加更多详细信息以供参考，如上所述对我来说效果很好。

于 2020-02-07T13:45:35.653 回答