oas在属性上忽略@schema（必需= false），如果标记为@notnull

Question

我的模型具有我不需要的字段的模型：

import io.swagger.v3.oas.annotations.media.Schema;

import javax.validation.constraints.NotNull;

public class Model {
    @NotNull
    @Schema(required = false)
    private String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

但是SpringDoc自动形式将其标记为需要（我知道这是@notnull注释的原因），

 "schemas": {
      "Model": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },

因此我如何在生成的文档中不需要字段并留下两个注释，我的意思是@notnull和@schema？

使用的依赖性：

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

Answer 1

您可以使用parametercustomizer覆盖@notnull这样的注释：

@Component
public class ParameterCustomizer implements org.springdoc.core.customizers.ParameterCustomizer {

    @Override
    public Parameter customize(Parameter parameterModel, java.lang.reflect.Parameter parameter, HandlerMethod handlerMethod) {
        NotNull annotation = parameter.getAnnotation(NotNull.class);
        if (annotation != null) {
            parameterModel.required(false);
        }
        return parameterModel;
    }
}