`

学习Spring必学的Java基础知识(3)----PropertyEditor

 
阅读更多
引述要学习Spring框架的技术内幕,必须事先掌握一些基本的Java知识,正所谓“登高必自卑,涉远必自迩”。以下几项Java知识和Spring框架息息相关,不可不学(我将通过一个系列分别介绍这些Java基础知识,希望对大家有所帮助。):

[1] Java反射知识-->Spring IoC :http://www.iteye.com/topic/1123081
[2] Java动态代理-->Spring AOP :http://www.iteye.com/topic/1123293
[3] 属性编辑器,即PropertyEditor-->Spring IoC:http://www.iteye.com/topic/1123628
[4] XML基础知识-->Spring配置:http://www.iteye.com/topic/1123630
[5] 注解-->Spring配置:http://www.iteye.com/topic/1123823
[6] 线程本地变更,即ThreadLocal-->Spring事务管理:http://www.iteye.com/topic/1123824
[7] 事务基础知识-->Spring事务管理:http://www.iteye.com/topic/1124043
[8] 国际化信息-->MVC:http://www.iteye.com/topic/1124044
[9] HTTP报文-->MVC:http://www.iteye.com/topic/1124408



在Spring配置文件里,我们往往通过字面值为Bean各种类型的属性提供设置值:不管是double类型还是int类型,在配置文件中都对应字符串类型的字面值。BeanWrapper填充Bean属性时如何将这个字面值转换为对应的double或int等内部类型呢?我们可以隐约地感觉到一定有一个转换器在其中起作用,这个转换器就是属性编辑器。

“属性编辑器”这个名字可能会让人误以为是一个带用户界面的输入器,其实属性编辑器不一定非得有用户界面,任何实现java.beans.PropertyEditor接口的类都是属性编辑器。属性编辑器的主要功能就是将外部的设置值转换为JVM内部的对应类型,所以属性编辑器其实就是一个类型转换器。

PropertyEditor是JavaBean规范定义的接口,JavaBean规范中还有其他一些PropertyEditor配置的接口。为了彻底理解属性编辑器,必须对JavaBean中有关属性编辑器的规范进行学习,相信这些知识对学习和掌握Spring中的属性编辑器会大有帮助。

JavaBean的编辑器

Sun所制定的JavaBean规范,很大程度上是为IDE准备的——它让IDE能够以可视化的方式设置JavaBean的属性。如果在IDE中开发一个可视化应用程序,我们需要通过属性设置的方式对组成应用的各种组件进行定制,IDE通过属性编辑器让开发人员使用可视化的方式设置组件的属性。

一般的IDE都支持JavaBean规范所定义的属性编辑器,当组件开发商发布一个组件时,它往往将组件对应的属性编辑器捆绑发行,这样开发者就可以在IDE环境下方便地利用属性编辑器对组件进行定制工作。

JavaBean规范通过java.beans.PropertyEditor定义了设置JavaBean属性的方法,通过BeanInfo描述了JavaBean哪些属性是可定制的,此外还描述了可定制属性与PropertyEditor的对应关系。

BeanInfo与JavaBean之间的对应关系,通过两者之间规范的命名确立:对应JavaBean的BeanInfo采用如下的命名规范:<Bean>BeanInfo。如ChartBean对应的BeanInfo为ChartBeanBeanInfo;Car对应的BeanInfo为CarBeanInfo。当JavaBean连同其属性编辑器相同的组件注册到IDE中后,当在开发界面中对JavaBean进行定制时,IDE就会根据JavaBean规范找到对应的BeanInfo,再根据BeanInfo中的描述信息找到JavaBean属性描述(是否开放、使用哪个属性编辑器),进而为JavaBean生成特定开发编辑界面。

JavaBean规范提供了一个管理默认属性编辑器的管理器:PropertyEditorManager,该管理器内保存着一些常见类型的属性编辑器,如果某个JavaBean的常见类型属性没有通过BeanInfo显式指定属性编辑器,IDE将自动使用PropertyEditorManager中注册的对应默认属性编辑器。

由于JavaBean对应的属性编辑器等IDE环境相关的资源和组件需要动态加载,所以在纯Java的IDE中开发基于组件的应用时,总会感觉IDE反应很迟钝,不像Delphi、C++Builder一样灵敏快捷。但在Eclipse开发环境中,设计包括可视化组件的应用时却很快捷,原因是Eclipse没有使用Java的标准用户界面组件库,当然也就没有按照JavaBean的规范开发设计GUI组件了。

PropertyEditor

PropertyEditor是属性编辑器的接口,它规定了将外部设置值转换为内部JavaBean属性值的转换接口方法。PropertyEditor主要的接口方法说明如下:
  •   Object getValue():返回属性的当前值。基本类型被封装成对应的封装类实例;
  •   void setValue(Object newValue):设置属性的值,基本类型以封装类传入;
  •   String getAsText():将属性对象用一个字符串表示,以便外部的属性编辑器能以可视化的方式显示。缺省返回null,表示该属性不能以字符串表示;
  •   void setAsText(String text):用一个字符串去更新属性的内部值,这个字符串一般从外部属性编辑器传入;
  •   String[] getTags():返回表示有效属性值的字符串数组(如boolean属性对应的有效Tag为true和false),以便属性编辑器能以下拉框的方式显示出来。缺省返回null,表示属性没有匹配的字符值有限集合;
  •   String getJavaInitializationString():为属性提供一个表示初始值的字符串,属性编辑器以此值作为属性的默认值。


可以看出PropertyEditor接口方法是内部属性值和外部设置值的沟通桥梁。此外,我们可以很容易地发现该接口的很多方法是专为IDE中的可视化属性编辑器提供的:如getTags()、getJavaInitializationString()以及另外一些我们未此介绍的接口方法。

Java为PropertyEditor提供了一个方便类:PropertyEditorSupport,该类实现了PropertyEditor接口并提供默认实现,一般情况下,用户可以通过扩展这个方便类设计自己的属性编辑器。

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,一般情况下,可以通过扩展SimpleBeanInfo实现自己的功能。

一个实例

在本节中,我们来看一个具体属性编辑器的实例,该实例根据《Core Java Ⅱ》上的一个例子改编而成。

ChartBean是一个可定制图表组件,允许通过属性的设置定制图表的样式以得到满足各种不同使用场合要求的图表。我们忽略ChartBean的其他属性,仅关注其中的两个属性:

代码清单5-2  CharBean
public class ChartBean extends JPanel{
   private int titlePosition = CENTER;
   private boolean inverse;
   //省略get/setter方法
}


下面,我们为titlePosition属性提供一个属性编辑器。我们不去直接实现PropertyEditor,而是通过扩展PropertyEditorSupport这个方便类来定义我们的属性编辑器:

代码清单5-3  TitlePositionEditor
import java.beans.*;
 public class TitlePositionEditor extends PropertyEditorSupport{
    private String[] options = { "Left", "Center", "Right" }; 

    //①代表可选属性值的字符串标识数组
    public String[] getTags() { return options; }    
   
    //②代表属性初始值的字符串
    public String getJavaInitializationString() { return "" + getValue(); } 
    
    //③将内部属性值转换为对应的字符串表示形式,供属性编辑器显示之用
    public String getAsText(){
       int value = (Integer) getValue();
       return options[value];
    }

    //④将外部设置的字符串转换为内部属性的值
    public void setAsText(String s){ 
       for (int i = 0; i < options.length; i++){
          if (options[i].equals(s)){
             setValue(i);
             return;
          }
       }
    }
 }


①处通过getTags()方法返回一个字符串数组,因此在IDE中该属性对应的编辑器将自动提供一个下拉框,下拉框中包含3个可选项:“Left”、“Center”、“Right”。而③和④处的两个方法分别完成属性值到字符串的双向转换功能。CharBean的inverse属性也有一个相似的编辑器InverseEditor,我们忽略不讲。

下面编写ChartBean对应的BeanInfo,根据JavaBean的命名规范,这个BeanInfo应该命名为ChartBeanBeanInfo,它负责将属性编辑器和ChartBean的属性挂钩起来:


代码清单5-4  ChartBeanBeanInfo
import java.beans.*;
 public class ChartBeanBeanInfo extends SimpleBeanInfo{
    public PropertyDescriptor[] getPropertyDescriptors() {
       try{

//①将TitlePositionEditor绑定到ChartBean的titlePosition属性中  
PropertyDescriptor titlePositionDescriptor                       
             = new PropertyDescriptor("titlePosition", ChartBean.class);
          titlePositionDescriptor.setPropertyEditorClass(TitlePositionEditor.class);
           
 
//②将InverseEditor绑定到ChartBean的inverse属性中          
PropertyDescriptor inverseDescriptor                        
             = new PropertyDescriptor("inverse", ChartBean.class);                    
          inverseDescriptor.setPropertyEditorClass(InverseEditor.class);
          return new PropertyDescriptor[]{titlePositionDescriptor, inverseDescriptor};
       }
       catch (IntrospectionException e){
          e.printStackTrace();
          return null;
       }
    }
 }

在ChartBeanBeanInfo中,我们分别为ChartBean和titlePosition和inverse属性指定对应的属性编辑器。将ChartBean连同属性编辑器以及ChartBeanBeanInfo打成JAR包,使用IDE组件扩展管理功能注册到IDE中。这样,我们就可以像使用TextField、Checkbox等这些组对ChartBean进行可视化的开发设计工作了。下面是ChartBean在NetBeans IDE中的属性编辑器效果图,如图5-5所示。



ChartBean可设置的属性都列在属性查看器中,当单击titlePosition属性时,下拉框中列出了我们提供的3个选项。

Spring默认属性编辑器

Spring的属性编辑器和传统的用于IDE开发时的属性编辑器不同,它们没有UI界面,仅负责将配置文件中的文本配置值转换为Bean属性的对应值,所以Spring的属性编辑器并非传统意义上的JavaBean属性编辑器。

Spring为常见的属性类型提供了默认的属性编辑器。从图5-4中,我们可以看出BeanWrapperImpl类扩展了PropertyEditorRegistrySupport类,Spring在PropertyEditor RegistrySupport中为常见属性类型提供了默认的属性编辑器,这些“常见的类型”共32个,可分为3大类,总结如下:

表5-1  Spring提供的默认属性编辑器
类    别 说    明
基础数据类型 分为几个小类: 1)基本数据类型,如:boolean、byte、short、int等; 2)基本数据类型封装类,如:Long、Character、Integer等; 3)两个基本数据类型的数组,char[]和byte[]; 4)大数类,BigDecimal和BigInteger
集合类 为5种类型的集合类Collection、Set、SortedSet、List和SortedMap提供了编辑器
资源类 用于访问外部资源的8个常见类Class、Class[]、File、InputStream、Locale、Properties、Resource[]和URL


PropertyEditorRegistrySupport中有两个用于保存属性编辑器的Map类型变量:
  •   defaultEditors:用于保存默认属性类型的编辑器,元素的键为属性类型,值为对应的属性编辑器实例;
  •   customEditors:用于保存用户自定义的属性编辑器,元素的键值和defaultEditors相同。


PropertyEditorRegistrySupport通过类似以下的代码定义默认属性编辑器:
this.defaultEditors.put(char.class, new CharacterEditor(false));
this.defaultEditors.put(Character.class, new CharacterEditor(true));
this.defaultEditors.put(Locale.class, new LocaleEditor());
this.defaultEditors.put(Properties.class, new PropertiesEditor());


这些默认的属性编辑器解决常见属性类型的注册问题,如果用户的应用包括一些特殊类型的属性,且希望在配置文件中以字面值提供配置值,那么就需要编写自定义属性编辑器并注册到Spring容器中。这样,Spring才能将配置文件中的属性配置值转换为对应的属性类型值。

自定义属性编辑器

Spring大部分默认属性编辑器都直接扩展于java.beans.PropertyEditorSupport类,用户也可以通过扩展PropertyEditorSupport实现自己的属性编辑器。比起用于IDE环境的属性编辑器来说,Spring环境下使用的属性编辑器的功能非常单一:仅需要将配置文件中字面值转换为属性类型的对象即可,并不需要提供UI界面,因此仅需要简单覆盖PropertyEditorSupport的setAsText()方法就可以了。

一个实例

我们继续使用第4章中Boss和Car的例子,假设我们现在希望在配置Boss时,不通过引用Bean的方式注入Boss的car属性,而希望直接通过字符串字面值提供配置。为了方便阅读,这里再次列出Boss和Car类的简要代码:

代码清单5-5  Car
package com.baobaotao.editor;
public class Car {
	private int maxSpeed;
	public String brand;
	private double price;
    //省略get/setter
}

代码清单5-6  Boss
package com.baobaotao.editor;
public class Boss {
	private String name;
	private Car car = new Car();
    //省略get/setter
}


Boss有两个属性:name和car,分别对应String类型和Car类型。Spring拥有String类型的默认属性编辑器,因此对于String类型的属性我们不用操心。但Car类型是我们自定义的类型,要配置Boss的car属性,有两种方案:
  • 1)在配置文件中为car专门配置一个<bean>,然后在boss的<bean>中通过ref引用car Bean,这正是我们上一章中所用的方法;
  • 2)为Car类型提供一个自定义的属性编辑器,这样,我们就通过字面值为Boss的car属性提供配置值。


第一种方案是常用的方法,但是在有些情况下,这种方式需要将属性对象一步步肢解为最终可以用基本类型表示的Bean,使配置文件变得不够清晰,直接为属性类提供一个对应的自定义属性编辑器可能会是更好的替代方案。

现在,我们来为Car编写一个自定义的属性编辑器,其代码如下所示:

代码清单5-7  CustomCarEditor
package com.baobaotao.editor;
import java.beans.PropertyEditorSupport;

public class CustomCarEditor extends PropertyEditorSupport {

    //①将字面值转换为属性类型对象
    public void setAsText(String text){ 
		if(text == null || text.indexOf(",") == -1){
			throw new IllegalArgumentException("设置的字符串格式不正确");
		}
		String[] infos = text.split(",");
		Car car = new Car();
		car.setBrand(infos[0]);
		car.setMaxSpeed(Integer.parseInt(infos[1]));
		car.setPrice(Double.parseDouble(infos[2]));

         //②调用父类的setValue()方法设置转换后的属性对象
		setValue(car); 
	}
}


CustomCarEditor很简单,它仅覆盖PropertyEditorSupport便利类的setAsText(String text)方法,该方法负责将配置文件以字符串提供的字面值转换为Car对象。字面值采用逗号分隔的格式同时为brand、maxSpeed和price属性值提供设置值,setAsText()方法解析这个字面值并生成对应的Car对象。由于我们并不需要将Boss内部的car属性反显到属性编辑器中,因此不需要覆盖getAsText()方法。

注册自定义的属性编辑器

在IDE环境下,自定义属性编辑器在使用之前必须通过扩展组件功能进行注册,在Spring环境中也需要通过一定的方法注册自定义的属性编辑器。

如果使用BeanFactory,用户需要手工调用registerCustomEditor(Class requiredType, PropertyEditor propertyEditor)方法注册自定义属性编辑器;如果使用ApplicationContext,则只需要在配置文件通过CustomEditorConfigurer注册就可以了。CustomEditorConfigurer实现BeanFactoryPostProcessor接口,因此是一个Bean工厂后处理器。我们知道Bean工厂后处理器在Spring容器加载配置文件并生成BeanDefinition半成品后就会被自动执行。因此CustomEditorConfigurer有容器启动时有机会注入自定义的属性编辑器。下面的配置片断定义了一个CustomEditorConfigurer:

<!--①配置自动注册属性编辑器的CustomEditorConfigurer -->
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
		<property name="customEditors">
			<map>
                   <!--②-1属性编辑器对应的属性类型-->
                   <entry key="com.baobaotao.editor.Car"> 

                         <!--②-2对应的属性编辑器Bean -->
				    <bean class="com.baobaotao.editor.CustomCarEditor" />
				</entry>
			</map>
		</property>
	</bean>
 <bean id="boss" class="com.baobaotao.editor.Boss">
       <property name="name" value="John"/> 
       <!--③该属性将使用②处的属性编辑器完成属性填充操作-->
       <property name="car" value="红旗CA72,200,20000.00"/> 
</bean>


在①处,我们定义了用于注册自定义属性编辑器的CustomEditorConfigurer,Spring容器将通过反射机制自动调用这个Bean。CustomEditorConfigurer通过一个Map属性定义需要自动注册的自定义属性编辑器。在②处,我们为Car类型指定了对应属性编辑器CustomCarEditor,注意键是属性类型,而值是对应的属性编辑器Bean,而不是属性编辑器的类名。

最精彩的部分当然是③处的配置,我们原来通过一个<bean>元素标签配置好car Bean,然后在boss的<bean>中通过ref引用car Bean,但是现在我们直接通过value为car属性提供配置。BeanWrapper在设置boss的car属性时,它将检索自定义属性编辑器的注册表,当发现Car属性类型拥有对应的属性编辑器CustomCarEditor时,它就会利用CustomCarEditor将“红旗CA72,200,20000.00”转换为Car对象。

引用
按照JavaBeans的规范,JavaBeans的基础设施会在JavaBean相同类包下查找是否存在<JavaBean>Editor的类,如果存在,自动使用<JavaBean>Editor作为该JavaBean的PropertyEditor。
如com.baobaotao.domain.UserEditor会自动成为com.baobaotao.domain.User对应的PropertyEditor。Spring也支持这个规范,也即如果采用这种规约命令PropertyEditor,就无须显式在CustomEditorConfigurer中注册了,Spring将自动查找并注册这个PropertyEditor。


另:Spring 3.0除支持PropertyEditor外,还在核心包中引入了自建的ConversionService,它提供了更为强大的类型转换的能力,可以完成任意类型之间的转换,还可以在转换过程中参考目标对象所在宿主类的上下文信息。Spring的类型转换同时支持PropertyEdito和ConversionService。

这些文章摘自于我的《Spring 4.x企业应用开发实战》,我将通过连载的方式,陆续在此发出。欢迎大家讨论。
  • 大小: 23.4 KB
分享到:
评论
2 楼 javatozhang 2015-04-16  
书也买了、文章也看了、哈哈 不错不错!!!
1 楼 liuhuandd 2013-02-22  

相关推荐

    学习Spring必学的Java基础知识(3)—PropertyEditor

    在深入学习Spring框架之前,掌握基础的Java知识是至关重要的,特别是关于`PropertyEditor`的部分。`PropertyEditor`是Java中用于类型转换的关键组件,它允许我们自定义数据类型的转换规则,这对于处理用户输入或者在...

    Spring MVC学习(七)-------SpringMVC数据类型转换

    在Spring 3之前的版本中,开发者主要依靠`PropertyEditor`来完成这些任务,但在实际应用中发现这种方式存在诸多局限性。随着Spring 3的发布,Spring MVC引入了一套全新的机制,极大地简化了这些过程,并提高了灵活性...

    Spring学习笔记(11)----自定义属性编辑器

    在Spring框架中,属性编辑器(PropertyEditor)扮演着至关重要的角色。它们是JavaBeans规范的一部分,用于在Java对象和字符串之间进行数据转换。在Spring中,属性编辑器被广泛应用于IoC容器,用于处理配置文件中的...

    Spring 2.0学习文档 和Spring API文档

    《Spring 2.0 学习与API指南》 在Java企业级开发中,Spring框架以其卓越的灵活性、模块化和强大的功能深受开发者喜爱。本资料包包含了Spring 2.0的学习文档和API文档,旨在帮助开发者快速掌握Spring的核心概念和...

    Spring-Reference_zh_CN(Spring中文参考手册)

    7.5.1. 基础 7.5.2. JavaBean属性 7.5.3. 基于JDK和CGLIB的代理 7.5.4. 对接口进行代理 7.5.5. 对类进行代理 7.5.6. 使用“全局”advisor 7.6. 简化代理定义 7.7. 使用ProxyFactory通过编程创建AOP代理 7.8. 操作被...

    SpringMVC之DataBinding和Validation--Validator,PropertyEditor,Converter,Formatter

    `PropertyEditor`是Java Swing时代的一个概念,但在Spring中,它被用来转换请求参数的字符串形式与其他类型的数据。例如,如果你需要将请求参数的日期字符串转换为`java.util.Date`对象,你可以自定义一个`...

    spring_FrameWork3.0

    ### Spring Framework 3.0 开发教程核心知识点详解 #### 一、Spring Framework 概述 **1.1 节介绍Spring Framework** ...学习这些知识点,可以帮助开发者更好地理解和使用 Spring 框架,构建高质量的应用程序。

    spring的有关学习知识总结

    Spring框架是Java开发中广泛应用的一个轻量级框架,它提供了多种功能来简化应用程序的构建和管理。Spring的核心特性包括依赖注入(Dependency Injection, DI),面向切面编程(Aspect-Oriented Programming, AOP),...

    PropertyEditor

    又一个中文转unicode的工具,在创建struts资源文件的时候,非常有用,输入中文后,直接保存就自动转换了

    Spring个人学习笔记.pdf

    文档开头反复提到“Spring”,这表明个人学习笔记的起点是Spring框架的基础知识。Spring是一个全面的编程和配置模型,用于现代Java基础上的企业的、多层的和面向服务的应用程序。Spring的一个重要特点是分层架构,...

    spring-reference.pdf

    ### Spring框架核心概念与应用...综上所述,“spring-reference.pdf”文档详细介绍了Spring框架的基础知识和核心概念,并提供了丰富的示例和最佳实践,对于希望深入了解并掌握Spring框架的开发者来说是一份宝贵的资源。

    Java反射中java.beans包学习总结.docx

    本文将重点讨论在Java反射中使用java.beans包学习的主要知识点: 1. **PropertyEditor**: `PropertyEditor`接口是JavaBeans的核心组件之一,用于处理JavaBean的属性转换。它允许我们将字符串与其他类型的数据之间...

    详细的Spring配置和Spring Boot-外文翻译

    Spring Boot则是在Spring基础上进一步简化了配置和启动过程。它引入了自动配置(Auto-configuration)的概念,根据项目中的依赖自动配置相关bean。例如,如果项目中包含了JDBC库,Spring Boot会自动配置数据源和...

    spring-reference

    ### Spring 深入参考知识点概述 #### 一、引言 Spring框架是Java平台上的一个开源框架...通过上述知识点的学习,我们可以更深入地理解Spring框架的工作原理,从而更好地利用Spring框架构建高效、可维护的企业级应用。

    最新spring3.0 源码(一)

    Spring框架是Java开发中的核心组件,它为构建可维护、可扩展的应用程序提供了强大的支持。Spring 3.0是该框架的一个重要版本,引入了许多新特性和改进,以适应不断发展的企业级应用需求。本篇将详细介绍Spring 3.0...

    Spring需要的Jar包

    它提供了一套强大的API用于处理Java对象的属性,如BeanWrapper和PropertyEditor,同时实现了BeanFactory接口,这是DI的基础。 3. `org.springframework.web.servlet-3.0.5.RELEASE.jar`:这个包是Spring MVC(Model...

    spring-framework-reference-4.1.2

    3. New Features and Enhancements in Spring Framework 4.0 ............................................ 17 3.1. Improved Getting Started Experience .........................................................

    spring chm文档

    Spring Framework 开发参考手册 Rod Johnson Juergen Hoeller Alef Arendsen Colin Sampaleanu Rob Harrop Thomas Risberg Darren Davison Dmitriy Kopylenko Mark Pollack Thierry Templier Erwin ...

    Spring的BeanFactory的接口注解

    ### Spring的BeanFactory的接口注解 #### 一、引言 在Spring框架中,`BeanFactory`是工厂模式的一种实现,它负责管理容器中的Bean的生命周期与依赖注入。了解`BeanFactory`及其相关接口的功能对于掌握Spring的核心...

Global site tag (gtag.js) - Google Analytics