BeanUtils包

作者: SonyMusic         2003.05.13

一、概述

第一次看到BeanUtils包，是在Struts项目中，作为Struts一个工具来使用的，

估计功能越弄越强，就移到Common项目中了吧。

BeanUtils一共有四个package:

org.apache.commons.beanutils

org.apache.commons.beanutils.converters

org.apache.commons.beanutils.locale

org.apache.commons.beanutils.locale.converters

后三个包主要是用于数据的转换，围绕着一个Converter接口，该接口只有一个方法：

java.lang.Object convert(java.lang.Class type, java.lang.Object value) ，

用于将一个value转换成另一个类型为type的Object。在一些自动化的应用中应该会有用。

这里不作评论，以后有兴趣了，或者觉得有用了，再行研究。

这里只讲第一个包。

二、测试用的Bean

在开始所有的测试之前，我写了一个简单的Bean，以便于测试，代码如下：

package test.jakarta.commons.beanutils;

/**

 * @author SonyMusic

 *

 */

public class Month {

 private int value;

 private String name;

 private int[] days={11,22,33,44,55};

 public Month(int v, String n){

   value=v;

   name=n;

 }

 

 /**

  * Returns the name.

  * @return String

  */

 public String getName() {

   return name;

 }

 /**

  * Returns the value.

  * @return int

  */

 public int getValue() {

   return value;

 }

 /**

  * Sets the name.

  * @param name The name to set

  */

 public void setName(String name) {

   this.name = name;

 }

 /**

  * Sets the value.

  * @param value The value to set

  */

 public void setValue(int value) {

   this.value = value;

 }

 /**

  * @see java.lang.Object#toString()

  */

 public String toString() {

   return value+"("+name+")";

 }

 public int[] getDays() {

   return days;

 }

 public void setDays(int[] is) {

   days = is;

 }

}

三、BeanUtils

这是一个主要应用于Bean的Util（呵呵，这个解释很绝吧），以下是其中几个方法的例子

//static java.util.Map describe(java.lang.Object bean)

//这个方法返回一个Object中所有的可读属性，并将属性名/属性值放入一个Map中，另外还有

//一个名为class的属性，属性值是Object的类名，事实上class是java.lang.Object的一个属性

 Month month=new Month(1, "Jan");

 

 try {

   Map map=BeanUtils.describe(month);

   Set keySet=map.keySet();

   for (Iterator iter = keySet.iterator(); iter.hasNext();) {

     Object element = (Object) iter.next();

     System.out.println("KeyClass:"+element.getClass().getName());

     System.out.println("ValueClass:"+map.get(element).getClass().getName());

     System.out.print(element+"\t");

     System.out.print(map.get(element));

     System.out.println();

   }

 } catch (IllegalAccessException e) {

   e.printStackTrace();

 } catch (InvocationTargetException e) {

   e.printStackTrace();

 } catch (NoSuchMethodException e) {

   e.printStackTrace();

 }

输出为：

KeyClass:java.lang.String

ValueClass:java.lang.String

value  1

KeyClass:java.lang.String

ValueClass:java.lang.String

class  class test.jakarta.commons.beanutils.Month

KeyClass:java.lang.String

ValueClass:java.lang.String

name  Jan

注意到所有Map中的key/value都是String，而不管object中实际的值是多少。

与此对应的还有static void populate(java.lang.Object bean, java.util.Map properties)

用于将刚才describe出的Map再装配成一个对象。

再看这样一段代码

曹晓钢也许还记得，为了取一个不确定对象的property，着实花了不少时间，

难度不大，但要做到100%的正确，仍然需要付出很大的精力。

//static java.lang.String getProperty(java.lang.Object bean, java.lang.String name)

 Month month=new Month(1, "Jan");

 

 try {

   System.out.println(BeanUtils.getProperty(month,"value"));

 } catch (Exception e) {

   e.printStackTrace();

 }

//输出是：1

与getProperty类似的还有getIndexedProperty, getMappedProperty，

以getIndexedProperty为例：

 Month month=new Month(1, "Jan");

 

 try {

   System.out.println(BeanUtils.getIndexedProperty(month,"days",1));

   System.out.println(BeanUtils.getIndexedProperty(month,"days[1]"));

 } catch (Exception e) {

   e.printStackTrace();

 }

这两个调用是相同的。

BeanUtils中还有一个方法：

static void copyProperties(java.lang.Object dest, java.lang.Object orig)

它真是太有用，还记得struts中满天飞的都是copyProperties，我甚至怀疑整个BeanUtils最初

是不是因为这个方法的需求才写出来的。

它将对象orig中的属性复制到dest中去。

四、PropertyUtils

这个类和BeanUtils类很多的方法在参数上都是相同的，但返回值不同。

BeanUtils着重于"Bean"，返回值通常是String，而PropertyUtils着重于属性，

它的返回值通常是Object。

五、ConstructorUtils

这个类中的方法主要分成两种，一种是得到构造方法，一种是创建对象。

事实上多数时候得到构造方法的目的就是创建对象，这里只介绍一下创建对象。

//static java.lang.Object ConstructorUtils.invokeConstructor

//(java.lang.Class klass, java.lang.Object[] args)

//根据一个java.lang.Class以及相应的构造方法的参数，创建一个对象。

 Object obj=ConstructorUtils.invokeConstructor(Month.class, {new Integer(1), "Jan"});

 Month month=(Month)obj;

 try {

   System.out.println(BeanUtils.getProperty(month,"value"));

 } catch (Exception e) {

   e.printStackTrace();

 }

输出证明，构造方法的调用是成功的。

如果需要强制指定构造方法的参数类型，可以这样调用：

   Object[] args={new Integer(1), "Jan"};

   Class[] argsType={int.class, String.class};

   Object obj;

   obj = ConstructorUtils.invokeExactConstructor(Month.class, args, argsType);

   Month month=(Month)obj;

   System.out.println(BeanUtils.getProperty(month,"value"));

argsType指定了参数的类型。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

to be continued...

作者Blog：http://blog.csdn.net/Morgan0916/

相关文章

实施DbUtils [转载]

Jakarta-Common-BeanUtils研究心得（2）[转载]

Jakarta-Common-BeanUtils研究心得（1）[转载]

Equals and HashCode in Hibernate

使用Hibernate的项目中对VO的理解