Enums 使用可重用枚举时创建文档的问题
使用可重用枚举时创建文档的问题 我的yaml文件看起来像这样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"
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附加图像
请添加更多细节以供参考,因为上面提到的对我来说很好