SpringBoot - @InitBinder注解详解

傷城~ 2023-10-08 16:29 63阅读 0赞

#### 写在前面 ####

@InitBinder注解可以作用在被@Controller注解的类的方法上，表示为当前控制器注册一个属性编辑器，用于对WebDataBinder进行初始化，且只对当前的Controller有效。@InitBinder标注的方法会被多次执行的，也就是说来一次请求就会执行一次@InitBinder注解方法的内容。  
A. @InitBinder注解是在其所标注的方法执行之前被解析和执行；  
B. @InitBinder的value属性，控制的是模型Model里的KEY，而不是方法名；  
C. @InitBinder标注的方法也不能有返回值；  
D. @InitBinder对@RequestBody这种基于消息转换器的请求参数是失效的。

#### 应用场景 ####

用于将前端传递过来的数据进行类型转换或者叫属性编辑，如：将前端传递过来的字符串格式的日期数据，转化为DATE类型。

#### 作用范围 ####

@InitBinder是属于Controller级别的属性编辑器，并非全局级别(针对所有Controller)的属性编辑器，也就是一个@InitBinder只对当前所在的Controller有效，对其他Controller无效的，如果项目中有多个Controller中都要进属性编辑怎么办呢？一般我们将@InitBinder标注的方法定义在基础的控制器上，所有具体的Controller继承这个基础的Controller即可。

#### 示例代码 ####

/**
     * WEB层通用数据处理
     * @author ROCKY
     */
    public class BaseController {
        
    
        /**
         * 将前端传递过来的日期格式的字符串转化为Date类型，否则无法将数据绑定到实体中。
         * 自定义类型转换器有两种方式：A. implements Converter<String, Date> 或者 B. extends PropertyEditorSupport;
         * 在WebDataBinder对象中，可以设置前缀，可以设置允许、禁止的字段、必填字段以及验证器，可以自定义类型转换器。
         */
        @InitBinder
        public void initBinder(WebDataBinder binder) {
        
            // Date 类型转换
            binder.registerCustomEditor(Date.class, new PropertyEditorSupport() {
        
                @Override
                public void setAsText(String text) {
        
                    setValue(DateUtils.parseDate(text));
                }
            });
        }
    }

#### 常见错误 ####

如果后端没有将日期格式的字符串转化为DATE类型，则在后端服务接收DATE类型的数据时，报错如下：

Failed to convert value of type 'java.lang.String' to required type 'java.util.Date'; 
    nested exception is org.springframework.core.convert.ConversionFailedException: 
    Failed to convert from type [java.lang.String] to type [java.util.Date] for value '2022-08-09 11:15:58'; 
    nested exception is java.lang.IllegalArgumentException

#### 为什么@InitBinder对@RequestBody的请求参数是失效的？ ####

因为@InitBinder用于初始化DataBinder的数据绑定、类型转换等场景；  
@RequestBody的数据解析、格式转换是通过消息转换器来完成的，所以即使自定义了属性编辑器，对@RequestBody的参数是不生效的，@RequestBody的数据绑定转换，如果是JSON格式的数据一般都是交给了JACKSON来完成的。这就是为什么在整个项目中既有属性编辑器，也有JACKSON的消息转换器，同时对应的DO对象中关于日期的属性，需要使用@JsonFormat()进行标注，如下：

/**
     * 程序注解配置
     *
     * @author ROCKY
     */
    @Configuration
    // 表示通过aop框架暴露该代理对象,AopContext能够访问
    @EnableAspectJAutoProxy(exposeProxy = true)
    // 指定要扫描的Mapper类的包的路径
    @MapperScan("cn.hadoopx.**.mapper")
    public class ApplicationConfig {
        
        // 1. 时区配置
        @Bean
        public Jackson2ObjectMapperBuilderCustomizer jacksonObjectMapperCustomization() {
        
            return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder.timeZone(TimeZone.getDefault());
        }
    }

public class BaseEntity implements Serializable {
        
    
        /**
         * 创建者
         */
        private String createBy;
    
        /**
         * 创建时间
         */
        @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
        private Date createTime;
    
        /**
         * 更新者
         */
        private String updateBy;
    
        /**
         * 更新时间
         */
        @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
        private Date updateTime;
    }