深入了解SpringBoot中@InitBinder注解的使用

 更新时间:2023年10月10日 09:25:24   作者:cloneme01  
这篇文章主要介绍了深入了解SpringBoot中@InitBinder注解的使用,@InitBinder注解可以作用在被@Controller注解的类的方法上,表示为当前控制器注册一个属性编辑器,用于对WebDataBinder进行初始化,且只对当前的Controller有效,需要的朋友可以参考下

写在前面

@InitBinder注解可以作用在被@Controller注解的类的方法上,表示为当前控制器注册一个属性编辑器,用于对WebDataBinder进行初始化,且只对当前的Controller有效。@InitBinder标注的方法会被多次执行的,也就是说来一次请求就会执行一次@InitBinder注解方法的内容。

  • @InitBinder注解是在其所标注的方法执行之前被解析和执行;
  • @InitBinder的value属性,控制的是模型Model里的KEY,而不是方法名;
  • @InitBinder标注的方法也不能有返回值;
  • @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;
}

到此这篇关于深入了解SpringBoot中@InitBinder注解的使用的文章就介绍到这了,更多相关@InitBinder注解详细解读内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java基于Semaphore构建阻塞对象池

    Java基于Semaphore构建阻塞对象池

    这篇文章主要介绍了Java基于Semaphore构建阻塞对象池,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-04-04
  • java使用URLDecoder和URLEncoder对中文字符进行编码和解码

    java使用URLDecoder和URLEncoder对中文字符进行编码和解码

    这篇文章主要介绍了java 使用 URLDecoder 和 URLEncoder 对中文字符进行编码和解码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-07-07
  • java锁synchronized面试常问总结

    java锁synchronized面试常问总结

    这篇文章主要介绍了java锁synchronized面试常问总结分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-12-12
  • springboot中bootstrap配置无效的解决方案

    springboot中bootstrap配置无效的解决方案

    在Spring Boot中,从4.4.1版本开始,spring-cloud-starter-bootstrap的配置加载默认为关闭状态,需要在pom文件中引入依赖并在Spring Boot配置文件中开启spring.cloud.bootstrap.enabled配置,或者在启动命令中使用--spring.cloud.bootstrap.enabled=true参数开启
    2026-04-04
  • idea项目报错缺失maven依赖问题及解决

    idea项目报错缺失maven依赖问题及解决

    这篇文章主要介绍了idea项目报错缺失maven依赖问题及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-03-03
  • Java完整实现记事本代码

    Java完整实现记事本代码

    这篇文章主要介绍了Java实现的简易记事本,较为详细的分析了基于java实现记事本程序的完整过程,具有一定参考借鉴价值,需要的朋友可以参考下
    2022-06-06
  • 浅谈Java内省机制

    浅谈Java内省机制

    本文主要介绍了Java内省机制,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • 解决SpringBoot项目中log4j与logback的Jar包冲突问题

    解决SpringBoot项目中log4j与logback的Jar包冲突问题

    这篇文章主要给大家介绍了解决SpringBoot项目中log4j与logback的Jar包冲突问题,文中有详细的解决方法和冲突的原因,有遇到相同问题的朋友可以参考阅读本文
    2023-10-10
  • Spring各版本新特性的介绍

    Spring各版本新特性的介绍

    今天小编就为大家分享一篇关于Spring各版本新特性的介绍,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-03-03
  • Java 其中翻转字符串的实现方法

    Java 其中翻转字符串的实现方法

    这篇文章主要介绍了Java 其中翻转字符串的实现方法,需要的朋友可以参考下
    2014-02-02

最新评论