struts源代码阅读（Commons-Beanutils包）

核心提示：Commons-Beanutils（一）Commons-Beanutils 这个是jakarta commons项目中的一个子项目，这个项目开发的目的是帮助开发者动态的获取/设值java Bean的属性，struts源代码阅读（Commons-Beanutils包），同时解决每次都要写getXXX和setXXX的麻烦，

　　Commons-Beanutils（一）
　　
　　Commons-Beanutils 这个是jakarta commons项目中的一个子项目。这个项目开发的目的是帮助开发者动态的获取/设值java Bean的属性，同时解决每次都要写getXXX和setXXX的麻烦。
　　
　　一、XXXConvert
　　
　　这些类都实现Converter接口，提供把value值转化成为相应XXX类的实现。现在只针对四种类型：数字，时间，Boolean和String。在Converter 接口中只有一个方法convert(Class type, Object value)，把value对象转换为type所要求的类。XXXConvert类中这个方法的思路是：
　　
　　1、假如value==null，并且自己内部有缺省的值那么就返回这个缺省的值。假如没有缺省值，就抛出ConversionException异常。
　　
　　2、假如value instanceOf XXX类，那么就直接返回value。
　　
　　3、假如上面的都不行，那么调用new XXX(value.toString())或者XXX.valueOf(value.toString())方法来返回。转化失败时，抛出ConversionException异常。
　　
　　二、非凡的实现
　　
　　1、对于ClassConverter类，当进入第三种情形的时候，实际执行的是
　　
　　ClassLoader classLoader =Thread.currentThread().getContextClassLoader();　 if (classLoader == null) {　　　 classLoader = ClassConverter.class.getClassLoader();　 }　 return (classLoader.loadClass(value.toString()));
　　
　　2、对于BooleanConverter类，当进入第三种情形的时候，实际执行的是，根据value.toString()的值：yes，y，true, on, 1 返回true；no，n，false，off，0 返回false。假如这些情形都不符合，并且有缺省值的时候则返回缺省值。否则抛出ConversionException；
　　
　　三、XXXArrayConverter
　　
　　这些类继续自AbstractArrayConverter类。 AbstractArrayConverter 实际只实现了一个List parseElements(String svalue)方法。这个方法接受的是{value1, value2,...}格式的字符串，逐个解析出来后，放入一个ArrayList中。它通过StreamTokenizer解析字符串：StreamTokenizer是用来分离input stream中读取的字符串，并且可以根据标记区分不同的内容，比如数字，字符或者注释。XXXArrayConverter由于要转换的是一个数组，所以convert(....)方法的实现过程有所不同。
　　
　　1、假如value==null，并且自己内部有缺省的值那么就返回这个缺省的值。假如没有缺省值，就抛出ConversionException异常。
　　
　　2、假如model.getClass() == value.getClass()，那么就直接返回value。
　　
　　3、假如上面的都不行，那么就通过parseElements(value.toString())生成一个数组，再对数组的元素逐个调用new XXX(list.get(i))或者XXX.valueOf(list.get(i))方法，转换成为数组对元素要求的类型。转化失败时，抛出ConversionException异常。
　　
　　Commons-Beanutils（二）
　　
　　一、LocaleConverter 与 BaseLocaleConverter
　　
　　LocaleConverter继续自 Converter接口，定义了一个新方法convert(Class type, Object value, String pattern)。
　　
　　抽象类BaseLocaleConverter实现了LocaleConverter接口。它的locPattern属性用来表示这个对象的pattern是否是本地化的格式。patttern 是指把何种格式的时间或者数字值转换成标准值。convert(...)的执行过程是：
　　
　　1、假如value==null，并且自己内部有缺省的值那么就返回这个缺省的值。假如没有缺省值，就抛出ConversionException异常。
　　
　　2、根据参数pattern值是否为null，调用parse(Object value, String pattern)方法：假如这个参数不为null那么就使用这个参数的值，否则使用对象预存的pattern值。假如这
　　
　　样做引起了异常，会首先判定是否能够返回缺省的值，不能则抛出ConversionException异常。
　　
　　3、parse(Object value, String
　　
　　pattern)方法的实现被抛至继续了它的类具体实现。这个方法虽然把value值表述为Object类型，但是最后都是通过强制转换，转换成为String类型。也就是说它实际上需要的
　　
　　是String类型的value。
　　
　　二、 XXXLocaleConverter
　　
　　把pattern格式的value转换成标准格式的相应的XXX类。这些类可以分为两大类：一类为时间，一类为数值。
　　
　　1、时间类最后都会通过SimpleDateFormat类对值进行转换，程序如下：
　　
　　if(pattern == null) {　　　　　　 pattern = locPattern ? new SimpleDateFormat().toLocalizedPattern() :　　　　　　　　　new SimpleDateFormat().toPattern();　 }　 SimpleDateFormat format = new SimpleDateFormat(pattern, locale);　 if (locPattern) {　　　 formatter.applyLocalizedPattern(pattern);　 }else {　　　 formatter.applyPattern(pattern);　 }　 return formatter.parse((String) value);
　　
　　2、数值类最后都会通过DecimalFormat类对值进行转换，程序如下：
　　
　　DecimalFormat formatter = (DecimalFormat) DecimalFormat.getInstance(locale);　 if (pattern != null) {　　　 if (locPattern) {　　　　　 formatter.applyLocalizedPattern(pattern);　　　 } else {　　　　　 formatter.applyPattern(pattern);　　　 }　 }　　return formatter.parse((String) value);
　　
　　这个转化过程要注重精度的问题。由于Number类是所有的数值类的父类，所以转换完成后要检查最后的结果是否是当前要求的精度：假如大于所要求的精度，则抛出ConversionException异常。
　　
　　Commons-Beanutils（三）
　　
　　Dyna开头的类，是专门为DynaFormBean而设计的。
　　
　　一、DynaBean，DynaClass 与 DynaPRoperty
　　
　　DynaBean并不是Java中所定义的Bean，而是一种“假”的Bean。因为它并不是通过getXXX和setXXX方法，对XXX属性进行取值和设值的。它通过一个实现了DynaClass接口的类，帮助治理其所有的属性的类别，而自己则治理对XXX属性值的设定和获取。在设值的时候会通过与name对应的DynaProperty对象，检查赋值的类别是否正确。
　　
　　DynaProperty类描述的是DynaBean中所包含的属性的类型。DynaProperty类有三个属性：属性的名称：name，属性的名称；type，属性的类别；contentType，假如DynaProperty描述的是个容器对象(List或者Map)，那么这个contentType就代表这个容器内元素的类别。这个类值得关注的地方是writeObject和readObject方法的实现。它会首先判定自己的type是否是一个primitive的类，假如是，则先写入true标志，再写入对应的primitive类的编号；否则写入false标志，再写入type。因为在调用readObject方法时，假如得出的是primitive类型，则type的值为XXX.TYPE而不是XXX.class。
　　
　　DynaClass 是一个接口，用来治理DynaBean中所有的DynaProperty属性。
　　
　　二、BasiceDyanBean 与 BasicDynaClass
　　
　　BasiceDyanBean 实现自DynaBean接口。它包含一个实现了DynaClass接口的类的对象，和一个用来存放值的HashMap。这个HashMap的key与DynaClass中HashMap的key是一一对应的。
　　
　　BasicDynaClass 实现了DynaClass接口，以DynaProperty的name为key保存所有这些DynaProperty对象。它通过newInstance方法动态生成实现了DynaBean接口的类的对象；注重这个类是可以动态指定的，假如没有，那么就是默认的BasicDynaBean类。动态指定类是通过反射实现的，程序如下：
　　
　　//dynaBeanClass为任意的实现了DynaBean接口的类，constrUCtorTypes为这个
　　
　　//类的构造方法所需要的参数的类型
　　
　　constructor = dynaBeanClass.getConstructor(constructorTypes);
　　
　　//constructorValues为构造方法的参数值，实际上它的值为当前的BasicDynaClass
　　
　　return ((DynaBean) constructor.newInstance(constructorValues));
　　
　　Commons-Beanutils（四）
　　
　　一、ConvertUtils 和 ConvertUtilsBean
　　
　　ConvertUtils 是ConvertUtilsBean类的一个简单封装，即ConvertUtils中的所有方法都是通过直接调用ConvertUtilsBean中的同名方法实现的。假如你需要更复杂的功能，就使用ConvertUtilsBean，否则使用ConvertUtils。
　　
　　ConvertUtilsBean 通过一个HashMap治理所有的XXXConverter。这个HashMap的key为XXX的类全名，值为相应的XXXConverter对象。通过deregister()方法，初始化这个HashMap。这个初始化方法会为每一个XXXConverter类提供一个缺省的值。用户可以动过setDefaultXXX(...)方法来自行设置XXXConverter对象的缺省值。这个类还提供了convert(...)方法，对String value进行相应的转化。
　　
　　二、PropertyUtils 和 PropertyUtilsBean
　　
　　PropertyUtils 是PropertyUtilsBean类的一个简单封装，同样它的所有方法都是通过直接调用PropertyUtilsBean 中同名方法实现的。
　　
　　PropertyUtilsBean 对DynaBean或者一个java标准Bean中的属性动态的赋值和取值(非通过getXXX和setXXX方法)。
　　
　　1、这个类支持多层嵌套，比如：XXX[i].YYY(key).ZZZ，那么它会为你得到或者设置ZZZ的属性。
　　
　　2、所有的set/get方法介绍：
　　
　　//对XXX(key)格式的name设值
　　
　　setMappedProperty(Object bean, String name,String key, Object value)
　　
　　//对XXX[i]格式的name设值
　　
　　setIndexed