按字母顺序订购SpringDoc操作参数

Question

从Springfox迁移-Springdoc

Springfox生成了一个OpenAPI定义，该定义以字母顺序排序所有参数，我已迁移到SpringDoc，但无法找到一种方法来保留参数的Springfox排序（Alpha），例如

，例如控制器：

getPerson(name, address, mobile)

SpringFox生成的OpenAPI定义：

getPersonService(address, mobile, name)

SpringDoc生成的OpenAPI定义：

getPersonService(name, address, mobile)

有属性可以订购生成的定义的其他方面，

springdoc.swagger-ui.operationsSorter=method
springdoc.swagger-ui.tagsSorter=alpha
springdoc.writer-with-order-by-keys: true

我找不到 ：属性要订购操作参数，是否有设置可以实现此目的？还是可以干净地实现： openapicustomiser或操作customizer

Answer 1

这是一种使用操作customizer（kotlin语法）的解决方案：

@Bean
fun parameterOrderCustomizer(): OperationCustomizer {
    return OperationCustomizer { operation, _ ->
        operation.apply {
            parameters = parameters?.sortedBy { it.name }
        }
    }
}

如果您使用分组API，请不要忘记还可以通过.addoperationCustomizer（parameterOrderCustomizer（））添加它们

Answer 2

更新您的application.property文件：

springdoc.writer-with-order-by-keys=true

或在application.yaml文件

springdoc
 writer-with-order-by-keys: true

路径，架构和属性上排序字母上的升序完美地很好地排序