因为业务需要,一个查询接口,需要给前端返回二个列表对象数据,用map返回,发现swagger没有各个字段的中文注释,最简单方式还是封装一个组合实体类,将需要返回前端的数据都封装在里面即可!最后将该实体类再controller层定义好实际返回泛型即可!
自定义的组合类,记得定义泛型哦!不然中文注释无法显示
控制层这里要定义好返回值泛型
最后swagger的返回参数字段中文注释就完美显示出来了哦!
因为业务需要,一个查询接口,需要给前端返回二个列表对象数据,用map返回,发现swagger没有各个字段的中文注释,最简单方式还是封装一个组合实体类,将需要返回前端的数据都封装在里面即可!最后将该实体类再controller层定义好实际返回泛型即可!
自定义的组合类,记得定义泛型哦!不然中文注释无法显示
控制层这里要定义好返回值泛型
最后swagger的返回参数字段中文注释就完美显示出来了哦!
相关文章: