org.apache.commons.beanutils.BeanUtils包的具体用法

介绍了BeanUtils工具类中的copyProperties方法,该方法能够简化JavaBean之间的属性复制过程,尤其适用于具有大量相同属性的对象。文章对比了使用该方法前后代码的差异,并提到了其类型转换功能及使用时需要注意的问题。
 
BeanUtils简读本

一、简介:

BeanUtils提供对 Java反射和自省API的包装。其主要目的是利用反射机制对JavaBean的属性进行处理。我们知道,一个JavaBean通常包含了大量的属性,很多情况下,对JavaBean的处理导致大量get/set代码堆积,增加了代码长度和阅读代码的难度。

二、用法:

BeanUtils是这个包里比较常用的一个工具类,这里只介绍它的copyProperties()方法。该方法定义如下:

public static void copyProperties(java.lang.Object dest,java.lang.Object orig)
  throws java.lang.IllegalAccessException,
         java.lang.reflect.InvocationTargetException


如果你有两个具有很多相同属性的JavaBean,一个很常见的情况就是Struts里的PO对象(持久对象)和对应的ActionForm,例如 Teacher和TeacherForm。我们一般会在Action里从ActionForm构造一个PO对象,传统的方式是使用类似下面的语句对属性逐个赋值:

//得到TeacherForm
TeacherForm teacherForm=(TeacherForm)form;
//构造Teacher对象
Teacher teacher=new Teacher();
//赋值
teacher.setName(teacherForm.getName());
teacher.setAge(teacherForm.getAge());
teacher.setGender(teacherForm.getGender());
teacher.setMajor(teacherForm.getMajor());
teacher.setDepartment(teacherForm.getDepartment());

//持久化Teacher对象到数据库
HibernateDAO=;
HibernateDAO.save(teacher);

而使用BeanUtils后,代码就大大改观了,如下所示:
//得到TeacherForm
TeacherForm teacherForm=(TeacherForm)form;
//构造Teacher对象
Teacher teacher=new Teacher();
//赋值
BeanUtils.copyProperties(teacher,teacherForm);
//持久化Teacher对象到数据库
HibernateDAO=;
HibernateDAO.save(teacher);


如果Teacher和TeacherForm间存在名称不相同的属性,则BeanUtils不对这些属性进行处理,需要程序员手动处理。例如 Teacher包含modifyDate(该属性记录最后修改日期,不需要用户在界面中输入)属性而TeacherForm无此属性,那么在上面代码的 copyProperties()后还要加上一句:

teacher.setModifyDate(new Date());


怎么样,很方便吧!除BeanUtils外还有一个名为PropertyUtils的工具类,它也提供copyProperties()方法,作用与BeanUtils的同名方法十分相似,主要的区别在于后者提供类型转换功能,即发现两个JavaBean的同名属性为不同类型时,在支持的数据类型范围内进行转换,而前者不支持这个功能,但是速度会更快一些。BeanUtils支持的转换类型如下:

    * java.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


这里要注意一点,java.util.Date是不被支持的,而它的子类java.sql.Date是被支持的。因此如果对象包含时间类型的属性,且希望被转换的时候,一定要使用java.sql.Date类型。否则在转换时会提示argument mistype异常。

三、优缺点:

Apache Jakarta Commons项目非常有用。我曾在许多不同的项目上或直接或间接地使用各种流行的commons组件。其中的一个强大的组件就是BeanUtils。我将说明如何使用BeanUtils将local实体bean转换为对应的value 对象:


BeanUtils.copyProperties(aValue, aLocal)


上面的代码从aLocal对象复制属性到aValue对象。它相当简单!它不管local(或对应的value)对象有多少个属性,只管进行复制。我们假设local对象有100个属性。上面的代码使我们可以无需键入至少100行的冗长、容易出错和反复的get和set方法调用。这太棒了!太强大了!太有用了!

现在,还有一个坏消息:使用BeanUtils的成本惊人地昂贵!我做了一个简单的测试,BeanUtils所花费的时间要超过取数据、将其复制到对应的 value对象(通过手动调用get和set方法),以及通过串行化将其返回到远程的客户机的时间总和。所以要小心使用这种威力!
<think> 我们正在解决用户关于`org.apache.commons.beanutils.BeanUtils`依赖的问题。用户提到自己下载了jar,但运行时出现了`java.lang.NoClassDefFoundError`。这通常意味着编译时找到了类,但运行时类路径(classpath)中缺少相应的jar。 根据用户提供的引用[1]和[2],问题可能涉及到两个不同的Apache Commons组件: - `commons-beanutils`: 含`BeanUtils`类 - `commons-lang`: 含`NestableRuntimeException`类(在引用[2]中缺失) 用户遇到的错误是: 1. 编译通过,但运行时报`java.lang.NoClassDefFoundError: org/apache/commons/beanutils/BeanUtils` -> 说明运行时缺少`commons-beanutils`的jar。 2. 另外引用[2]提到`org.apache.commons.lang.exception.NestableRuntimeException`找不到,这属于`commons-lang`。 因此,我们需要确保两个依赖都正确引入。 ### 解决方案 #### 1. Maven项目 如果是Maven项目,在`pom.xml`中添加以下依赖: ```xml <dependencies> <!-- BeanUtils 核心依赖 --> <dependency> <groupId>commons-beanutils</groupId> <artifactId>commons-beanutils</artifactId> <version>1.9.4</version> </dependency> <!-- 可选的,如果还需要commons-lang --> <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> <version>2.6</version> </dependency> </dependencies> ``` #### 2. 手动添加JAR 如果手动管理JAR,需要下载以下两个JAR并添加到项目的类路径中: - [commons-beanutils-1.9.4.jar](https://commons.apache.org/proper/commons-beanutils/download_beanutils.cgi) - [commons-lang-2.6.jar](https://commons.apache.org/proper/commons-lang/download_lang.cgi) 注意:`commons-beanutils`还依赖`commons-logging`,所以可能还需要下载[commons-logging](https://commons.apache.org/proper/commons-logging/download_logging.cgi)。 #### 3. 解决类路径问题 确保下载的JAR已经正确添加到项目的类路径中。在IDE(如Eclipse或IntelliJ IDEA)中,需要将JAR添加到项目的构建路径(Build Path)中。 ### 验证 添加依赖后,尝试运行以下测试代码: ```java import org.apache.commons.beanutils.BeanUtils; public class TestBeanUtils { public static void main(String[] args) { try { // 创建一个测试对象 Object object = new Object(); // 使用BeanUtils的简单方法,比如复制属性(这里仅测试类加载) System.out.println("BeanUtils loaded successfully!"); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 常见问题 1. **版本冲突**:如果项目中其他依赖使用了不同版本的`commons-beanutils`或`commons-lang`,可能需要排除冲突的版本。 2. **依赖传递**:如果使用Maven,注意依赖传递可能会引入多个版本,可以通过`<exclusions>`排除。 ### 引用说明 在引用[2]中提到的`ClassNotFoundException: org.apache.commons.lang.exception.NestableRuntimeException`,这个类实际上在`commons-lang`的较老版本(2.x)中。注意,在`commons-lang3`中,名改为`org.apache.commons.lang3`,且移除了`NestableRuntimeException`。因此,如果你使用的是`commons-lang3`,那么需要确保代码中引用的名正确。 如果项目已经升级到`commons-lang3`,但是某个依赖仍然需要`commons-lang`(老版本),则可以同时引入两个依赖,因为它们的名不同。 ### 总结 - 确保`commons-beanutils`的JAR在运行时类路径中。 - 根据错误提示,可能还需要`commons-lang`(老版本)的JAR。 - 使用构建工具(如Maven)可以自动处理依赖关系,避免手动管理。 §§相关问题§§ 1. 如何解决Java中的NoClassDefFoundError错误? 2. Maven项目中如何排除传递依赖? 3. commons-lang和commons-lang3有什么区别? 4. 如何在IntelliJ IDEA中添加外部JAR? </think>### `org.apache.commons.beanutils.BeanUtils`依赖信息 #### 1. **Maven依赖配置** ```xml <dependency> <groupId>commons-beanutils</groupId> <artifactId>commons-beanutils</artifactId> <version>1.9.4</version> </dependency> ``` **最新版本**:截至2023年,最新稳定版为`1.9.4`([官方仓库](https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils)) --- #### 2. **Gradle依赖配置** ```groovy implementation 'commons-beanutils:commons-beanutils:1.9.4' ``` --- ### 常见问题解决方案 #### 问题1:`NoClassDefFoundError: BeanUtils` **原因**:运行时缺少依赖或依赖冲突 **解决**: 1. 检查是否含所有传递依赖: ```xml <!-- 必须同时引入这些依赖 --> <dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>commons-collections</groupId> <artifactId>commons-collections</artifactId> <version>3.2.2</version> </dependency> ``` 2. 使用`mvn dependency:tree`检查版本冲突 --- #### 问题2:`ClassNotFoundException: NestableRuntimeException` **原因**:老版本`commons-lang`缺失(引用[2]) **解决方案**: ```xml <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> <version>2.6</version> <!-- 注意不是lang3 --> </dependency> ``` --- ### 替代方案(避免依赖问题) #### 使用Spring BeanWrapper ```java import org.springframework.beans.BeanWrapper; import org.springframework.beans.BeanWrapperImpl; Map<String, Object> map = ...; Object target = new YourBean(); BeanWrapper wrapper = new BeanWrapperImpl(target); map.forEach((key, value) -> { if (wrapper.isWritableProperty(key)) { wrapper.setPropertyValue(key, value); } }); ``` **优势**:无需额外依赖(Spring项目自带) --- ### 完整使用示例 ```java import org.apache.commons.beanutils.BeanUtils; public class User { private String name; private int age; // getters/setters } public static void main(String[] args) { Map<String, Object> map = new HashMap<>(); map.put("name", "John"); map.put("age", 30); User user = new User(); BeanUtils.populate(user, map); // 自动注入属性 } ``` > **注意**: > 1. Map的key必须与对象属性名**严格匹配**(括大小写) > 2. 基本类型需手动转换(如String→int) > 3. 推荐使用`BeanUtils.copyProperties()`避免类型问题
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值