如何使用 Spring OpenAPI 3.0 忽略 Swagger 请求字段？答案

【问题标题】：How to ignore Swagger request fields using Spring OpenAPI 3.0?如何使用 Spring OpenAPI 3.0 忽略 Swagger 请求字段？
【发布时间】：2021-02-12 01:51:51
【问题描述】：

我们有以下 Token 架构，而 scmOrg 被定义为外键。

{
  id        integer($int64)
  scmOrg    ScmOrg{...}
  type      string
  rawToken  string
}

当打开 Swagger 控制台时，它会像这样构建示例输入：

{
  "id": 0,
  "scmOrg": {
    "id": 0,
    "scm": {
      "id": 0,
      "name": "string",
      "baseUrl": "string",
      "clientId": "string",
      "clientSecret": "string"
    },
    "name": "string",
    "team": "string"
  },
  "type": "string",
  "rawToken": "string"
}

只能为现有的 scmOrg 实体添加新令牌，所以我真正想要的是像这样更严格的东西：

{
  "id": 0,
  "scmOrg": {
    "id": 0
  },
  "type": "string",
  "rawToken": "string"
}

Swagger 可以吗？

【问题讨论】：

标签： spring swagger openapi springdoc-openapi-ui

【解决方案1】：

AFAIK 没有办法做到这一点。事实上你可以编辑你的模型来设置@ApiModelProperty(hidden = true)。但是，我反对这样做，此外，您在模型上所做的任何事情都将在下次重新生成时被覆盖。检查这个链接，它有点旧，但似乎 swagger 背后的人似乎在他们的路线图中没有这个。 https://community.smartbear.com/t5/Swagger-Open-Source-Tools/How-to-hide-Model-Information/m-p/183188#M347

【讨论】：