SwaggerBootstrapUi使用大坑-不显示注释
今天写一个接口的时候发现一个奇葩的问题,就是swagger不显示注释的问题,网上百度了很多也没有解决,发现一个SwaggerBootstrapUi的小bug.
先看下我的返回数据封装,有做强泛型指定:
controller层
@GetMapping("info/{skuId}")
@ApiOperation(value = "获取商品详情", notes = "获取商品详情")
@EncryptResponse
public Result<ProductVO> ProductInfo(@PathVariable("skuId") Long skuId){
if(skuId == null){throw new MyException("商品ID不能为空");}
ProductVO productVO = productService.productInfo(skuId);
return new Result<ProductVO>().ok(productVO);
}
productVO实体
@Data
@ApiModel(value = "颜色信息")
public class ProductColorVO implements Serializable {
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "颜色ID")
private Long cId;
@ApiModelProperty(value = "颜色")
private String cName;
@ApiModelProperty(value = "尺寸信息")
private List<ProductSizeVO> sizeList;
}
swagger死活不显示注释说明
翻了很多文档,也没发现有啥问题,我丢,最后发现不对劲,我代码里明明是cId,cName,怎么显示出来就变成了cid,cname;于是我把代码字段改了,全用小写发现显示正常!!!!!