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

Question

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

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

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

1) 如果我们可以删除 "string" 作为值并将 null 或 "" 设置为默认值？ 2) 如果我们可以读取自定义对象并将所有值重置为 null，它会找到 "string"?

有什么办法吗？

Answer 1

你可以使用

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

再举一个swagger的例子-ui.

对于 "" 你可以这样做（是的，这是 space）：

@Schema(example = " ")

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

Springdoc-openapi - Is there any way to override default value as null or empty in the POST request?

springdoc

springdoc-openui

springdoc-openapi-ui