Jakarta-Common-BeanUtils研究心得（1）
SonyMusic
2003.05.13

一、概述
第一次看到BeanUtils包，是在Struts項(xiàng)目中，作為Struts一個(gè)工具來(lái)使用的，
估計(jì)功能越弄越強(qiáng)，就移到Common項(xiàng)目中了吧。

BeanUtils一共有四個(gè)package:
org.apache.commons.beanutils
org.apache.commons.beanutils.converters
org.apache.commons.beanutils.locale
org.apache.commons.beanutils.locale.converters
后三個(gè)包主要是用于數(shù)據(jù)的轉(zhuǎn)換，圍繞著一個(gè)Converter接口，該接口只有一個(gè)方法：
java.lang.Object convert(java.lang.Class type, java.lang.Object value) ，
用于將一個(gè)value轉(zhuǎn)換成另一個(gè)類型為type的Object。在一些自動(dòng)化的應(yīng)用中應(yīng)該會(huì)有用。
這里不作評(píng)論，以后有興趣了，或者覺(jué)得有用了，再行研究。
這里只講第一個(gè)包。

二、測(cè)試用的Bean
在開(kāi)始所有的測(cè)試之前，我寫(xiě)了一個(gè)簡(jiǎn)單的Bean，以便于測(cè)試，代碼如下：
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
這是一個(gè)主要應(yīng)用于Bean的Util（呵呵，這個(gè)解釋很絕吧），以下是其中幾個(gè)方法的例子

//static java.util.Map describe(java.lang.Object bean)
//這個(gè)方法返回一個(gè)Object中所有的可讀屬性，并將屬性名/屬性值放入一個(gè)Map中，另外還有
//一個(gè)名為class的屬性，屬性值是Object的類名，事實(shí)上class是java.lang.Object的一個(gè)屬性
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中實(shí)際的值是多少。
與此對(duì)應(yīng)的還有static void populate(java.lang.Object bean, java.util.Map properties)
用于將剛才describe出的Map再裝配成一個(gè)對(duì)象。


再看這樣一段代碼
曹曉鋼也許還記得，為了取一個(gè)不確定對(duì)象的property，著實(shí)花了不少時(shí)間，
難度不大，但要做到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類似的還有g(shù)etIndexedProperty, 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();
}
這兩個(gè)調(diào)用是相同的。


BeanUtils中還有一個(gè)方法：
static void copyProperties(java.lang.Object dest, java.lang.Object orig)
它真是太有用，還記得struts中滿天飛的都是copyProperties，我甚至懷疑整個(gè)BeanUtils最初
是不是因?yàn)檫@個(gè)方法的需求才寫(xiě)出來(lái)的。
它將對(duì)象orig中的屬性復(fù)制到dest中去。


四、PropertyUtils
這個(gè)類和BeanUtils類很多的方法在參數(shù)上都是相同的，但返回值不同。
BeanUtils著重于"Bean"，返回值通常是String，而PropertyUtils著重于屬性，
它的返回值通常是Object。


五、ConstructorUtils
這個(gè)類中的方法主要分成兩種，一種是得到構(gòu)造方法，一種是創(chuàng)建對(duì)象。
事實(shí)上多數(shù)時(shí)候得到構(gòu)造方法的目的就是創(chuàng)建對(duì)象，這里只介紹一下創(chuàng)建對(duì)象。
//static java.lang.Object ConstructorUtils.invokeConstructor
//(java.lang.Class klass, java.lang.Object[] args)
//根據(jù)一個(gè)java.lang.Class以及相應(yīng)的構(gòu)造方法的參數(shù)，創(chuàng)建一個(gè)對(duì)象。
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();
}
輸出證明，構(gòu)造方法的調(diào)用是成功的。
如果需要強(qiáng)制指定構(gòu)造方法的參數(shù)類型，可以這樣調(diào)用：
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指定了參數(shù)的類型。


＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
to be continued...