SpringBoot2.x系列教程22--整合SpringMVC之处理请求参数的绑定(四)ConfigurableWebBindingInitializer

前言

在上一章节中，壹哥 给大家讲解了WebBindingInitializer的作用，并实现了全局的参数类型转换。接下来在本章节中，我会继续带领大家学习一个新的API，那就是ConfigurableWebBindingInitializer，这个的用法要比之前的WebDataBinder更简化一下。所以我们可以利用ConfigurableWebBindingInitializer来替换WebDataBinder实现相同的功能，毕竟有简单的谁也不想用太复杂的。

一. ConfigurableWebBindingInitializer简介

1. 概述

在Spring MVC中可以使用WebBindingInitializer，为每个特殊的请求初始化相应的WebDataBinder，从而进行请求参数的转换与绑定。

而在SpringBoot中，则可以通过配置ConfigurableWebBindingInitializer这样的类来进行数据绑定和转换。

ConfigurableWebBindingInitializer的主要作用就是 初始化WebDataBinder，将请求的参数转化为对应的JavaBean，并且可以结合类型、格式转换等API一起使用。

2. 示例代码

我们来查看一下WebMvcAutoConfiguration.class中的方法源码：

protectedConfigurableWebBindingInitializergetConfigurableWebBindingInitializer() {
try {
//从容器中获取return (ConfigurableWebBindingInitializer)this.beanFactory.getBean(ConfigurableWebBindingInitializer.class);
    } catch (NoSuchBeanDefinitionExceptionex) {
returnsuper.getConfigurableWebBindingInitializer();
    }
}

可以发现ConfigurableWebBindingInitializer是从容器(beanFactory)中获取到的，所以我们可以配置一个ConfigurableWebBindingInitializer来替换默认的，只需要在容器中添加一个我们自定义的转换器即可。当我们创建了自己的ConfigurableWebBindingInitializer这个Bean，SpringBoot就会自动使用它来配置Spring MVC实现参数的类型转换。

二. ConfigurableWebBindingInitializer教程

1. 需求分析

在本案例中，我们还是以时间转换字符串为例，解决web数据绑定问题，把http客户端所传入的字符串类型参数，转换成对象类型。

本案例继续沿用上一章节的案例。我们可以把上一章节中“CustomDateEditorConfiguration”类上面的@Configuration注解注释掉。

这样，原有的全局级别的绑定配置就不生效了。

2. 创建ConfigurableWebBindingInitializer配置bean

其实在Spring Boot中，ConfigurableWebBindingInitializer的使用非常的简单，我们只需要在配置类中，创建一个ConfigurableWebBindingInitializer的bean，就可以自动实现String类型与Date类型之间的转换了。

packagecom.yyg.boot.config;
importorg.springframework.context.annotation.Bean;
importorg.springframework.context.annotation.Configuration;
importorg.springframework.web.bind.support.ConfigurableWebBindingInitializer;
/*** @Description ConfigurableWebBindingInitializer的用法,只需要配置这个bean,就可以自动失效Date与String* 之间的类型转换了,非常简单.* @Author 一一哥Sun* @Date Created in 2020/3/24*/@ConfigurationpublicclassWebDataBindConfig {
@BeanConfigurableWebBindingInitializerconfigurableWebBindingInitializer(){
returnnewConfigurableWebBindingInitializer();
    }
}

代码结构如下图所示：

3. 编写OrderForm实体类

编写一个实体类，封装几个字段。

packagecom.yyg.boot.domain;
importlombok.Data;
importlombok.ToString;
importjava.util.Date;
/*** @Description Description* @Author 一一哥Sun* @Date Created in 2020/3/24*/@Data@ToStringpublicclassOrderForm {
privateStringid;
privateStringuserName;
privateDateaddTime;
}

4. 编写Controller测试接口

编写一个Controller接口方法，接受前端传递过来的OrderForm表单参数。

@PostMapping(value="/order")
publicStringorder(@Valid@RequestBodyOrderFormform,BindingResultbindingResult) {
if (bindingResult.hasErrors()) {
returnbindingResult.getFieldError().getDefaultMessage();
    }
log.warn("order={}",form.toString());
return"success";
}

5. 启动项目测试

然后我们重启项目，在Postman中输入地址：http://localhost:8080/order

传入JSON格式的参数：

{
"id":1,
"userName":"一一哥",
"addTime":1488264066}

可以看到，这样我们就把前端传递过来的String类型的时间参数，成功的转换成了Date类型。

结语

这样我们就在SpringBoot中，通过配置ConfigurableWebBindingInitializer实现了数据绑定和转换，这种方式要比之前的方式更简单，推荐在SpringBoot中使用这种方式。