風行天下

一、概述
第一次看到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...