Swagger字段属性说明不显示

楔子

学习记录笔记。Swagger字段属性说明不显示问题

问题

返回单个bean就显示 字段说明
返回 map 就不显示字段说明

解决

返回字段使用泛型 ，并且返回方法 返回泛型
例如controller 方法

@GetMapping("localpermapList")
@ApiOperation("localswagger测试MapList")
public R<List<Person>> personrDataList() {
    ArrayList<Person> list = new ArrayList<>();
    for (int i = 0; i < 10; i++) {
        list.add(new Person().setAge(i).setName("测试" + 1).setBirthday(new Date()));

    }
    return R.ok().result(list)
            .data("name", "测试")
            .dataBean("dataBean", list);
}


@GetMapping("localpermapList")
@ApiOperation("localswagger测试MapList")
public R<Person> personrData() {
    
        Person p= new Person().setAge(i).setName("测试" ); 
    return R.ok().result(p)
            .data("name", "测试")
            .dataBean("dataBean", p);
}

详见 com.study.web.RedisController
码云位置 https://gitee.com/demo51/spredis