Springdoc-openapi - 有没有办法在 POST 请求中将默认值覆盖为 null 或空？

Question

我正在使用 Spring Boot 和 Open API 3。通过 OAS2 Swagger，当我发出 POST 请求时，我看到所有字符串字段都将作为 Spring 的默认值，并且我没有找到删除它的方法，无论是通过SpringDoc 开放 UI 也不通过代码。

{
  "firstName": "string",
  "lastName": "string",
  "age": 0,
  "email": "string",
  "address1": "string",
  "address2": "string",
  "address3": "string",
  "telephone" : "0",
  "department" : "string",
  .....
}

这里消费者不愿意在发出请求时从字段中删除字符串。有什么办法吗

1. 是否可以删除“string”作为值并将 null 或“”设置为默认值？
2. 如果我们可以读取自定义对象并将找到“字符串”的所有值重置为 null，有什么办法吗？

Answer 1

你可以使用

@Schema(example = "<your example here>")

为 swagger-ui 提供另一个示例。

对于 "" 你可以这样做(是的，它是一个空格):

@Schema(example = " ")