如何使用代码优先的方法实现OpenApi/Swagger考虑Java验证注释？

Question

我看了很多，但找不到任何解决我的问题的方法：固定使用代码优先的方法，我想知道如何实现OpenApi（Swagger）将考虑验证注释，如@Min（）、@Max（）、@size（）、...在我的Java/Spring Boot应用程序中。每当我让生成到OpenApi留档时，这些注释就不会被考虑；它们根本不显示。

目前我尝试使用

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-ui</artifactId>
    <version>1.5.10</version>
</dependency>

我也尝试使用公共依赖项，但没有帮助。

豆子（尝试@Min（）和@Max，除了@size（））：

@Data
@SuperBuilder(setterPrefix = "with")
public class ResponseBody {
    @NotNull
    @Min(value = 3)
    @Max(44)
    @Size(min = 3, max = 44)
    private String referenceMessageId;
}

OpenApi bean:

@Bean
default OpenAPI customOpenApi() {
    return new OpenAPI()
        .info(new Info()
        .title("XXX")
        .version("1.0")
        .description("xxx"))
        .components(new Components()
            .addSchemas(ERROR_RESPONSE_SCHEMA_KEY, new io.swagger.v3.oas.models.media.Schema<>().type("object").$ref("#/components/schemas/ErrorResponseBody"))
            .addSchemas(VNB_RESPONSE_SCHEMA_KEY, new io.swagger.v3.oas.models.media.Schema<>().type("object").$ref("#/components/schemas/ResponseBody"))
            .addParameters(API_VERSION_HEADER_PARAMETER, new io.swagger.v3.oas.models.parameters.Parameter()
                .name(API_VERSION_HEADER_PARAMETER)
                .required(Boolean.TRUE)
                .allowEmptyValue(Boolean.FALSE)
                .description("yyy")
                .in("header")
                .schema(new io.swagger.v3.oas.models.media.Schema<String>()
                .type("string")
                .example("1.0.0")));

Answer 1

我发现在文档生成过程中不考虑@Min和@Max，但@Size（min = x，max = y）是。我认为如果Openapi实现能够考虑整个Spring验证注释的范围，那将是有益的。