Swagger：当dto被隐式覆盖到实体时，如何记录REST输入参数？

Question

存在一个问题，当我们将Jersey2资源用于dto隐式使用时。

示例：

@POST
@ApiOperation(value = "Create pet", response = PetDTO.class)
public Pet create(Pet pet) throws IOException {
    return this.petService.save(pet);
}

在此示例中，我们隐式地将petDto作为参数，然后将其映射到实体。

问题是，如何配置摇摇欲以将PetDTO记录为api参数而不是Pet的方法？

Answer 1

可以通过以下方式完成：

@POST
@ApiOperation(value = "Create pet", response = PetDTO.class)
@ApiImplicitParams({
        @ApiImplicitParam(name = "Pet dto",
        value = "pet", required = true,
        dataType = "com.example.PetDTO", paramType = "body")
})

public Pet create(@ApiParam(hidden = true) Pet pet) throws IOException {
}