java - Swagger @ApiModelProperty 基于 HTTP 请求的灵活性

Question

我在 Pojo 的字段上使用 Swagger @ApiModelProperty 并使用 SpringFox 来自动生成文档。这是一个示例 pojo:

public class Pojo {
 @ApiModelProperty(value =" some id", hidden = true)
 private final String id;
}

我有一个接收 Pojo 的端点，该端点可以是/endpoint。该端点上有 PUT 和 POST 动词。有没有办法使用 Swagger Annotation 或 SpringFox Docket 配置在 POST 上隐藏文档中的字段“id”，但在 PUT 上让该字段显示在文档上。

我宁愿不必创建一个重复的 Pojo 类，这样我就可以注释要隐藏的字段。

Answer 1

我不认为这是直接可能的，但也许你可以通过其他方式解决它？这里有几个替代方案:

1. 创建两个 POJO，但其中一个使用 id 字段扩展另一个 POJO。
2. 对 POST 和 PUT 使用相同的 POJO，但以 @PathVariable 的形式将 id 字段添加到 PUT。