一)此包的下载
[url]http://commons.apache.org/beanutils/download_beanutils.cgi[/url] 此包目前最新的版本是1.8.3
二)此包的功能
用于处理JavaBeans。它利用Java的反射机制,从动态的生成对bean的getter和setter的调用代码,到模拟创建一个动态的bean,等等。这个包看似简单,却是很多开源项目的基石:如在著名的Struts和Spring Framework中,我们都能找到BeanUtils的影子。
三)此包的API
[url]http://commons.apache.org/beanutils/v1.8.3/apidocs/index.html[/url]
从 1.7.0 版本开始 BeanUtils被细分成3种架包:
commons-beanutils.jar - 包含所有BeanUtils内容的架包
commons-beanutils-core.jar - 除去Collections内容的架包
commons-beanutils-bean-collections.jar - 仅有Collections内容的架包(此部分内容依赖于Commons Collections )
四)常用类:
DynaBean -- 该接口定义的是一个动态的JavaBean,它的属性类型、名称和值都是可以动态改变的。
DynaClass -- 该接口定义的是针对实现了DynaBean接口的类的java.lang.Class对象,提供如getName()、newInstance()等方法。
DynaProperty -- 用于描述DynaBean的属性
五)代码样例
我们来看看通常我们是怎样利用Commons BeanUtils来完成一些基本的JavaBean和DynaBean操作:
上述代码运行结果如下:
========= demoNormalJavaBeans ==========
The city of customer John Smith's first address is Los Angeles.
Setting zipcode ...
The zipcode of customer John Smith's second address is now 200000.
============ demoDynaBeans =============
name: Instant Noodles
inPrice: 21.3
outPrice: 23.8
[url]http://commons.apache.org/beanutils/download_beanutils.cgi[/url] 此包目前最新的版本是1.8.3
二)此包的功能
用于处理JavaBeans。它利用Java的反射机制,从动态的生成对bean的getter和setter的调用代码,到模拟创建一个动态的bean,等等。这个包看似简单,却是很多开源项目的基石:如在著名的Struts和Spring Framework中,我们都能找到BeanUtils的影子。
三)此包的API
[url]http://commons.apache.org/beanutils/v1.8.3/apidocs/index.html[/url]
从 1.7.0 版本开始 BeanUtils被细分成3种架包:
commons-beanutils.jar - 包含所有BeanUtils内容的架包
commons-beanutils-core.jar - 除去Collections内容的架包
commons-beanutils-bean-collections.jar - 仅有Collections内容的架包(此部分内容依赖于Commons Collections )
四)常用类:
DynaBean -- 该接口定义的是一个动态的JavaBean,它的属性类型、名称和值都是可以动态改变的。
DynaClass -- 该接口定义的是针对实现了DynaBean接口的类的java.lang.Class对象,提供如getName()、newInstance()等方法。
DynaProperty -- 用于描述DynaBean的属性
五)代码样例
/** Address.java */
package sean.study.commons.beanutils;
public class Address {
private String zipCode;
private String addr;
private String city;
private String country;
public Address() {}
public Address(String zipCode, String addr, String city, String country) {
this.zipCode = zipCode;
this.addr = addr;
this.city = city;
this.country = country;
}
public String getAddr() {
return addr;
}
public void setAddr(String addr) {
this.addr = addr;
}
public String getCity() {
return city;
}
public void setCity(String city) {
this.city = city;
}
public String getCountry() {
return country;
}
public void setCountry(String country) {
this.country = country;
}
public String getZipCode() {
return zipCode;
}
public void setZipCode(String zipCode) {
this.zipCode = zipCode;
}
}
/** Customer.java */
package sean.study.commons.beanutils;
public class Customer {
private long id;
private String name;
private Address[] addresses;
public Customer() {}
public Customer(long id, String name, Address[] addresses) {
this.id = id;
this.name = name;
this.addresses = addresses;
}
public Address[] getAddresses() {
return addresses;
}
public void setAddresses(Address[] addresses) {
this.addresses = addresses;
}
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
我们来看看通常我们是怎样利用Commons BeanUtils来完成一些基本的JavaBean和DynaBean操作:
package sean.study.commons.beanutils;
import org.apache.commons.beanutils.BasicDynaBean;
import org.apache.commons.beanutils.BasicDynaClass;
import org.apache.commons.beanutils.DynaBean;
import org.apache.commons.beanutils.DynaProperty;
import org.apache.commons.beanutils.PropertyUtils;
import org.apache.commons.lang.StringUtils;
public class BeanUtilsUsage {
public static void main(String[] args) throws Exception {
demoNormalJavaBeans();
demoDynaBeans();
}
public static void demoNormalJavaBeans() throws Exception {
System.out.println(StringUtils.center(" demoNormalJavaBeans ", 40, "="));
// data setup
Address addr1 = new Address("CA1234", "xxx", "Los Angeles", "USA");
Address addr2 = new Address("100000", "xxx", "Beijing", "China");
Address[] addrs = new Address[2];
addrs[0] = addr1;
addrs[1] = addr2;
Customer cust = new Customer(123, "John Smith", addrs);
// accessing the city of first address
String cityPattern = "addresses[0].city";
String name = (String) PropertyUtils.getSimpleProperty(cust, "name");
String city = (String) PropertyUtils.getProperty(cust, cityPattern);
Object[] rawOutput1 = new Object[] { "The city of customer ", name,
"'s first address is ", city, "." };
System.out.println(StringUtils.join(rawOutput1));
// setting the zipcode of customer's second address
String zipPattern = "addresses[1].zipCode";
if (PropertyUtils.isWriteable(cust, zipPattern)) {//PropertyUtils
System.out.println("Setting zipcode ...");
PropertyUtils.setProperty(cust, zipPattern, "200000");//PropertyUtils
}
String zip = (String) PropertyUtils.getProperty(cust, zipPattern);//PropertyUtils
Object[] rawOutput2 = new Object[] { "The zipcode of customer ", name,
"'s second address is now ", zip, "." };
System.out.println(StringUtils.join(rawOutput2));
System.out.println();
}
public static void demoDynaBeans() throws Exception {
System.out.println(StringUtils.center(" demoDynaBeans ", 40, "="));
// creating a DynaBean
DynaProperty[] dynaBeanProperties = new DynaProperty[] {//DynaProperty
new DynaProperty("name", String.class),
new DynaProperty("inPrice", Double.class),
new DynaProperty("outPrice", Double.class),
};
BasicDynaClass cargoClass = new BasicDynaClass("Cargo", BasicDynaBean.class, dynaBeanProperties); //BasicDynaClass BasicDynaBean
DynaBean cargo = cargoClass.newInstance();//DynaBean
// accessing a DynaBean
cargo.set("name", "Instant Noodles");
cargo.set("inPrice", new Double(21.3));
cargo.set("outPrice", new Double(23.8));
System.out.println("name: " + cargo.get("name"));
System.out.println("inPrice: " + cargo.get("inPrice"));
System.out.println("outPrice: " + cargo.get("outPrice"));
System.out.println();
}
}
上述代码运行结果如下:
========= demoNormalJavaBeans ==========
The city of customer John Smith's first address is Los Angeles.
Setting zipcode ...
The zipcode of customer John Smith's second address is now 200000.
============ demoDynaBeans =============
name: Instant Noodles
inPrice: 21.3
outPrice: 23.8