Enums 使用可重用枚举时创建文档的问题

Enums 使用可重用枚举时创建文档的问题,enums,yaml,swagger,swagger-3.0,Enums,Yaml,Swagger,Swagger 3.0,使用可重用枚举时创建文档的问题 我的yaml文件看起来像这样 openapi: 3.0.2 components: schemas: Countries: type: string enum: - Unknown - Afghanistan - Albania - Algeria - American Samoa - "\u00c5landIslands"

使用可重用枚举时创建文档的问题 我的yaml文件看起来像这样

openapi: 3.0.2 components:   schemas:
    Countries:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - American Samoa
        - "\u00c5landIslands"
        - NotOtherwiseSpecified
,当我编译时,它正确地创建了java类,但是,它并没有创建文档,只是给了我:

国家- 对于特定的方案,没有显示更多内容。对于其他方案,将显示枚举选项等。 你能帮我解决这个问题吗?这是一个夸夸其谈的问题,还是我弄错了。swagger网站中的示例和我的代码遵循相同的规则:。 我也在这里发布了类似的问题:


另外,我认为问题的出现是因为这个特殊的角色,但事实并非如此。我尝试不使用那个特定的枚举条目,而且我还有另一种类似的方法,即行为相同的可重用枚举。

这对我来说很好。我附上一个例子,作为我如何做的参考

路由中的参数。yaml

      parameters:
        - name: Country
          in: query
          required: true
          schema:
            $ref: "#/components/schemas/test"
components:
  schemas:
    test:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - "\u00c5landIslands"
参数中的声明。yaml

      parameters:
        - name: Country
          in: query
          required: true
          schema:
            $ref: "#/components/schemas/test"
components:
  schemas:
    test:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - "\u00c5landIslands"
从Swagger UI附加图像

请添加更多细节以供参考,因为上面提到的对我来说很好