knife4j中响应参数实现嵌套展示

前言

    后端接口现在使用的是knife4j,会遇到返回参数中嵌套显示的需求,但是会出现参数显示不全的问题,处理的办法是响应参数使用泛型处理，下面结合具体的场景说一下如何处理不显示问题.

场景说明一(两级嵌套)

    pageInfo中list显示数据
使用pageHelper插件分页查询时返回的分页信息为pageInfo,固定显示的内容如下:

所有的业务查询数据都会放到list中显示.现在有会员销课记录查询需求,要求按照分页进行查询.接口文档使用knife4j进行展示,使用pageHelper进行分页查询处理.最终返回的数据格式如下：

相关代码如下:
控制层代码：

    @ApiOperation("销课记录列表查询")
    public ResultVo<PageInfo<SignCourseRecord>> findSignCourseRecordList(SignCourseQueryDto signCourseQueryDto)  {
        PageInfo<SignCourseRecord> signCourseRecordList = financeService.findSignCourseRecordList(signCourseQueryDto);
        return ResultVoUtil.success(signCourseRecordList);
    }

响应参数:

@ApiModel("签到记录信息")
@Data
public class SignCourseRecord  {

    private Long courseRecordId;

    private String staffName;
    
  // 省略其他属性。。。。。。
    }

场景说明二（三级嵌套）

    现在需要查询售卡分页类表信息，同时要返回总数量以及总回款信息。相当于三级嵌套，实现效果如下：

相关代码：
控制层：

public ResultVo<SaleCardInfoVo<PageInfo<SaleStaffCardVo>>> findSaleStaffCardVos(SaleCardDto saleCardDto)  {
        SaleCardInfoVo   saleStaffCardVos = financeService.findSaleStaffCardVos(saleCardDto);
        return ResultVoUtil.success(saleStaffCardVos);
    }

响应实体类：

@ApiModel("售卡统计信息")
public class SaleCardInfoVo<SaleStaffCardVo> implements Serializable {
    private static final long serialVersionUID = -6767885414660070855L;

 
    @ApiModelProperty(value = "总售卡数",example = "3",dataType = "long")
    private long totalCount;

  
    @ApiModelProperty(value = "回款总金额",example = "25.56",dataType = "BigDecimal")
    private BigDecimal totalIncomePrice=BigDecimal.ZERO;

   
    @ApiModelProperty(value = "未总收款金额",example = "25.56",dataType = "BigDecimal")
    private BigDecimal totalUnIncomePrice;

  
    @ApiModelProperty(value = "总应收金额",example = "25.56",dataType = "BigDecimal",hidden = true)
    private BigDecimal totalRealPrice=BigDecimal.ZERO;

    @ApiModelProperty(value = "售卡分页数据")
    private PageInfo<com.kawaxiaoyu.manage.management.api.brandFinance.vo.SaleStaffCardVo> saleStaffCardVos;}
    // 省略get/set

@ApiModel(value = "售卡统计信息")
public class SaleStaffCardVo implements Serializable {
    private static final long serialVersionUID = -2298163108908959992L;


    @ApiModelProperty(value = "会员卡卡号",example = "2522",dataType = "String")
    private String cardNo;

    @ApiModelProperty(value = "会员姓名",example = "小白",dataType = "String")
    private String staffName;

 // 省略相关属性

封装统一响应信息:

@Data
@Builder
@Accessors(chain = true)
@ApiModel("响应参数")
public class ResultVo<T> implements Serializable {

    private static final long serialVersionUID = -8054007511410819665L;

    @ApiModelProperty(value = "响应状态码",example = "1",dataType = "Integer")
    private int code;

    // 是否成功标识.true表示成功,false表示失败
    @ApiModelProperty("success标识,true表示成功,false表示失败")
    private boolean success;

    // 操作成功时需要响应给客户端的响应数据
    @ApiModelProperty("响应信息")
    private String msg;

    
    @ApiModelProperty("响应数据")
    private T data;

    @ApiModelProperty("当前时间")
    @JSONField(format = "yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8")
    private Date time;

    以上是处理多级嵌套部分数据不显示问题的处理方案，希望对有相同需求的同学有所帮助！
    参考链接：官方接口文档：https://doc.xiaominfo.com