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

Question

我想整理我的 Schemas为我的实体类生成，DTO 类位于 Springdoc ui .
我可以对 tags 进行排序和 operations通过以下配置 yml文件，但我的模式不是按排序顺序排列的。

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 项目上记录功能请求。