swagger-ui - 如何在 Swagger-ui SpringDoc open ui 上对 Schemas 进行排序

Question

我想对我Schemas为我的实体类生成的 DTO 类进行排序Springdoc ui。
我可以通过文件中的以下配置对tagsand进行排序，但我的模式未按排序顺序。operationsyml

springdoc:
  swagger-ui:
    disable-swagger-default-url: true
    tags-sorter: alpha
    operations-sorter: alpha
    doc-expansion: none

我怎么能对我的模式进行排序。
谢谢。

Answer 1

您可以使用 OpenApiCustomiser 完全控制模式顺序。这是您可以使用 Comparator 自定义的示例代码，具体取决于您想要的排序逻辑：

@Bean
public OpenApiCustomiser sortSchemasAlphabetically() {
    return openApi -> {
        Map<String, Schema> schemas = openApi.getComponents().getSchemas();
        openApi.getComponents().setSchemas(new TreeMap<>(schemas));
    };
}

如果您对 swagger-ui 上的排序感兴趣，而不是在服务器端，那么您可以在 swagger-ui 项目上记录功能请求。