Swagger UI-可空值

Question

我们有一个SpringBoot（版本1.5.12)REST Api，带有springfox-swagger2和springfox-swagger-ui（版本2.9.2)

是否可以在Swagger UI中拥有可空属性（使用Swagger.yaml配置文件或Swagger注释）？

{ 
  id: 2
  name: 'test'
  surname: null
}

姓氏应该是字符串或null（默认为null）。
如果不可能，我们是否可以重写一些swagger类来获得此行为？

谢谢

Answer 1

是的，可以有可空/可选的属性。为此，将@apimodelproperty(io.swager.annotations)注释中的required属性设置为false（默认情况下实际上是false）。

@ApiModelProperty(required = false, value = "Surname")
private String surname;