两层请求体设计

两层请求体指的是请求参数是两层的json，接收参数的时候同样需要两层的实体来接收。

本文定义了一个通用接收类，再传入二层实体，就可以直接使用去接收两层的json传参。

ThirdPartyCommReq

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * @author 曳戈泰尔
 * @version 1.0
 * @description 第三方服务gate 公共请求参数
 * @date 2023/5/17 12:46 PM
 */
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
@ApiModel(value = "ThirdPartyCommReq", description = "第三方服务gate共请求参数")
public class ThirdPartyCommReq<T> {

    @ApiModelProperty(value = "应用ID", required = true)
    private String appId;

    @ApiModelProperty(value = "请求时间戳")
    private Long timeStamp;

    @ApiModelProperty(value = "签名字符串", required = true)
    private String sign;

    @ApiModelProperty(value = "通知地址")
    private String notifyUrl;

    @ApiModelProperty(value = "请求参数的集合", required = true)
    private T bizContent;
}

QueryResultReq

import io.swagger.annotations.ApiModel;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import lombok.experimental.Accessors;

import javax.validation.constraints.NotBlank;

/**
 * @author 曳戈泰尔
 * @version 1.0
 * @description 查询结果请求
 * @date 2023/7/12 2:27 PM
 */
@ApiModel(value = "QueryResultReq", description = "查询结果请求")
public class QueryResultReq extends ThirdPartyCommReq<QueryResultParam> {}

@Data
@Accessors(chain = true)
class QueryResultParam {

    @Schema(description = "回调序列号", required = true)
    @NotBlank(message = "回调序列号不能为空")
    private String callNumber;
}