浅谈Spring的属性编辑器的使用
在 Spring 配置文件中,我们往往通过字面值设置 Bean 各种类型的属性值 ,这个功能是通过属性编辑器实现的。 任何实现了 java.beans.PropertyEditor 接口的类都是属性编辑器 。 它可以将外部需要设置的值转换为 JVM 内部的对应类型,所以属性编辑器其实就是一个类型转换器 。 1 JavaBean 编辑器 Sun 所制定的 JavaBean 编辑器,很大程度上是为 IDE 准备的。它让 IDE 能够以可视化的方式来设置 JavaBean 的属性 。 Java 通过 java.beans.PropertyEditor 定义了设置 JavaBean 属性的方法,通过 BeanInfo 描述了 JavaBean 哪些属性是可定制的,此外还描述了可定制属性与 PropertyEditor 之间的对应关系 。 BeanInfo 与 JavaBean 之间的对应关系,通过两者之间规范的命名确立,对应 JavaBean 的 BeanInfo 采用如下命名规范:<Bean>BeanInfo。 如 BookBean 对应的 BeanInfo 为 BookBeanBeanInfo。 当 JavaBean 连同其属性编辑器注册到 IDE 后,当在开发界面中对 JavaBean 进行定制时, IDE 就会根据 JavaBean 规范找到对应的 BeanInfo ,然后再根据 BeanInfo 中的描述信息找到 JavaBean 属性描述(使用哪个属性编辑器等),进而为 JavaBean 生成特定开发编辑界面 。 Java 提供了一个用于管理默认属性编辑器的管理器: PropertyEditorManager ,它保存着一些常见类型的属性编辑器,如果某个 JavaBean 的常见类型属性没有通过 BeanInfo 显式指定它的属性编辑器, 那么 IDE 将自动使用 PropertyEditorManager 中注册的对应属性的默认编辑器 。 1.1 属性编辑器(PropertyEditor)
PropertyEditor 接口是内部属性值和外部设置值的沟通桥梁 。 Java 为 PropertyEditor 提供了一个方便的实现类: PropertyEditorSupport ,该类实现了 PropertyEditor 接口,我们可以通过扩展这个类来设计自己的属性编辑器 。 1.2 Bean 属性描述(BeanInfo) BeanInfo 描述了 JavaBean 中的可编辑属性以及对应的属性编辑器,每一个属性对应一个属性描述器 PropertyDescriptor。 PropertyDescriptor 的构造函数有两个入参: PropertyDescriptor(String propertyName,Class beanClass) ,其中 propertyName 为属性名; beanClass 是 JavaBean 所对应的 Class。 PropertyDescriptor 还有一个 setPropertyEditorClass(Class propertyEditorClass) 方法,它可以为 JavaBean 属性指定编辑器 。 BeanInfo 接口中最重要的方法是:PropertyDescriptor[] getPropertyDescriptors() ,它会返回 JavaBean 的属性描述器数组 。 BeanInfo 接口的一个常用的实现类是 SimpleBeanInfo ,我们可以通过扩展这个类来实现自定义的功能 。 2 Spring 默认属性编辑器 Spring 的属性编辑器与传统的用于 IDE 开发的属性编辑器不同,它没有 UI 界面,只是将配置文件中的文本配置值转换为 Bean 属性的对应值 。 Spring 在 PropertyEditorRegistrySupport 中为常见的属性类型提供了默认属性编辑器,分为 3 大类,共有 32 个:
PropertyEditorRegistrySupport 中有两个用于保存属性编辑器的 Map 类型变量:
3 自定义 Spring 属性编辑器 如果我们的应用定义了特殊类型的属性,并且希望在配置文件中以字面值方式来配置属性值,那么就可以编写自定义属性编辑器并注册到 Spring 容器的方式来实现。 Spring 默认的属性编辑器大都扩展自 java.beans.PropertyEditorSupport,我们可以通过扩展 PropertyEditorSupport 来自定义属性编辑器 。在Spring 环境下仅需要将配置文件中字面值转换为属性类型的对象即可,并不需要提供 UI 界面,所以仅需要覆盖 PropertyEditorSupport 的 setAsText() 方法就可以啦 (∩_∩)O哈哈~。 假设我们有两个实体 Book 和 Author,希望在配置 Book 时,可以直接设置 Author 的名字。 Book.java public class Book { /** * 作者 */ private Author author; /** * 书名 */ private String name; //省略 get/setter 方法 } Author.java public class Author { private String name; //省略 get/setter 方法 } 首先,自定义 author 的属性编辑器: public class CustomPropertyEditor extends PropertyEditorSupport { @Override public void setAsText(String text) throws IllegalArgumentException { if(text==null||text.length()==0){ throw new IllegalArgumentException("格式错误"); } Author author=new Author(); author.setName(text); //调用父类的方法,来设置属性对象 setValue(author); } } 如果使用 BeanFactory ,则需要手工调用 现在注册自定义的属性编辑器: <!-- 注册自定义的属性编辑器--> <bean class="org.springframework.beans.factory.config.CustomEditorConfigurer"> <property name="customEditors"> <map> <!-- key:属性类型;value:属性编辑器--> <entry key="net.deniro.spring4.editor.Author" value="net.deniro.spring4.editor.CustomPropertyEditor" /> </map> </property> </bean> <bean id="book" class="net.deniro.spring4.editor.Book"> <property name="name" value="海边的卡夫卡"/> <!-- 使用之前定义的编辑器注入该属性--> <property name="author" value="村上春树"/> </bean> BeanWrapper 在设置 book 的 author 属性时,将检索自定义属性编辑器注册表,当发现 author 属性类型所对应的属性编辑器 CustomPropertyEditor 时,它就会这个定制的属性编辑器把 "村上春树" 转换为 Author 对象 。 按照规范, Java 会在 JavaBean 的相同类包下查找是否存在 所以如果在类包下有一个名为 AuthorEditor 属性编辑器类,那么就无须在配置文件中注册自定义的属性编辑器啦O(∩_∩)O哈哈~ 以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程小技巧。 您可能感兴趣的文章:
(编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |