说说 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 是属性编辑器接口,它定义了将外部设置值转换为内部 JavaBean 属性值的接口方法 。主要接口方法说明如下:

方法 说明
Object getValue() 返回属性的当前值 ,基本类型被封装成对应的包装类型
void setValue(Object newValue) 设置属性的值,基本类型以包装类型传入
String getAsText() 用字符串来表示属性对象,以便外部的属性编辑器能够以可视化的方式显示 。 默认返回 null ,表示该属性不能以字符串表示。
void setAsText(String text) 用一个字符串去更新属性的内部值,它一般从外部属性编辑器传入的。
String[] getTags() 返回表示有效属性值的字符串数组,以便属性编辑器能够以下拉框的方式进行展示 。 默认返回 null。
String getJavaInitializationString() 为属性提供初始值,属性编辑器以此值作为属性的默认值 。

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 个:

类型 说明
基础数据类型 【1】基本数据类型,如: boolean、int 等; 【2】基本数据类型封装类,如: Boolean、Integer 等; 【3】基本数据类型数组: char[] 和 byte[] ; 【4】大数: BigDecimal 和 BigInteger 。
集合类 Collection、Set、SortedSet、List 和 SortedMap。
资源类 Class、Class[]、File、InputStream、Locale、Properties、Resource[] 和 URL。

PropertyEditorRegistrySupport 中有两个用于保存属性编辑器的 Map 类型变量:

变量名 说明
defaultEditors 保存默认属性类型的编辑器,元素的键为属性类型,值为对应的属性编辑器实例。
customEditors 保存用户自定义的属性编辑器,元素的键值和 defaultEditors 相同 。

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 ,则需要手工调用 registerCustomEditor(Class requiredType, PropertyEditor propertyEditor) 方法注册自定义属性编辑器;如果使用的是 ApplicationContext ,那么只需要在配置文件中注册 CustomEditorConfigurer 即可 。CustomEditorConfigurer 实现了BeanFactoryPostProcessor 接口,所以它是一个 Bean 的工厂后处理器 。

现在注册自定义的属性编辑器:

<!-- 注册自定义的属性编辑器-->
<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 的相同类包下查找是否存在 <JavaBean>Editor 的类;如果存在,就会自动使用 <JavaBean>Editor作为该 JavaBean 的属性编辑器 。Spring 也支持这个规范。


所以如果在类包下有一个名为 AuthorEditor 属性编辑器类,那么就无须在配置文件中注册自定义的属性编辑器啦O(∩_∩)O哈哈~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容