BeanUtils的使用
1.commons-beanutils的介绍
commons-beanutils是Apache组织下的一个基础的开源库，它提供了对Java反射和内省的API的包装，依赖内省，其主要目的是利用反射机制对JavaBean的属性进行处理。我们知道一个JavaBean通常包含了大量的属性，很多情况下，对JavaBean的处理导致了大量的get/set代码堆积，增加了代码长度和阅读代码的难度，现在有了BeanUtils，我们对JavaBean属性的处理就方便很多。
2.BeanUtils的使用
BeanUtils是commons-beanutils包下的一个工具类，如果想在我们的项目中使用这个类需要导入以下两个jar包：
l commons-beanutils.jar
l commons-logging.jar
下面我们就来练习如何使用BeanUtils，案例详情请参考BeanUtils使用案例详解，点击此处下载案例源代码，具体如下：
(1)创建一个web应用，Example5，将上面说到的两个jar包拷贝的WEB-INF/lib下；
(2)在该应用下的src目录下新建一个Class类，名称为Person，主要代码如例1-1所示：
例1-1 Person.java
|
public class Person { private Stringname; private int age; private Stringgender; private boolean bool; 此处省略以上四个属性的get/set方法 @Override public String toString() { return "Person [name=" + name + ", age=" + age + ", gender=" + gender + "]"; } } |
例1-1中，定义了四个成员变量，并重写了toString()方法。
(3)在src目录下新建一个Class类，名称为Demo，在该类中定义了一个单元测试方法，主要代码如例1-2所示：
例1-2 Demo.java
|
public class Demo { @Test public void fun1() throws Exception{ String className="cn.itcast.domain.Person"; Class clazz=Class.forName(className); Object bean=clazz.newInstance(); BeanUtils.setProperty(bean, "name", "张三"); BeanUtils.setProperty(bean, "age", "23"); BeanUtils.setProperty(bean, "gender", "男"); BeanUtils.setProperty(bean, "xxx", "XXX"); System.out.println(bean); } } |
例1-2中，利用反射获得Person类的对象，然后使用BeanUtils类的静态方法setProperty(Object bean,String name,Object value)为指定bean的指定属性赋值。该方法的第一参数是javaBean对象，第二个参数是javaBean的属性，第三个参数是属性的值。
(4)运行Demo类的单元测试方法fun1()，控制台打印结果如图1-1所示：
图1-1 控制台打印结果
图1-1中，Person信息的打印格式是我们再Person类的toString()方法中设置的。
(5)使用BeanUtils的getProperty(Object bean,String name)方法获取指定bean的指定属性值，如例1-3所示：
|
public class Demo { @Test public void fun1() throws Exception{ String className="cn.itcast.domain.Person"; Class clazz=Class.forName(className); Object bean=clazz.newInstance(); BeanUtils.setProperty(bean, "name", "张三"); BeanUtils.setProperty(bean, "age", "23"); BeanUtils.setProperty(bean, "gender", "男"); BeanUtils.setProperty(bean, "xxx", "XXX"); System.out.println(bean); String age = BeanUtils.getProperty(bean, "age"); System.out.println(age); } } |
(6)测试fun1方法，控制台打印结果如图1-2所示：
图1-2 控制台打印结果
以上是通过BeanUtils类的setProperty()和getProperty()方法对javaBean属性的设置和获取；开发中可能会有这样的需求：将表单提交过来的请求参数封装在一个javaBean中，这个时候我们再使用BeanUtils的setProperty()和getProperty()方法就会很麻烦；因此BeanUtils又为我们提供了一个静态方法populate(Object bean,Map properties)，其中第二个参数就是封装请求参数的Map，我们可以通过request.getParameterMap()方法获取一个封装了所有请求参数的Map对象。
下面通过一个例子来了解BeanUtils类的populate(Object bean,Map properties)方法，如下所示：
(7)在Example5中创建一个javaBean类，User，主要代码如例1-4所示：
例1-4 User.java
|
public class User { private Stringusername; private String password; 此处省略User类的成员变量的get/set方法 @Override public String toString() { return "User [username=" + username + ", password=" + password + "]"; } } |
(8)在Demo类中再定义一个单元测试方法fun2，主要代码如例1-5所示：
例1-5 fun2()方法
|
@Test public void fun2() throws Exception { Map<String,String> map = new HashMap<String,String>(); map.put("username", "zhangSan"); map.put("password", "123"); User user = new User(); BeanUtils.populate(user, map); System.out.println(user); } |
例1-5中，将map里面的数据封装到javaBean中，这里有一个要求：Map中的key值要与JavaBean中的属性名称保持一致，否则封装不进去。
(9)测试fun2方法，控制台打印结果如图1-3所示：
图1-3 控制台打印结果
现在我们再对BeanUtils进行封装，封装成一个工具类，我们之前也封装过类似的一个工具类，该工具类中提供了一个方法用来获取不重复的32位长度的大写字符串，如下所示：
(10)在Example5中创建一个工具类，名称为CommonUtils，在该类中定义一个方法，用来将map中的数据封装到javaBean中，主要代码如例1-6所示：
例1-6 CommonUtils.java
|
public class CommonUtils { /** * 生成不重复的32位长的大写字符串 * @return */ public static String uuid() { return UUID.randomUUID().toString().replace("-","").toUpperCase(); } /** * 把map转换成指定类型的javaBean对象 * @param map * @param clazz * @return */ public static <T> T toBean(Map map, Class<T> clazz) { try { /* * 1. 创建指定类型的javabean对象 */ T bean = clazz.newInstance(); /* * 2. 把数据封装到javabean中 */ BeanUtils.populate(bean, map); /* * 返回javabean对象 */ return bean; } catch(Exception e) { throw new RuntimeException(e); } } } |
例1-6中，CommonUtils定义了一个静态的泛型方法：toBean(Map map,Class<T> clazz)，根据传递的参数来判断将map中的数据封装到哪个javaBean中。当中来利用了反射获得指定类型的javaBean对象，然后再调用BeanUtils类的populate()方法。
(11)在Demo类中再定义一个单元测试方法fun3，主要代码如例1-7所示：
例1-7 fun3()方法
|
@Test public void fun3() { Map<String,String> map = new HashMap<String,String>(); map.put("username", "lisi"); map.put("password", "123"); /* * request.getParameterMap(); */ User user = CommonUtils.toBean(map, User.class); System.out.println(user); } |
例1-7中，将map中的数据使用CommonUtils类的toBean()方法封装到user中，然后返回一个user对象。
(12)运行fun3()方法，控制台打印结果如图1-4所示：
图1-4 控制台打印结果
需要注意的是，在使用BeanUtils类的setProperty()、getProperty()和populate()方法时都抛出了异常，我们制作的帮助类需要对异常进行处理，这样在调用这个帮助类的这个方法时就不用再对异常进行处理。另外，在调用BeanUtils的setProperty()方法时，如果设置的属性不存在或者没有给javaBean的某个属性赋值，该方法不会抛出异常。