Spring / Swagger-UI - 当用户单击“试用”按钮时，在请求模型中显示实际值的示例

Question

如何让 swagger-ui 在下面的示例框中显示预填充的实际值？ （当用户点击 swagger-ui 中的“试用”按钮时显示的请求模型框。

我正在使用 SpringBoot/Java，我希望它显示一些实际值而不是数据类型。默认情况下，它会为 DOB 字段执行此操作。

我将MyModel 定义如下，我希望在ApiModelProperty 中使用“value”会设置这些值，但事实并非如此：

@ApiModel(description="blahblah")
public class MyModel {
    @ApiModelProperty(notes = "some notes", name = "name", required = true, value = "Bot")
    private String name;
  
    @ApiModelProperty(notes = "Date of birth", name = "dob", required = true)
    private OffsetDateTime dob;
  
    @ApiModelProperty(notes="How old", name = "age", required = true, value = "31")
    private Integer age;
  ...
}

我希望上面看起来像：

Answer 1

使用example:

@ApiModelProperty(notes = "some notes", name = "name", required = true, example = "Bot")
private String name;