SpringQueryMap的使用方式

前言
@SpringQueryMap是微服务之间调用，使用openfeign通过get请求方式来处理 多入参（也就是通过实体来传参） 情况的注解，多用于restful风格方式

作用：@SpringQueryMap，简单来说就是将实体转化为表单数据，比如

{
	"username" : "zhangsan",
	"passwd" : "******"
}

通过@SpringQueryMap标注之后呢，会变成这样子
url?username=zhangsan&passwd=******
注意：被@SpringQueryMap注解的对象只能有一个。因为不能保证多个对象中是否会存在相同的属性名，这是值得注意的一点。

1. 单实体入参数

feign调用方

@GetMapping(value = "/xx/xxxx")
ApiResponse<SysUserQueryResponse> query(@SpringQueryMap SysUserQueryRequest queryRequest);

被调用方

@GetMapping
@Operation(summary = "查询 用户")
public ApiResponse<SysUserQueryResponse> query(SysUserQueryRequest queryRequest) {
    return ApiResponse.ok(sysUserReadModelRepo.query(queryRequest));
}

2. 多实体入参数

错误的方式：
以下这两种方式都是错误的，都是只能生效一个实体的传参数
feign调用方

@GetMapping(value = "/xx/xxxx")
ApiPageResponse<SysUserQueryResponse> query(@RequestParam Pagination pagination, @SpringQueryMap SysUserQueryRequest queryRequest);

@GetMapping(value = "/xx/xxxx")
ApiPageResponse<SysUserQueryResponse> query(@SpringQueryMap Pagination pagination, @SpringQueryMap SysUserQueryRequest queryRequest);

正确的方式：
根据上面的结论，可知只会生效一个实体的传参，其原因是因为get方式只能是表单提交的，不能通过body传输，如果这两个实体存在相同的属性，就会出现问题，所以就默认不会取第二个实体来传参数。

解决方法也很简单，将这两个实体都转为map，放到一个map中即可，再次提醒这两个实体中不能存在相同的属性名，否则出现参数覆盖情况

feign调用方

## 实体转map，使用阿里巴巴库的JSON类
Map<String, Object> param = JSON.parseObject(JSON.toJSONString(Pagination), Map.class);
Map<String, Object> param1 = JSON.parseObject(JSON.toJSONString(SysUserQueryRequest), Map.class);
param.addAll(param1);

## 以param作为参数传递
@GetMapping(value = "/xx/xxxx")
ApiPageResponse<SysUserQueryResponse> query(@SpringQueryMap Map<String, Object> param);

被调用方，无需用map接收，可以随意对象，只需要对应上属性名和类型即可

@GetMapping
@Operation(summary = "分页查询 用户")
public ApiPageResponse<SysUserQueryResponse> query(Pagination pagination, @Valid SysUserQueryRequest queryRequest) {
    return ApiPageResponse.ok(pagination, sysUserReadModelRepo.query(pagination, queryRequest));
}