swagger2关于@ApiModelProperty标签的坑

首先上一段代码

@ApiModel(description = "教师信息")
@Data
public class TeacherPojo{
    @ApiModelProperty(value = "教师ID",required=true)
    private String tId;
    @ApiModelProperty(value = "教师姓名",required=true)
    private String teacherName;
    @ApiModelProperty(value = "教师年龄",required=true)
    private String Age;
}

看着是没什么问题(除了一些命名不规范)
接着在swagger-ui界面你会发现
swagger2关于@ApiModelProperty标签的坑_第1张图片
很明显这四处有问题,

问题所在
实体类属性需要遵循驼峰命名规则,如Age属性则不是,这个可以理解;
但是tId明显是小驼峰命名,怎么也有问题,难道swagger2中第二个字母
也不能够大写?结果测试了下还真是(偷点懒都不行 我靠,还是老老实实写成teacherId)

所以实体类还是得这样

@ApiModel(description = "教师信息")
@Data
public class TeacherPojo{
    @ApiModelProperty(value = "教师ID",required=true)
    private String teacherId;
    @ApiModelProperty(value = "教师姓名",required=true)
    private String teacherName;
    @ApiModelProperty(value = "教师年龄",required=true)
    private String age;
}

你可能感兴趣的:(swagger)