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方法），以及通过串行化将其返回到远程的客户机的时间总和。所以要小心使用这种威力！

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/zengbo0710/archive/2008/04/25/2327979.aspx

------------------------------------------------------------

关于BeanUtils中copyProperties方法的研究体会(引用)

在Struts中经常看到BeanUtils.copyProperties这个方法满天飞，特别是在提取表单中的值的时候，但是这个方法具体怎么实现属性的复制却一直不是很明白，特别是在复制属性的时候，比方说把b复制到a，BeanUtils.copyProperties(a,b)，是不是把b的所有属性都复制过去了呢？如果是同一个属性，b中的值是不是会覆盖掉a中的值？这些应该都可以从BeanUtils的源码中得到答案，奈何找了半天没找到源码，在网上也没有找到别人的答复，于是本着实践是检验真理的唯一标准，决定亲自测试一把，^_^。

首先我们构建两个类People和Person，它们的实例呆会会用来相互复制。

People.java：

package com.mangocity.test;
public class People {

        public People() { }   

        private String name;//姓名
         private int age;//年龄
         private String email;   

        public String getEmail() {  return email;  }
        public void setEmail(String email) {this.email = email; }
        public int getAge() {  return age;  }
        public void setAge(int age) { this.age = age;}
        public String getName() {  return name;   }
        public void setName(String name) { this.name = name;}
}

Person.java：

package com.mangocity.test;
public class Person {

        private String name;
        private int age;
        private String address;
   

        public String getAddress() {  return address;  }
        public void setAddress(String address) {
           this.address = address;
        }

        public int getAge() {  return age;    }
        public void setAge(int age) {  this.age = age;  }

        public String getName() {  return name;  }
        public void setName(String name) {  this.name = name; }

}

接着构建我们的测试类

import org.apache.commons.beanutils.*;

public class TestBeanUtils {

        public static void main(String[] args) {

           People tobby=new People();
           Person cindy=new Person();

           tobby.setAge(23);
           tobby.setName("CMTobby");
           tobby.setEmail("[e-mail]");

           cindy.setName("Cindyelf");
           cindy.setAge(24);

            try {
                 BeanUtils.copyProperties(cindy, tobby);

               System.out.println(cindy.getName()+":"+cindy.getAge());

           } catch (IllegalAccessException e) {             
               e.printStackTrace();
           } catch (InvocationTargetException e) {           
               e.printStackTrace();
           }

        }
}


运行该程序输出是：CMTobby:23。这说明经过BeanUtils.copyProperties之后cindy中name和age属性的值已经被tobby中的同名属性给“覆盖”了，至于tobby中有而cindy中没有的email属性有没有复制到cindy中就不得而知了，据我的猜测应该是没有的，因为在cindy中没有地方放这个属性啊，而且就算复制过去了，我们如何得到这个值呢？难道用cindy.getEmail()吗，可是cindy根本没有这个方法啊？当然这只是我的猜测，不知哪位达人有准确的答案，欢迎指正，^_^。

那么这个复制过程是如何的呢？是直接属性对属性的值拷贝吗，例如cindy.name=tobby.name？还是老办法，将测试进行到底。

1.我将Person中的name属性改名为name11，age属性改为age11，get和set方法都做相应的修改，此时运行程序，输出结果为：CMTobby:23，和前面的一样，由此可以排除值拷贝这个假设了，因为此时cindy中没有了name属性而是name11属性。

2.我将Person中的setName和setAge方法分别改为setName11和setAge11.OK，再次运行我们的程序，这时的输出是：Cindyelf:24，我们发现cindy的name属性和age属性的值都没有被覆盖掉，也就是说tobby中的值都没有拷贝过来，为什么呢？

3.将我们程序恢复到刚开始的样子，即上面所贴的代码那样，然后将Person中的setAge方法注释掉，并注释掉TestBeanUtils中的cindy.setAge(24)这行代码。运行程序，输出结果是：CMTobby:0。tobby中age属性的值没有拷贝过来，为什么呢？

基于上述两个测试，我猜测BeanUtils.copyProperties的行为过程是这样的：首先通过java的反射得到tobby中的所有域，然后根据域的名字调用cindy中相应的set方法。举个例子，BeanUtils发现tobby中有个name属性，那么它会尝试执行cindy.setName()这个方法。这就很容易解释测试2和测试3的结果了：因为cindy中没有了setName或者setAge(被改成了setName11和setAge11或者被注释掉了)，所有cindy的name属性不会变，仍然是以前的值。而在测试1中，因为cindy对象有setName方法，所以name11属性的值会被覆盖掉。

做完上述测试之后，我闲着无聊又做了如下两个测试：

4.将Person中的setName和setAge改为setname和setage，程序输出结果是：CMTobby:23，cindy中的name属性和age属性的值都发生了变化；

5.将Person中的setName和setAge改为setNAme和setAGe,程序输出结果是：Cindyelf:24，tobby中的属性的值都没有拷贝过来。

基于这两个测试，我想过程会不会是这样的：如果BeanUtils发现tobby中有个name属性，那么它就会尝试执行cindy.setName()或者cindy.setname()。当然这些都只是我的推论，仅供参考，所有的答案都会在BeanUtils的源码中找到，^_^，还望哪位达人不吝告知。

后继:

如果BeanUtils发现cindy中有个name属性与tobby对应,那么它会调用些name的setter改变name的值;如果BeanUtils发现cindy中有setter与tobby中相应的setter方法对应,那么它会直接调用setter方法.