Spring框架提供了强大的数据绑定功能，可以将外部数据源（如HTTP请求参数、表单数据、属性文件等）自动绑定到Java对象中。

数据绑定是将外部数据与Java对象中的属性进行关联的过程，常见于Spring的Web开发。

@InitBinder的作用

@InitBinder从字面意思可以看出这个的作用是给Binder做初始化的，@InitBinder主要用在@Controller中标注于方法上（@RestController也算），表示初始化当前控制器的数据绑定器（或者属性绑定器），只对当前的Controller有效。@InitBinder标注的方法必须有一个参数WebDataBinder。所谓的属性编辑器可以理解就是帮助我们完成参数绑定，然后是在请求到达controller要执行方法前执行。

用法如下：

@InitBinder
private void initBinder(WebDataBinder binder) {
    // 可用于自定义参数校验，然后通过addValidators来进行绑定controller
    binder.addValidators(userValidator);
    // 可用于注册 属性编译器
    binder.registerCustomEditor(String.class,new StringTrimmerEditor(true));
}

WebDataBinder到底是干嘛的？

在Servlet中，有一个方法：request.getParameter("paramName")，它会根据key返回一个String类型的数据，从而获取到前端传递过来的请求参数。但是如果我们这样一个一个地去取出Web请求中的所有参数，就会很麻烦。我们知道Java中有对象的概念，那有没有办法将request中的请求参数都自动封装到一个Java对象中呢？为了解决这个问题，SpringMVC中就引入了WebDataBinder的概念。

WebDataBinder的作用是从Web请求中，把请求里的参数都绑定到对应的JavaBean上，在Controller方法中的参数类型可以是基本类型，也可以是封装后的普通Java类型。若这个普通的Java类型没有声明任何注解，则意味着它的每一个属性都需要到Request中去查找对应的请求参数，而WebDataBinder则可以帮助我们实现从Request中取出请求参数并绑定到JavaBean中。

什么时候用WebDataBinder？

现在我们基本上了解了WebDataBinder的作用，那我们知道通过@InitBinder修饰的可以拿到WebDataBinder，WebDataBinder 其实已经帮我们完成了基本的参数映射，日期类型就是个特殊的。

使用get请求params传date类型，SpringMVC在默认时，是不支持这种类型转换的。此时我们就需要自定义编译器，然后通过binder.registerCustomEditor注册进去。post请求json传参默认是支持yyyy-MM-dd其他格式也会报错的！

当然除此外在日期类型字段上添加@DateTimeFormat(pattern x= "yyyy-MM-dd HH:mm:ss") 也是可以的。

@RestController
public class RequestParamController {

    @GetMapping("/requestParm7")
    public Params requestParm7(Params params) {
        System.out.println(params);
        return params;
    }
}

spring为我们提供了一些默认的属性编辑器，如org.springframework.beans.propertyeditors.CustomDateEditor就是其中一个，我们也可以通过继承java.beans.PropertyEditorSupport来根据具体的业务来定义自己的属性编辑器。

除了自定义属性编译器，还可以自定义属性校验器，就是在参数绑定到JavaBean时，做一下校验，看看参数是否符合我们的预期，如果不符合可以抛异常，然后通过binder.addValidators可以添加自定义的属性校验器！

数据绑定器

关于Date属性绑定器有两种方案：使用spring提供的CustomDateEditor，另外一种就是自定义PropertyEditorSupport。

1）定义controller并使用@InitBinder注册属性编辑器，这里注册的属性编辑器为CustomDateEditor，作用是根据提供的SimpleDateFormat，将输入的字符串数据格式化为Date类型的指定格式数据。

2）通过实现PropertyEditorSupport接口自定义的。

• StringTrimmerEditor是PropertyEditorSupport的一个子类，作用是去除字符串的前后空格。

@RequestMapping("body")
@RestController
public class RequestBodyController {

    @GetMapping("/test")
    public Params request(Params params) {
        System.out.println(params);
        return params;
    }

    @RequestMapping("/test1")
    public Params test1(@RequestBody Params params) {
        System.out.println(params);
        return params;
    }

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // 格式化date方式一：get请求params传参必须传yyyy-MM-dd HH:mm:ss，否则400错误
        // post请求json传参只能传yyyy-MM-dd，如果传其他格式，连这个方法都进不来就400异常了
        DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        CustomDateEditor dateEditor = new CustomDateEditor(df, true);
        binder.registerCustomEditor(Date.class, dateEditor);

        //        // 格式化date方式二，自定义PropertyEditorSupport，然后利用hutool的格式化，DateUtil.parse支持的格式有很多种,这里支持很多种是可以传入任何格式，它都会给你格式化成yyyy-MM-dd HH:mm:ss
        // 日期没有时分秒的时候格式化出来的是2022-10-11 00:00:00
        // 自定义的这种方式对于json传参方式没有效果，压根连方法都不会进入
        //        binder.registerCustomEditor(Date.class, new PropertyEditorSupport() {
        //            @Override
        //            public void setAsText(String text) {
        //                System.out.println("1111");
        //                // DateUtil.parse是hutool当中的方法，hutool是一个Java工具包
        //                setValue(DateUtil.parse(text));
        //            }
        //        });

        // 格式化string：如果是字符串类型，就去除字符串的前后空格
        binder.registerCustomEditor(String.class,
                                    new StringTrimmerEditor(true));
    }

}

实际开发中，针对于json传参我们可以在接参的实体日期字段上添加@JsonFormat(pattern = “yyyy-MM-dd HH:mm:ss”, timezone = “GMT+8”)

全局绑定器

方式一：@ControllerAdvice

上面的的@InitBinder方法只对当前Controller生效，要想全局生效，可以使用@ControllerAdvice。通过@ControllerAdvice可以将对于控制器的全局配置放置在同一个位置，注解了@ControllerAdvice的类的方法可以使用@ExceptionHandler，@InitBinder，@ModelAttribute注解到方法上，这对所有注解了@RequestMapping的控制器内的方法有效。

import cn.hutool.core.date.DateUtil;
import org.springframework.beans.propertyeditors.StringTrimmerEditor;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.InitBinder;

import java.beans.PropertyEditorSupport;
import java.util.Date;

@ControllerAdvice
public class GlobalControllerAdvice {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        binder.registerCustomEditor(String.class,
                                    new StringTrimmerEditor(true));

        binder.registerCustomEditor(Date.class, new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) {
                // DateUtil.parse是hutool当中的方法
                setValue(DateUtil.parse(text));
            }
        });
    }
}

方式二：RequestMappingHandlerAdapter

除了使用@ControllerAdvice来配置全局的WebDataBinder，还可以使用RequestMappingHandlerAdapter：

import cn.hutool.core.date.DateUtil;
import org.springframework.beans.propertyeditors.StringTrimmerEditor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.support.WebBindingInitializer;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter;

import java.beans.PropertyEditorSupport;
import java.util.Date;

@Configuration
public class Config {

    @Bean
    public RequestMappingHandlerAdapter webBindingInitializer(RequestMappingHandlerAdapter requestMappingHandlerAdapter) {
        requestMappingHandlerAdapter.setWebBindingInitializer(new WebBindingInitializer() {
            @Override
            public void initBinder(WebDataBinder binder) {
                binder.registerCustomEditor(Date.class, new PropertyEditorSupport() {
                    @Override
                    public void setAsText(String text) {
                        // DateUtil.parse是hutool当中的方法
                        setValue(DateUtil.parse(text));
                    }
                });

                // 如果是字符串类型，就去除字符串的前后空格
                binder.registerCustomEditor(String.class,
                                            new StringTrimmerEditor(true));
            }
        });
        return requestMappingHandlerAdapter;
    }
}

如果定义了全局的，但是个别的使用全局的可能满足不了需求，可以使用@InitBinder修饰controller然后就不走全局的了，@InitBinder修饰的controller要优先于全局的。

自定义数据校验器

直接实现org.springframework.validation.Validator，该接口只有两个方法，一个是校验是否支持校验的support(Class<?> clazz)方法，一个是进行具体校验的validate(Object target, Errors errors)方法,源码如下：

public interface Validator {
    boolean supports(Class<?> clazz);
    void validate(Object target, Errors errors);
}

参数实体类

import lombok.Data;
@Data
public class User {
    private String userName;
    private Integer age;
}

定义一个校验器

该校验器校验用户录入的userName长度是否大于8，并给出响应的错误信息，错误信息直接设置到errors中，最终会设置到org.springframework.validation.BindingReuslt，在接口中直接定义该对象则会自动注入对象值，从而可以获取到对应的错误信息。

import org.springframework.stereotype.Component;
import org.springframework.validation.Errors;
import org.springframework.validation.ValidationUtils;
import org.springframework.validation.Validator;

@Component
public class UserValidator implements Validator {

    @Override
    public boolean supports(Class<?> clazz) {
        // 只支持User类型对象的校验
        return User.class.equals(clazz);
    }

    @Override
    public void validate(Object target, Errors errors) {
        // 校验name是否为空
        // 在static rejectIfEmpty(..)对方法ValidationUtils类用于拒绝该name属性，如果它是null或空字符串
        ValidationUtils.rejectIfEmpty(errors, "userName", "userName不能为空");
        // 校验年龄只能在0-110之间
        User p = (User) target;
        if (p.getAge() < 1) {
            errors.rejectValue("age", "年龄不能小于1");
        } else if (p.getAge() > 110) {
            errors.rejectValue("age", "年龄不能大于110");
        }
    }
}

定义controller，然后通过WebDataBinder添加userValidator参数校验 

不管是get请求params传参还是json传参，都可以进行校验

@RestController
@RequestMapping("/valid")
public class ValidatorController {

    @Autowired
    private UserValidator userValidator;

    @InitBinder
    private void initBinder(WebDataBinder binder) {
        binder.addValidators(userValidator);
    }
    // @Validated相当于开启user的校验，BindingResult是校验的结果
    @PostMapping("/saveUser")
    public User signup(@RequestBody @Validated User user, BindingResult result) {
        // 参数校验
        if (result.hasErrors()) {
            List<FieldError> fieldErrors = result.getFieldErrors();
            fieldErrors.forEach(e -> {
                System.out.println(e.getField() + e.getCode());
            });
            throw new IllegalArgumentException("参数输入错误");
        }
        return user;
    }
}

参数类型转换器

类型转换器也能解决params传日期类型报错的问题，例如如下：

http://localhost:8080/requestParm7?userName=123&age=1&startDate=2022-10-11

这种类型转换对于post的json传参同样是无济于事，根本不会进入这个方法。所以针对于json传参，我建议直接在日期参数上使用@JsonFormat(pattern = “yyyy-MM-dd HH:mm:ss”, timezone = “GMT+8”)

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

@Component
public class DateConverter implements Converter<String, Date> {
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");

    @Override
    public Date convert(String s) {

        if (s != null && !"".equals(s)) {
            try {
                return sdf.parse(s);
            } catch (ParseException e) {
                e.printStackTrace();
            }
        }
        return null;
    }
}

本栏目推荐文章
• Jmeter 如何连接mysql数据库？
• SQL Server 检测是不是数字型数据的两种方法
• spring与设计模式之三代理模式
• 如何通过Navicat把MySQL远程数据库导入到本地数据库
• 和利时MACS6通过dat文件实现任意时间范围与测点的历史数据提取与科研分析
• 深入理解spring框架：剖析多线程模式下数据库连接
• 数据可视化是如何帮助大型企业提高效率的？
• redis 数据库
• openpyxl模块--------------------------------重复数据
• Django客户端应用1向服务端应用2发送POST请求并接收解析数据

功能 数据 Spring功能 数据spring 功能 数据spring国际 功能spring 下线alibaba功能spring spring-retry功能spring retry salesforce错过 功能spring salesforce亮点 功能spring 功能 文件spring java 注解 功能spring 先睹为快 新功能salesforce spring