这篇文章是我在做业务架构中遇到到问题及解决方案，整理如下：

问题

1、业务系统混搭（net core ，Java）旧的系统api QueryString 参数不区分大小写，现转为调用Java系统API，需要区分大小写

2、URL参数太多业务实用需要绑定到POJO对象，且需要支持参数验证

方案

业务应用中QueryString参数值获取方式有：

1. @RequestParam
2. @ModelAttribute
3. @BindRestParameterSimpleModel即自定义实现QueryString参数转换为业务POJO

第1，2两种方式对于QueryString参数大小写敏感，适用于调用方严格遵守约定。如果api处于过度阶段，则可能会因为参数大小写问题导致业务执行失败，典型场景是：

NET API转化为Spring API，NET API Query String是忽略大小写的，但是Spring API对参数大小写敏感的，如果API调用方传递了未遵守API约定的参数格式，则会导致调用失败，所以BindRestParameterSimpleModel解决其参数名大小写，简化绑定参数业务代码。

且先看看以上三种获取QueryString参数的代码：

/**
**BindRestParameterSimpleModel 自定义绑定QueryString参数且忽略大小写，支持参数验证
*/
@GetMapping(value = "/query")
public ResourceResponse<QueryStringDto> queryStringParse(
@BindRestParameterSimpleModel 
@Valid                                                               
QueryStringDto queryStringDto
, Errors errors) {
    ParameterAssertUtil.assertRequestFristValidated(errors);
    return ResourceResponse.ok(ObjectCopyUtils.copy(queryStringDto, QueryStringDto.class));
}

/**
**ModelAttribute spring boot 提供的API绑定参数但是区分参数名大小写
*/
@GetMapping(value = "/query2")
public ResourceResponse<QueryStringDto> queryStringParse2(
@ModelAttribute 
@Valid                                                                 
QueryStringDto queryStringDto
    , Errors errors) {
    ParameterAssertUtil.assertRequestFristValidated(errors);
    return ResourceResponse.ok(ObjectCopyUtils.copy(queryStringDto, QueryStringDto.class));
}

/**
**RequestParam spring boot提供的AI需要枚举URL参数列表且区分参数名大小写
*/
@GetMapping(value = "/query3")
public ResourceResponse<QueryStringDto> queryStringParse3(
@RequestParam                                                           
@NotEmpty(message = "uuId can't null")                                                          
String uuId,                                                             
@RequestParam                                                            
@NotNull(message = "class id can't null")                                                          
Integer classId,                                                            
@RequestParam                                                             
@NotNull(message = "users can't null")                                                            
Collection<String> users) {
    QueryStringDto queryStringDto = new QueryStringDto();
    queryStringDto.setClassId(classId);
    queryStringDto.setUuId(uuId);
    queryStringDto.setUsers(users);
    return ResourceResponse.ok(queryStringDto);
}

可以看出这三种获取QueryString参数使用都较为简单，其中@RequestParam我习惯于在QueryString参数少于等于3时使用，参数太多使用@RequestParam时代码很不优雅，@ModelAttribute使用较少，@BindRestParameterSimpleModel即自定义参数绑定，特性如下：

1. 忽略参数名大小写
2. 支持自定义解析参数（特别是日期类型的参数）
3. 支持参数校验

实现BindRestParameterSimpleModel功能，需要做以下工作：

1. 定义BindRestParameterSimpleModel注解
2. 实现HandlerMethodArgumentResolver
3. 注入解析程序
4. 实现参数解析为POJO程序

实现

HandlerMethodArgumentResolver接口实现核心代码如下：

@Override
public Object resolveArgument(MethodParameter parameter
        , ModelAndViewContainer mavContainer
        , NativeWebRequest webRequest
        , WebDataBinderFactory binderFactory) throws Exception {
    HttpServletRequest request = (HttpServletRequest) 
    webRequest.getNativeRequest();
    //custom parse query string parameter to pojo
    Object obj = 
    ParameterMapUtil.mapToPojo(request.getParameterMap(), 
    parameter.getParameterType());
    //if bind failed then use default instance
    if (obj == null) {
        obj = parameter.getParameterType().newInstance();
    }
    String name = ModelFactory.getNameForParameter(parameter);
    //Object attribute = (mavContainer.containsAttribute(name) ? mavContainer.getModel().get(name) :
    //        BeanUtils.instantiateClass(parameter.getParameterType()));
    WebDataBinder binder = binderFactory.createBinder(webRequest, obj, name);
    if (binder.getTarget() != null) {
        //execute model verified
        validateIfApplicable(binder, parameter);
        if (binder.getBindingResult().hasErrors() && isBindExceptionRequired(binder, parameter)) {
            //ignore exception,ie：updateShareGroup(@RequestBody @Valid UpdateShareGroupReq req, Errors errors)
            //throw new BindException(binder.getBindingResult());
        }
    }
    // Add resolved attribute and BindingResult at the end of the model
    Map<String, Object> bindingResultModel = binder.getBindingResult().getModel();
    mavContainer.removeAttributes(bindingResultModel);
    mavContainer.addAllAttributes(bindingResultModel);
    return obj;
}

该解析程序BindRestParameterSimpleModelResolver主要实现，以下工作

1. 调用ParameterMapUtil.mapToPojo即转换QuerString参数为POJO
2. 调用实体验证程序

测试

测试case分别是参数合法，参数缺失，参数大小写。

http://localhost:8080/v1/query?classId=1122&uuID=33&users=3444&users=455

http://localhost:8080/v1/query?classId=1122&uuId=&users=3444&users=455

http://localhost:8080/v1/query?classid=1122&UUID=33&users=3444&users=455

均返回预期结果，通过自定义实体绑定，可以简化controller代码，满足参数名不区分大小写

资源

https://github.com/hummer-team/hummer-framework/blob/master/hummer-rest/src/main/java/com/hummer/rest/resolver/BindRestParameterSimpleModelResolver.java

注：这是我自己整合的spring boot框架，做了些“胶水”代码，在公司内部所有Java项目应用