Swagger POST 生成的参数正文覆盖

Question

我有一个示例对象，被 swagger 引用以在我的文档中创建一个 POST 端点。

然后我使用文档生成客户端进行测试。但是，API 的工作方式与直接呈现对象的方式略有不同。我想将文档中创建的模型的 POST 正文参数类型从服务类型覆盖为字符串（服务的引用字符串）。我在下面包含了引用的对象。

@Entity
public class ServiceType {

    private String id;
    private Service service;
    private String type;

    public Service getService() {
        return service;
    }

    public void setService(Service service) {
        this.service = service;
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }
}

正文生成为：

{
  "createdDate": "2019-03-12T15:18:22.568Z",
  "id": "string",
  "service": {
    "createdDate": "2019-03-12T15:18:22.568Z",
    "id": "string",
    "name": "string",
    "routingKey": "string",
    "updatedBy": "string",
    "updatedDate": "2019-03-12T15:18:22.569Z"
  },
  "type": "string",
  "updatedBy": "string",
  "updatedDate": "2019-03-12T15:18:22.569Z"
}

但我希望它采用以下格式：

{
  "createdDate": "2019-03-12T15:18:22.568Z",
  "id": "string",
  "service": "string",
  "type": "string",
  "updatedBy": "string",
  "updatedDate": "2019-03-12T15:18:22.569Z"
}

不确定这是否可能。感谢您的帮助。

Answer 1

您可以使用@ApiModel 和@ApiModelProperty 注释来覆盖字段的默认数据类型。请注意，数据类型必须是完全限定的类型名称（例如java.lang.String）。如需更多信息，请参阅Overriding Property Datatypes。

@Entity
@ApiModel
public class ServiceType {

    private String id;

    @ApiModelProperty(dataType = "java.lang.String")
    private Service service;
    private String type;

    public Service getService() {
        return service;
    }

    public void setService(Service service) {
        this.service = service;
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }
}