Commons BeanUtils包说明

 

commons项目主页：http://commons.apache.org/

 

Commons BeanUtils ： http://commons.apache.org/components.html

 

BeanUtils就是其中的一个，用于处理JavaBeans。它利用Java的反射机制，从动态的生成对bean的getter和setter 的调用代码，到模拟创建一个动态的bean，等等。这个包看似简单，却是很多开源项目的基石：如在著名的Struts和Spring Framework中，我们都能找到BeanUtils的影子。大家猜猜看，有哪位名人是BeanUtils的作者之一？没错，就是Struts的创始人 Craig McClanahan。

BeanUtils最核心的好处在于：我们在编码时，并不需要知道我们处理的JavaBeans具体是什么类型，有哪些属性，这些信息是可以动态获 取的，甚至我们都可以不必去关心事实上是否存在这样一个具体的JavaBean类。我们只需要知道有一个JavaBean的实例，我们需要从中取得某个属 性，设定某个属性的值，或者仅仅是需要一个属性表。要做到这些，依靠Sun提供的JavaBean规范似乎找不到一个很直接的方式，除非硬编码，将 getXxxx()和setXxxx()直接写进我们的程序。但是这样就大大增加了代码的复杂度、耦合性和维护成本。还好Commons BeanUtils对这个问题提供了一种优雅的解决方案。

 

 

     1.PropertyUtils

　　它支持三种类型的属性值-Simple，Indexed，Mapped
　　Simple属性访问方法
　　PropertyUtils.getSimpleProperty(Object bean, String name)
　　PropertyUtils.setSimpleProperty(Object bean, String name, Object value)

　　实现代码：
　　 Employee employee = ...;
　　 String firstName = (String)
　　 PropertyUtils.getSimpleProperty(employee, "firstName");
　　 String lastName = (String)
　　 PropertyUtils.getSimpleProperty(employee, "lastName");
　　 ... manipulate the values ...
　　 PropertyUtils.setSimpleProperty(employee, "firstName", firstName);
　　 PropertyUtils.setSimpleProperty(employee, "lastName", lastName);

　　Indexed属性访问方法
　　PropertyUtils.getIndexedProperty(Object bean, String name)
　　PropertyUtils.getIndexedProperty(Object bean, String name, int index)
　　PropertyUtils.setIndexedProperty(Object bean, String name, Object value)
　　PropertyUtils.setIndexedProperty(Object bean, String name, int index, Object value)

　　实现代码：
　　Employee employee = ...;
　　 int index = ...;
　　 String name = "subordinate[" + index + "]";
　　 Employee subordinate = (Employee)
　　 PropertyUtils.getIndexedProperty(employee, name);//根据value取得属性
　　 Employee employee = ...;
　　 int index = ...;
　　 Employee subordinate = (Employee)
　　 PropertyUtils.getIndexedProperty(employee, "subordinate", index);//根据索引
　　值取的属性值

　　Mapped属性访问方法
　　PropertyUtils.getMappedProperty(Object bean, String name)
　　PropertyUtils.getMappedProperty(Object bean, String name, String key)
　　PropertyUtils.setMappedProperty(Object bean, String name, Object value)
　　PropertyUtils.setMappedProperty(Object bean, String name, String key, Object value)
　　实现代码：
　　Employee employee = ...;
　　 Address address = ...;
　　 PropertyUtils.setMappedProperty(employee, "address(home)", address);//根据数组
　　//内的值来去的相应的属性值
　　 Employee employee = ...;
　　 Address address = ...;
　　 PropertyUtils.setMappedProperty(employee, "address", "home", address);

　　Nested属性访问方法//Nested的意思是参数中包含组件
　　PropertyUtils.getNestedProperty(Object bean, String name)
　　PropertyUtils.setNestedProperty(Object bean, String name, Object value)
　　实现代码：
　　String city = (String) PropertyUtils.getNestedProperty(employee,
　　"address(home).city");

　　2.BeanUtils.DynaBean and BeanUtils.DynaClass 接口介绍
　　DynaBean必须有一个bean来实现这个接口，DynaClass必有一个bean的属性集来实现

　　BasicDynaBean and BasicDynaClass - 基本的 Dynamic 类型
　　基本的API:
　　BasicDynaClass(java.lang.String name, java.lang.Class dynaBeanClass, DynaProperty[] properties)
　　BasicDynaBean(DynaClass dynaClass)
　　我们定义一下基本的代码：
　　//定义动态属性集
　　DynaProperty[] props = new DynaProperty[]{
　　 new DynaProperty("address", java.util.Map.class),
　　 new DynaProperty("subordinate", mypackage.Employee[].class),
　　 new DynaProperty("firstName", String.class),
　　 new DynaProperty("lastName", String.class)
　　 };
　　//创建动态类来设定动态属性值
　　 BasicDynaClass dynaClass = new BasicDynaClass("employee", null, props);
　　DynaBean employee = dynaClass.newInstance();
　　 employee.set("address", new HashMap());
　　 employee.set("subordinate", new mypackage.Employee[0]);
　　 employee.set("firstName", "Fred");
　　 employee.set("lastName", "Flintstone");

　　ResultSetDynaClass (Wraps ResultSet in DynaBeans) - 使用 ResultSet 的
　　Dynamic JavaBean
　　API：
　　ResultSetDynaClass(java.sql.ResultSet resultSet)
　　ResultSetDynaClass(java.sql.ResultSet resultSet, boolean lowerCase)
　　Connection conn = ...;
　　 Statement stmt = conn.createStatement();
　　 ResultSet rs = stmt.executeQuery
　　 ("select account_id, name from customers");
　　 Iterator rows = (new ResultSetDynaClass(rs)).iterator();
　　 while (rows.hasNext()) {
　　//利用动态bean进行输出
　　 DynaBean row = (DynaBean) rows.next();
　　 System.out.println("Account number is " +
　　 row.get("account_id") +
　　 " and name is " + row.get("name"));
　　 }
　　 rs.close();
　　 stmt.close();

　　RowSetDynaClass (Disconnected ResultSet as DynaBeans) - 使用 RowSet 的 Dynamic
　　JavaBean
　　API：
　　RowSetDynaClass(java.sql.ResultSet resultSet)
　　RowSetDynaClass(java.sql.ResultSet resultSet, boolean lowerCase)
　　 Connection conn = ...; // 从缓冲池取得连接
　　 Statement stmt = conn.createStatement();
　　 ResultSet rs = stmt.executeQuery("SELECT ...");
　　 RowSetDynaClass rsdc = new RowSetDynaClass(rs);
　　 rs.close();
　　 stmt.close();
　　 ...; //关闭连接返回缓冲池
　　 List rows = rsdc.getRows();
　　 ...; // 处理得到的行

　　3.BeanUtils.ConvertUtils 介绍
　　这个包主要用来转换从request传递过来的函数
　　主要函数：
　　ConvertUtils().convert(java.lang.Object value)
　　ConvertUtils().convert(java.lang.String[] values, java.lang.Class clazz)
　　ConvertUtils().convert(java.lang.String value, java.lang.Class clazz)
　　实现例子：
　　 HttpServletRequest request = ...;
　　 MyBean bean = ...;
　　 HashMap map = new HashMap();
　　 Enumeration names = request.getParameterNames();
　　 while (names.hasMoreElements()) {
　　 String name = (String) names.nextElement();
　　 map.put(name, request.getParameterValues(name));
　　 }
　　 BeanUtils.populate(bean, map);//用ConvertUtils进行转换
　　目前支持的转换类型：
　　sjava.lang.BigDecimal
　　java.lang.BigInteger
　　boolean and java.lang.Boolean
　　byte and java.lang.Byte
　　char and java.lang.Character
　　java.lang.Class
　　double and java.lang.Double
　　float and java.lang.Float
　　int and java.lang.Integer
　　long and java.lang.Long
　　short and java.lang.Short
　　java.lang.String
　　java.sql.Date
　　java.sql.Time
　　java.sql.Timestamp