BeanUtils 概述

一、简介：

BeanUtils提供对 Java反射和自省API的包装。其主要目的是利用反射机制对JavaBean的属性进行处理。我们知道，一个JavaBean通常包含了大量的属性，很多情况下，对JavaBean的处理导致大量get/set代码堆积，增加了代码长度和阅读代码的难度。

二、用法：

BeanUtils是这个包里比较常用的一个工具类，这里只介绍它的copyProperties()方法。该方法定义如下：

public static void copyProperties(java.lang.Object dest,java.lang.Object orig)
throws java.lang.IllegalAccessException,
 java.lang.reflect.InvocationTargetException

如果你有两个具有很多相同属性的JavaBean，一个很常见的情况就是Struts里的PO对象（持久对象）和对应的ActionForm，例如 Teacher和TeacherForm。我们一般会在Action里从ActionForm构造一个PO对象，传统的方式是使用类似下面的语句对属性逐个赋值：

//得到TeacherForm
TeacherForm teacherForm=(TeacherForm)form;
//构造Teacher对象
Teacher teacher=new Teacher();
//赋值
teacher.setName(teacherForm.getName());
teacher.setAge(teacherForm.getAge());
teacher.setGender(teacherForm.getGender());
teacher.setMajor(teacherForm.getMajor());
teacher.setDepartment(teacherForm.getDepartment());

//持久化Teacher对象到数据库
HibernateDAO=;
HibernateDAO.save(teacher);

而使用BeanUtils后，代码就大大改观了，如下所示：
//得到TeacherForm
TeacherForm teacherForm=(TeacherForm)form;
//构造Teacher对象
Teacher teacher=new Teacher();
//赋值
BeanUtils.copyProperties(teacher,teacherForm);
//持久化Teacher对象到数据库
HibernateDAO=;
HibernateDAO.save(teacher);

如果Teacher和TeacherForm间存在名称不相同的属性，则BeanUtils不对这些属性进行处理，需要程序员手动处理。例如 Teacher包含modifyDate（该属性记录最后修改日期，不需要用户在界面中输入）属性而TeacherForm无此属性，那么在上面代码的 copyProperties()后还要加上一句：

teacher.setModifyDate(new Date());

怎么样，很方便吧！除BeanUtils外还有一个名为PropertyUtils的工具类，它也提供copyProperties()方法，作用与BeanUtils的同名方法十分相似，主要的区别在于后者提供类型转换功能，即发现两个JavaBean的同名属性为不同类型时，在支持的数据类型范围内进行转换，而前者不支持这个功能，但是速度会更快一些。BeanUtils支持的转换类型如下：

* java.lang.BigDecimal
* java.lang.BigInteger
* boolean and java.lang.Boolean
* byte and java.lang.Byte
* char and java.lang.Character
* java.lang.Class
* double and java.lang.Double
* float and java.lang.Float
* int and java.lang.Integer
* long and java.lang.Long
* short and java.lang.Short
* java.lang.String
* java.sql.Date
* java.sql.Time
* java.sql.Timestamp 

这里要注意一点，java.util.Date是不被支持的，而它的子类java.sql.Date是被支持的。因此如果对象包含时间类型的属性，且希望被转换的时候，一定要使用java.sql.Date类型。否则在转换时会提示argument mistype异常。

三、优缺点：

Apache Jakarta Commons项目非常有用。我曾在许多不同的项目上或直接或间接地使用各种流行的commons组件。其中的一个强大的组件就是BeanUtils。我将说明如何使用BeanUtils将local实体bean转换为对应的value 对象：

BeanUtils.copyProperties(aValue, aLocal)

上面的代码从aLocal对象复制属性到aValue对象。它相当简单！它不管local（或对应的value）对象有多少个属性，只管进行复制。我们假设local对象有100个属性。上面的代码使我们可以无需键入至少100行的冗长、容易出错和反复的get和set方法调用。这太棒了！太强大了！太有用了！

现在，还有一个坏消息：使用BeanUtils的成本惊人地昂贵！我做了一个简单的测试，BeanUtils所花费的时间要超过取数据、将其复制到对应的 value对象（通过手动调用get和set方法），以及通过串行化将其返回到远程的客户机的时间总和。所以要小心使用这种威力！

1. 概述

第一次接触BeanUtils是在学习Struts的过程中，在Struts中它被大量用于处理FormBean。

BeanUtils主要提供了对于JavaBean进行各种操作，

BeanUtils一共分4个包：

Ø org.apache.commons.beanutils

Ø org.apache.commons.beanutils.converters

Ø org.apache.commons.beanutils.locale

Ø org.apache.commons.beanutils.locale.converters

其中上面两个是BeanUtils的默认实现，它没有针对本地化的任何处理，这个可以提高执行效率。但是若你的程序对于本地化有要求的话，那还是使用下面2个包比较安全。

2. org.apache.commons.beanutils

这个包主要提供用于操作JavaBean的工具类，Jakarta-Common-BeanUtils的主要功能都在这个包里实现。

下面分别介绍几个主要的工具类：

2.1.BeanUtil

1、首先，我先定义一个JavaBean作为之后例子的操作对象。

public class Company

{

private String name;

private HashMap address = new HashMap();

private String[] otherInfo;

private ArrayList product;

private ArrayList employee;

private HashMap telephone;

public Company(){}

public String getName()

{

return name;

}

public void setName(String name)

{

this.name = name;

}

public String getAddress(String type)

{

return address.get(type).toString();

}

public void setAddress(String type, String address)

{

this.address.put(type,address);

}

public String[] getOtherInfo()

{

return otherInfo;

}

public void setOtherInfo(String[] otherInfo)

{

this.otherInfo = otherInfo;

}

public ArrayList getProduct()

{

return product;

}

public void setProduct(ArrayList product)

{

this.product = product;

}

public ArrayList getEmployee()

{

return employee;

}

public void setEmployee(ArrayList employee)

{

this.employee = employee;

}

public HashMap getTelephone()

{

return telephone;

}

public void setTelephone(HashMap telephone)

{

this.telephone = telephone;

}

}

2、BeanUtils可以直接get和set一个属性的值。它将property分成3种类型：

Simple——简单类型，如Stirng、Int……

Indexed——索引类型，如数组、arrayList……

Maped——这个不用说也该知道，就是指Map啦，比如HashMap……

访问不同类型的数据可以直接调用函数getProperty和setProperty。它们都只有2个参数，第一个是JavaBean对象，第二个是要操作的属性名。

Company c = new Company();

c.setName("Simple");

对于Simple类型，参数二直接是属性名即可

//Simple

System.out.println(BeanUtils.getProperty(c, "name"));

对于Map类型，则需要以“属性名（key值）”的形式

//Map

System.out.println(BeanUtils.getProperty(c, "address (A2)"));

HashMap am = new HashMap();

am.put("1","234-222-1222211");

am.put("2","021-086-1232323");

BeanUtils.setProperty(c,"telephone",am);

System.out.println(BeanUtils.getProperty(c, "telephone (2)"));

对于Indexed，则为“属性名[索引值]”，注意这里对于ArrayList和数组都可以用一样的方式进行操作。

//index

System.out.println(BeanUtils.getProperty(c, "otherInfo[2]"));

BeanUtils.setProperty(c, "product[1]", "NOTES SERVER");

System.out.println(BeanUtils.getProperty(c, "product[1]"));

当然这3种类也可以组合使用啦！

//nest

System.out.println(BeanUtils.getProperty(c, "employee[1].name"));

3、此外，还有一个很重要的方法copyProperty，可以直接进行Bean之间的clone。

Company c2 = new Company();

BeanUtils.copyProperties(c2, c);

但是这种copy都是浅拷贝，复制后的2个Bean的同一个属性可能拥有同一个对象的ref，这个在使用时要小心，特别是对于属性为自定义类的情况。

4、最后还有populate，它用于将一个map的值填充到一个bean中，其函数原型如下：

public void populate(java.lang.Objectbean,

java.util.Mapproperties)

throws java.lang.IllegalAccessException,

java.lang.reflect.InvocationTargetException

在struts中这个函数被用于从http request中取得参数添加到FormBean，目前好像我也没有看到这个函数还有什么其他的用途？！以后想到再说吧：P

2.2.LazyDynaBean

它实现一个动态的Bean，可以直接往里面加入属性，作为一个JavaBean一样使用，也可以用上面的BeanUtils或get/set方法进行操作，而不用事先定义一个标准的JavaBean类啦：）

记得在J2ee设计模式中有一种Value Object的模式，用于在MVC各层之间传递数据，避免直接传递大业务对象引起的性能问题，为了避免在项目中出现很多Bean类，在书中提供了一个动态Value Object的实现（通过扩展Map）。这里LazyDynaBean则可以作为一种更加成熟、稳定的实现来使用。呵呵，原来曾打算自己写一个类似的value object类的，现在看来可以直接用这个啦：P

言归正传，LazyBean的确提供了一个很不错的DynaBean的实现。而且就像它的名字中表述的那样，它的确是为我这样的懒人考虑的很周到，用起来几乎不需要写什么多余的代码^_^，下面就看看使用的例子吧！

//这里使用LazyDynaMap，它是LazyBean的一个轻量级实现

LazyDynaMap dynaBean1 = new LazyDynaMap();

dynaBean1.set("foo", "bar"); // simple

dynaBean1.set("customer", "title", "Mr"); // mapped

dynaBean1.set("address", 0, "address1"); // indexed

System.out.println(dynaBean1.get("address",0));

Map myMap = dynaBean1.getMap(); // retrieve the Map

System.out.println(myMap.toString());

上面的例子可以看到，它可以在set时自动增加bean的property（既赋值的同时增加Bean中的property），同时也支持3中类型的property，并且LazyDynaMap还可以导出为map。

对于这个类还有两个重要的Field要注意：

returnnull——指定在get方法使用了一个没有定义过的property时，DynaBean的行为。

//取的字段的信息

dynaBean1.setReturnNull(true);//设为ture。若Bean中没有此字段，返回null

//默认为false。若Bean中没有此字段，自动增加一个：）

System.out.println(dynaBean1.get("aaa"));//此时返回null

Restricted——指定是否允许改变这个bean的property。

//MutableDynaClass.setRestricted设为true后，字段不可再增删和修改.

//默认为false，允许增删和修改

dynaBean1.setRestricted(true);

dynaBean1.set("test","error");//这里会出错！

通过设置这两个属性，可以防止意外修改DynaBean的property。在设计架构时，你可以在后台从数据表或xml文件自动产生DynaBean，在传到控制层和表示层之前设置上述属性使其Bean结构不允许修改，如此就不可能无意中修改Bean包含的属性……这样既可以享用它的便利，有可以防止由此引入的错误可能，设计者实在深得偷懒的精髓啊！！！！！

3. 其他

3.1.BeanUtils和PropertyUtils

这两个类几乎有一摸一样的功能，唯一的区别是：BeanUtils在对Bean赋值是会进行类型转化。举例来说也就是在copyProperty时只要属性名相同，就算类型不同，BeanUtils也可以进行copy；而PropertyBean则可能会报错！！

针对上面的例子，新建一个Company2的类，其中代码与Company一样，只是将otherinfo从String[]改为String。

Company c = init();

Company2 c2 = new Company2();

BeanUtils.copyProperties(c2,c);

// PropertyUtils.copyProperties(c2,c); 这句会报错！！

System.out.println(c2.getOtherInfo());

当然2个Bean之间的同名属性的类型必须是可以转化的，否则用BeanUtils一样会报错。

若实现了org.apache.commons.beanutils.Converter接口则可以自定义类型之间的转化。

由于不做类型转化，用PropertyUtils在速度上会有很大提高！

此外，不作类型转化还有一个好处，如下面的代码：

//test data type convert

// ArrayList a1 = BeanUtils.getProperty(c,"product"); //BeanUtils返回的是String

System.out.println("--" + BeanUtils.getProperty(c,"product")); //取出后直接被转为String

ArrayList a = (ArrayList)PropertyUtils.getProperty(c,"product");//PropertyUtils返回的是Object

System.out.println("--" + a.get(1));

用BeanUtils无法返回一个对象（除非自己写一个Converter），它会自动进行类型转化，然后返回String。对于想返回java类或自定义类的话，还是不要老它大驾转化了。

3.2.Utils类

所有的XXXUtils类都提供的是静态方法，可以直接调用，其主要实现都在相应的XXXUtilsBean中：

BeanUtils ——> BeanUtilsBean

ConvertUtils——> ConvertUtilsBean

PropertyUtils ——> PropertyUtilsBean

其意思看类名也应该知道的差不多了，我就不再废话啦！当然你也可以直接调用那些XXXUtilsBean，功能都一样！