在为springdoc OpenAPI v3 api-docs生成输出时,任何细微的更改都会导致在生成的v3 api文档中产生完全不同的顺序。
保持这个顺序的可预测性是很方便的,特别是在使用.yaml
输出进行调试时。出于这个原因,如果有人知道如何订购这个,我将不胜感激。
发布于 2020-08-02 14:01:15
springdoc-openapi是基于io.swagger.v3.oas.models.OpenAPI对象的。
路径元素的类型为LinkedHashMap,并且在使用此类型时会保留顺序。如果您使用@Parameters
注解或@Operation
注解以特定顺序声明所有参数,则该顺序将被保留。
在swagger-ui端也有一些属性。例如:
springdoc.swagger-ui.operationsSorter=method
springdoc.swagger-ui.tagsSorter=alpha
对于调试/测试/比较结果,可以使用JSONAssert库进行比较。
最后,您可以使用OpenAPICustomiser对OpenAPI对象的所有元素进行排序。
https://stackoverflow.com/questions/62874587
复制相似问题