Swagger/springfox自动生成响应示例

Question

目前正在使用springfox 2.9.2大摇大摆地记录Spring中创建的API。我想在文档中添加示例响应，如下图所示；

我的理解是，我可以做类似的事情：

@ApiResponses(value = {
    @ApiResponse(code = 200, message = "Success", 
            examples = @io.swagger.annotations.Example(
                value = {
                    @ExampleProperty(value = "{'snapshot'：{'type': 'AAA'}}", mediaType = "application/json") 
                }))

在本例中，我将此代码片段放在GET方法的正上方。不幸的是，上面的两个示例总是显示：标识符预期错误

但我也看到我也能做到这一点：

@ApiResponses(value = {
    ApiResponse(code = 200, message = "Success", response = MyModel.class,
    )
})

我还看到我可以添加一个@ApiOperation级别的示例：

@ApiOperation(value = "Create a Account", nickname = "createAccount", notes = "Create a account", response = AccountResponse.class, tags={  })

我的问题是：

>

将Swagger/Springfox指向my model/bean，让它自动生成示例响应，并随着bean/model的每次更新而自动更新，这将是一个理想的选择。这就是上面第二段代码应该做的吗？

Answer 1

为dto定义注释示例：

@ApiModel("Crop")
public class CropDto {

    @ApiModelProperty(name = "Unique guid", position = 1, example = "7aaee0e2-6884-4fd7-ba63-21d76723dce2")
    public UUID id;
    @ApiModelProperty(name = "Unique code", position = 2, example = "squ")
    public String code;
    @ApiModelProperty(name = "Unique name", position = 3, example = "Squash")
    public String name;
    @ApiModelProperty(position = 4, example = "Cucurbita pepo L.")
    public String description;
}