swagger相关问题
swagger版本为:
<dependency><groupId>com.github.xiaoymin</groupId><artifactId>swagger-bootstrap-ui</artifactId><version>1.9.6</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>2.9.2</version>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>2.9.2</version>
</dependency>
swagger的doc.html页面不显示接口信息
出现原因:由于在String类型字段上,使用ApiModelProperty注解时example写入数据为特殊格式,例如:“{json}”
,导致swagger前端ui奔溃
@ApiModelProperty(value = "test",example = "{json}")
private String test;
解决办法:将大括号去掉即可,example中尽量不要添加类似大括号等特殊字符!
报警告日志
日志信息为:
[WARN] [http-nio-8018-exec-4] io.swagger.models.parameters.AbstractSerializableParameter 421 - Illegal DefaultValue null for parameter type integer java.lang.NumberFormatException: For input string: ""
出现原因:
ApiParam注解用于Integer类型时需要加example,且写入值必须是int类型
@ApiParam(value = "任务id",example = "1") @NotNull @RequestParam Integer id