Spring WebFlux OpenAPI-覆盖模型/模式字段名称

Question

我正在使用Spring Boot网络流量r2dbc来实现REST应用编程接口服务器。

为模型生成的模式正在复制具有不同定义（名称、限制等）的同一字段。

我的模型：

data class Extension(

    @Column("number")
    @JsonProperty("number", required = true)
    @Pattern(regexp = "^[0-9]{6,}\$")
    @Schema(description = "The number", example = "12345007100")
    val number: String,

    @Column("tenant_id")
    @JsonProperty("tenant_id", required = true)
    @Pattern(regexp = "^[0-9]{5}\$")
    @Schema(name = "tenant_id", description = "The ID of the Tenant", example = "12345")
    val tenantId: String,
)

路由器

@Bean
fun extensionsRoutes(): RouterFunction<ServerResponse> {
    return SpringdocRouteBuilder.route()
     .GET(
            path("/extensions").and(accept(MediaType.APPLICATION_JSON)),
            handler::getAll
        ) { ops ->
            ops
                .tag(tag)
                .operationId("operation id")
                .summary("summary")
                .description("description")
                .response(
                    responseBuilder()
                        .responseCode("200")
                        .description("The list of all Extensions")
                        .implementationArray(Extension::class.java)
                )
        }

为扩展模型生成的OpenAPI模式

Extension:
    required:
    - number
    type: object
    properties:
      number:
        pattern: "^[0-9]{6,}$"
        type: string
        description: The number
        example: "12345007100"
      tenant_id:
        pattern: "^[0-9]{5}$"
        type: string
        description: The ID of the Tenant to which the Extension belongs
        writeOnly: true
        example: "12345"
      tenantId:
        type: string

我有两个字段：tenant_id和tenantId，但这在模型中是同一个字段。还要注意，tenantId的定义忽略了模式属性（如required和pattern属性）。

我遗漏了一些注释？似乎我缺少了一些注释来指示springdoc库中的字段已经在定义中。

Answer 1

终于发现了问题。我正在使用kotlin，我们需要添加以下依赖项：

<dependency>
   <groupId>org.springdoc</groupId>
   <artifactId>springdoc-openapi-kotlin</artifactId>
   <version>1.5.8</version>
</dependency>

这在https://www.baeldung.com/spring-rest-openapi-documentation有很好的记录，但我错过了。