Jakarta-Common-BeanUtils使用笔记

 
Jakarta-Common-BeanUtils 使用笔记
1.    概述
    第一次接触 BeanUtils 是在学习 Struts 的过程中,在 Struts 中它被大量用于处理 FormBean
BeanUtils 主要提供了对于 JavaBean 进行各种操作,
       BeanUtils 一共分 4 个包:
Ø          org.apache.commons.beanutils
Ø          org.apache.commons.beanutils.converters
Ø          org.apache.commons.beanutils.locale
Ø          org.apache.commons.beanutils.locale.converters
其中上面两个是 BeanUtils 的默认实现,它没有针对本地化的任何处理,这个可以提高执行效率。但是若你的程序对于本地化有要求的话,那还是使用下面 2 个包比较安全。 
 
2.    org.apache.commons.beanutils
    这个包主要提供用于操作 JavaBean 的工具类, Jakarta-Common-BeanUtils 的主要功能都在这个包里实现。
    下面分别介绍几个主要的工具类:
2.1. BeanUtil
1 、首先,我先定义一个 JavaBean 作为之后例子的操作对象。
public class Company
{
 private String name;
 private HashMap address = new HashMap();
 private String[] otherInfo;
 private ArrayList product;
 private ArrayList employee;
 private HashMap telephone;
 
 public Company(){}  
 
 public String getName()
 {
    return name;
 }
 public void setName(String name)
 {
    this.name = name;
 }
 
 
 public String getAddress(String type)
 {
    return address.get(type).toString();
 }
 public void setAddress(String type, String address)
 {
    this.address.put(type,address);
 }
 
 
 public String[] getOtherInfo()
 {
    return otherInfo;
 }
 public void setOtherInfo(String[] otherInfo)
 {
    this.otherInfo = otherInfo;
 }
 
 
 public ArrayList getProduct()
 {
    return product;
 }
 public void setProduct(ArrayList product)
 {
    this.product = product;
 }
 
 
  public ArrayList getEmployee()
 {
    return employee;
 }
 public void setEmployee(ArrayList employee)
 {
    this.employee = employee;
 }
 
 
 public HashMap getTelephone()
 {
    return telephone;
 }
 public void setTelephone(HashMap telephone)
 {
    this.telephone = telephone;
 }
}
2 BeanUtils 可以直接 get set 一个属性的值。它将 property 分成 3 种类型:
       Simple ——简单类型,如 Stirng Int ……
       Indexed ——索引类型,如 数组、 arrayList ……
       Maped ——这个不用说也该知道,就是指 Map 啦,比如 HashMap ……
    访问不同类型的数据可以直接调用函数 getProperty setProperty 。它们都只有 2 个参数,第一个是 JavaBean 对象,第二个是要操作的属性名。
Company c = new Company();
c.setName("Simple");
 
 
对于 Simple 类型,参数二直接是属性名即可
//Simple
    System.out.println(BeanUtils.getProperty(c, "name"));
    对于 Map 类型,则需要以“属性名( key 值)”的形式
//Map
    System.out.println(BeanUtils.getProperty(c, "address (A2)"));
    HashMap am = new HashMap();
    am.put("1","234-222-1222211");
    am.put("2","021-086-1232323");
    BeanUtils.setProperty(c,"telephone",am);
    System.out.println(BeanUtils.getProperty(c, "telephone (2)"));
    对于 Indexed ,则为“属性名 [ 索引值 ] ”,注意这里对于 ArrayList 和数组都可以用一样的方式进行操作。
//index
    System.out.println(BeanUtils.getProperty(c, "otherInfo[2]"));
    BeanUtils.setProperty(c, "product[1]", "NOTES SERVER");
    System.out.println(BeanUtils.getProperty(c, "product[1]"));
 
 
    当然这 3 种类也可以组合使用啦!
    //nest
    System.out.println(BeanUtils.getProperty(c, "employee[1].name"));
 
 
3 、此外,还有一个很重要的方法 copyProperty ,可以直接进行 Bean 之间的 clone
       Company c2 = new Company();
    BeanUtils.copyProperties(c2, c);
   但是这种 copy 都是浅拷贝,复制后的 2 Bean 的同一个属性可能拥有同一个对象的 ref ,这个在使用时要小心,特别是对于属性为类的情况。
4 、最后还有 populate ,它用于将一个 map 的值填充到一个 bean 中,其函数原型如下:
public void populate(java.lang.Object bean,
                java.util.Map properties)
              throws java.lang.IllegalAccessException,
                     java.lang.reflect.InvocationTargetException
struts 中这个函数被用于从 http request 中取得参数添加到 FormBean ,目前好像我也没有看到这个函数还有什么其他的用途?!以后想到再说吧: P
  2.2. LazyDynaBean
    它实现一个动态的 Bean ,可以直接往里面加入属性,作为一个 JavaBean 一样使用,也可以用上面的 BeanUtils get/set 方法进行操作,而不用事先定义一个标准的 JavaBean 类啦:)
记得在《 J2ee 设计模式》中有一种 Value Object 的模式,用于在 MVC 各层之间传递数据,避免直接传递大业务对象引起的性能问题,为了避免在项目中出现很多 Bean 类,在书中提供了一个动态 Value Object 的实现(通过扩展 Map )。这里 LazyDynaBean 则可以作为一种更加成熟、稳定的实现来使用: P
    言归正传, LazyBean 的确提供了一个很不错的 DynaBean 的实现,用起来几乎不需要写什么多余的代码 ^_^ ,下面就看看使用的例子吧!
        // 这里使用 LazyDynaMap ,它是 LazyBean 的一个轻量级实现
      LazyDynaMap dynaBean1 = new LazyDynaMap();
 
 
      dynaBean1.set("foo", "bar");                  // simple
      dynaBean1.set("customer", "title", "Mr");        // mapped
      dynaBean1.set("address", 0, "address1");         // indexed
      System.out.println(dynaBean1.get("address",0));
 
 
      Map myMap = dynaBean1.getMap();           // retrieve the Map
      System.out.println(myMap.toString());
    上面的例子可以看到,它可以在 set 时自动增加 bean property (既赋值的同时增加 Bean 中的 property ),同时也支持 3 中类型的 property ,并且 LazyDynaMap 还可以导出为 map
    对于这个类还有两个重要的 Field 要注意:
       returnnull ——指定在 get 方法使用了一个没有定义过的 property 时, DynaBean 的行为。
        // 取的字段的信息
      dynaBean1.setReturnNull(true);// 设为 ture 。若 Bean 中没有此字段,返回 null
                                // 默认为 false 。若 Bean 中没有此字段,自动增加一个:)
      System.out.println(dynaBean1.get("aaa")); // 此时返回 null
       Restricted ——指定是否允许改变这个 bean property
//MutableDynaClass.setRestricted 设为 true 后,字段不可再增删和修改 .
      // 默认为 false ,允许增删和修改
      dynaBean1.setRestricted(true);
      dynaBean1.set("test","error"); // 这里会出错!
    通过设置这两个属性,可以防止意外修改 DynaBean property 。在设计架构时,你可以在后台从数据表或 xml 文件自动产生 DynaBean ,在传到控制层和表示层之前设置上述属性使其 Bean 结构不允许修改,如此就不可能无意中修改 Bean 包含的属性……这样既可以享用它的便利,又可以防止由此引入的错误可能!!
 
 
3.    其他
3.1.BeanUtilsPropertyUtils
    这两个类几乎有一摸一样的功能,唯一的区别是: BeanUtils 在对 Bean 赋值是会进行类型转化。举例来说也就是在 copyProperty 时只要属性名相同,就算类型不同, BeanUtils 也可以进行 copy ;而 PropertyBean 则可能会报错!!
    针对上面的例子,新建一个 Company2 的类,其中代码与 Company 一样,只是将 otherinfo String[] 改为 String
      Company c = init();
      Company2 c2 = new Company2();
     
      BeanUtils.copyProperties(c2,c);
//      PropertyUtils.copyProperties(c2,c); 这句会报错!!
      System.out.println(c2.getOtherInfo());
    当然 2 Bean 之间的同名属性的类型必须是可以转化的,否则用 BeanUtils 一样会报错。
    若实现了 org.apache.commons.beanutils.Converter 接口则可以自定义类型之间的转化。
由于不做类型转化,用 PropertyUtils 在速度上会有很大提高!
此外,不作类型转化还有一个好处,如下面的代码:
      //test data type convert
//      ArrayList a1 = BeanUtils.getProperty(c,"product"); //BeanUtils 返回的是 String
      System.out.println("--" + BeanUtils.getProperty(c,"product")); // 取出后直接被转为 String
      ArrayList a = (ArrayList)PropertyUtils.getProperty(c,"product"); //PropertyUtils 返回的是 Object
      System.out.println("--" + a.get(1)) ;
BeanUtils 无法返回一个对象(除非自己写一个 Converter ),它会自动进行类型转化,然后返回 String 。对于想返回 java 类或自定义类的话,还是不要老它大驾转化了。
 
 
3.2. Utils
    所有的 XXXUtils 类都提供的是静态方法,可以直接调用,其主要实现都在相应的 XXXUtilsBean 中:
BeanUtils    ——> BeanUtilsBean
    ConvertUtils  ——> ConvertUtilsBean
    PropertyUtils ——> PropertyUtilsBean
 
 
其意思看类名也应该知道的差不多了,我就不再废话啦!当然你也可以直接调用那些 XXXUtilsBean ,功能都一样!
资源简介 Jakarta commons docs API CHM 格式带索引和全文搜索,方便携带和查询。 Jakarta commons 包含很多可复用的通用组件。 commons-attributes 让开发者可以使用 C# 或 .net 样式的 attributes, 是一种运行时的 api, 有点类似 doclet commons-beanutils 提供对 Java 反射和自省API的包装 commons-betwixt 这个组件提供一个XML自省(introspection)机制用来把Java Bean映射到XML文档 commons-chain 提供实现组织复杂的处理流程的“责任链模式” commons-cli 命令行参数解析 , 由 Werken, Avalon 和 Optz 组成 commons-codec 包含一些通用的编码解码算法。包括一些语音编码器, Hex, Base64, 以及URL encoder. commons-collections 扩充了 java.util.collection 接口 commons-compress 操作压缩文件的 API commons-configuration 可以从xml、properties、JNDI、JDBC、System properties、Applet parameters和Servlet parameters等读取信息 commons-daemon 可以帮你实现将一个普通的 Java 应用变成系统的一个后台服务 commons-dbcp 数据连接池服务 commons-dbutils JDBC 辅助类 commons-digester XML 文件到 Java 对象的映射机制 commons-discovery 提供工具来定位资源 (包括类) ,通过使用各种模式来映射服务/引用名称和资源名称。 commons-el 提供在JSP2.0规范中定义的EL表达式的解释器. commons-email 提供一组用于发送Email的API,它基于Java Mail API基础之上并进行了简化 commons-exec 处理外部进程的执行或管理外部环境 commons-fileupload 使得在你可以在应用和Servlet中容易的加入强大和高性能的文件上传能力 commons-io 用来帮助进行IO功能开发.它包含三个主要的领域:Utility classes-提供一些静态方法来完成公共任务.Filters-提供文件过滤器的各种实现.Streams-提供实用的Stream,reader与 writer实现 commons-jelly 能够把XML转换成可执行代码,所以Jelly是一个基于XML与Java的脚本和处理引擎 commons-jexl 是一个表达式语言,通过借鉴来自于Velocity的经验扩展了JSTL定义的表达式语言 commons-jxpath 定义了一个简单的XPath表达式语言的解析器.JXPath应用XPath表达式来操纵各种类型的对象包括:JavaBeans,Maps,Servlet contexts,DOM等 commons-lang commons的基础包 commons-launcher 提供多平台的 Java 程序加载 commons-logging 提供日志的实现 commons-math 是一个轻量的,自包含的数学和统计组件,解决了许多非常通用但没有及时出现在Java标准语言中的实践问题. commons-modeler 创建符合 JMX 规范的 MBeans 机制 commons-net 网络和协议实现的集合 commons-pool 提供了通用对象池接口,一个用于创建模块化对象池的工具包,以及通常的对象池实 commons-primitives java 简单类型使用的扩展 commons-proxy 创建动态代理的库 commons-scxml commons-transaction 处理多级事务的集合 commons-validator 提供了一个简单的,可扩展的框架来在一个XML文件中定义校验器 (校验方法)和校验规则 commons-vfs 虚拟文件系统 httpcomponents-client 和 http 协议客户端一起协作的框架 httpcomponents-core jakarta-oro 一套文本处理工具,能提供perl5.0兼容的正则表达式,AWK-like正则表达式, glob表达式。还提供替换,分割,文件名过虑等功能 jakarta-regexp 是一个100%纯java正则式处理包,是Jonathan Locke捐给Apache软件基金会的
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值