基于 JavaBeans 接口的类型转换
• 核心职责
• 将 String 类型的内容转化为目标类型的对象
• 扩展原理
• Spring 框架将文本内容传递到 PropertyEditor 实现的 setAsText(String) 方法
• PropertyEditor#setAsText(String) 方法实现将 String 类型转化为目标类型的对象
• 将目标类型的对象传入 PropertyEditor#setValue(Object) 方法
• PropertyEditor#setValue(Object) 方法实现需要临时存储传入对象
• Spring 框架将通过 PropertyEditor#getValue() 获取类型转换后的对象
Spring 內建 PropertyEditor 扩展
• 內建扩展(org.springframework.beans.propertyeditors 包下)
转换场景 实现类
String -> Byte 数组 org.springframework.beans.propertyeditors.ByteArrayPropertyEditor
String -> Char org.springframework.beans.propertyeditors.CharacterEditor
String -> Char 数组 org.springframework.beans.propertyeditors.CharArrayPropertyEditor
String -> Charset org.springframework.beans.propertyeditors.CharsetEditor
String -> Class org.springframework.beans.propertyeditors.ClassEditor
String -> Currency org.springframework.beans.propertyeditors.CurrencyEditor
… …
自定义 PropertyEditor 扩展
• 扩展模式
• 扩展 java.beans.PropertyEditorSupport 类
• 实现 org.springframework.beans.PropertyEditorRegistrar
• 实现 registerCustomEditors(org.springframework.beans.PropertyEditorRegistry) 方法
• 将 PropertyEditorRegistrar 实现注册为 Spring Bean
• 向 org.springframework.beans.PropertyEditorRegistry 注册自定义 PropertyEditor 实现
• 通用类型实现 registerCustomEditor(Class<?>, PropertyEditor)
• Java Bean 属性类型实现:registerCustomEditor(Class<?>, String, PropertyEditor)
Spring PropertyEditor 的设计缺陷
• 违反职责单一原则
• java.beans.PropertyEditor 接口职责太多,除了类型转换,还包括 Java Beans 事件和 Java GUI 交互
• java.beans.PropertyEditor 实现类型局限
• 来源类型只能为 java.lang.String 类型
• java.beans.PropertyEditor 实现缺少类型安全
• 除了实现类命名可以表达语义,实现类无法感知目标转换类型
Spring 3 通用类型转换接口
• 类型转换接口 - org.springframework.core.convert.converter.Converter<S,T>
• 泛型参数 S:来源类型,参数 T:目标类型
• 核心方法:T convert(S)
• 通用类型转换接口 - org.springframework.core.convert.converter.GenericConverter
• 核心方法:convert(Object,TypeDescriptor,TypeDescriptor)
• 配对类型:org.springframework.core.convert.converter.GenericConverter.ConvertiblePair
• 类型描述:org.springframework.core.convert.TypeDescriptor
Spring 內建类型转换器
• 內建扩展
转换场景 实现类所在包名(package)
日期/时间相关 org.springframework.format.datetime
Java 8 日期/时间相关 org.springframework.format.datetime.standard
通用实现 org.springframework.core.convert.support
Converter 接口的局限性
• 局限一:缺少 Source Type 和 Target Type 前置判断
• 应对:增加 org.springframework.core.convert.converter.ConditionalConverter 实现
• 局限二:仅能转换单一的 Source Type 和 Target Type
• 应对:使用 org.springframework.core.convert.converter.GenericConverter 代替