BeanUtil工具类

BeanUtil 通常是指 Java 开发中用于操作 JavaBean 的工具类，常见于 Apache Commons BeanUtils 库或 Spring 框架中。下面将从功能、用法和示例等方面详细介绍：

一、Apache Commons BeanUtils 中的 BeanUtil

1. 功能概述

Apache Commons BeanUtils 是 Apache 提供的工具库，其中 BeanUtils 类提供了以下核心功能：

• 属性操作：读写 JavaBean 的属性（通过 getter/setter 方法）
• 对象复制：将一个对象的属性值复制到另一个对象
• 类型转换：支持基本类型、字符串等的自动转换
• 动态创建对象：通过反射创建 Bean 实例

2. 核心方法示例

// 引入依赖
<dependency>
    <groupId>commons-beanutils</groupId>
    <artifactId>commons-beanutils</artifactId>
    <version>1.9.4</version>
</dependency>

// 示例 JavaBean
class User {
    private String name;
    private int age;
    // 构造方法、getter 和 setter 省略
}

// 示例用法
import org.apache.commons.beanutils.BeanUtils;
import org.apache.commons.beanutils.ConvertUtils;
import org.apache.commons.beanutils.converters.IntegerConverter;

public class BeanUtilDemo {
    public static void main(String[] args) throws Exception {
        // 1. 获取和设置属性
        User user = new User();
        BeanUtils.setProperty(user, "name", "张三");
        BeanUtils.setProperty(user, "age", "25"); // 自动转换字符串到int
        
        String name = BeanUtils.getProperty(user, "name");
        int age = Integer.parseInt(BeanUtils.getProperty(user, "age"));
        System.out.println("姓名：" + name + "，年龄：" + age);
        
        // 2. 复制对象属性
        User user2 = new User();
        BeanUtils.copyProperties(user2, user);
        System.out.println("user2姓名：" + BeanUtils.getProperty(user2, "name"));
        
        // 3. 类型转换配置（自定义转换）
        ConvertUtils.register(new IntegerConverter(null), Integer.class);
        String ageStr = BeanUtils.getProperty(user, "age");
        int ageVal = (Integer) ConvertUtils.convert(ageStr, Integer.class);
        System.out.println("转换后的年龄：" + ageVal);
        
        // 4. 动态创建对象
        Object newUser = BeanUtils.instantiate(User.class);
        if (newUser instanceof User) {
            System.out.println("动态创建对象成功");
        }
    }
}

二、Spring 框架中的 BeanUtils

1. 功能对比

Spring 提供的 BeanUtils（org.springframework.beans.BeanUtils）是对 Apache 版本的封装和优化，主要区别：

• 性能更优：使用反射优化，避免 Apache 版本的包装类开销
• 类型安全：支持泛型和更严格的类型检查
• 无依赖：无需引入额外依赖（Spring 核心库已包含）

2. 核心方法示例

import org.springframework.beans.BeanUtils;

public class SpringBeanUtilDemo {
    public static void main(String[] args) {
        // 示例 Bean
        class Source {
            private String name;
            private int age;
            // getter 和 setter 省略
        }
        
        class Target {
            private String name;
            private Integer age; // 不同类型示例
            // getter 和 setter 省略
        }
        
        // 1. 复制对象属性（自动类型转换）
        Source source = new Source();
        source.setName("李四");
        source.setAge(30);
        
        Target target = new Target();
        BeanUtils.copyProperties(source, target);
        
        System.out.println("目标对象姓名：" + target.getName());
        System.out.println("目标对象年龄：" + target.getAge()); // 自动转换 int → Integer
        
        // 2. 获取属性描述符（用于反射操作）
        java.beans.PropertyDescriptor pd = BeanUtils.getPropertyDescriptor(Target.class, "name");
        System.out.println("属性类型：" + pd.getPropertyType());
        
        // 3. 复制属性时忽略特定字段
        BeanUtils.copyProperties(source, target, "age"); // 忽略age字段
    }
}

三、常见应用场景

1. DTO 转换：将 Entity 对象转换为 DTO（数据传输对象）

   UserEntity entity = userRepository.findById(1);
   UserDTO dto = new UserDTO();
   BeanUtils.copyProperties(entity, dto);
   

2. 表单数据绑定：将请求参数绑定到 Bean

   HttpServletRequest request = ...;
   UserForm form = new UserForm();
   BeanUtils.populate(form, request.getParameterMap());
   

3. 动态属性操作：在框架底层用于反射操作 Bean

   // 动态获取属性值
   Object value = BeanUtils.getProperty(bean, "propertyName");
   

四、性能注意事项

1. Apache vs Spring：

   • Apache BeanUtils 因使用 java.lang.reflect 和包装类，性能较差
   • Spring BeanUtils 优化了反射调用，性能更好（推荐使用）

2. 大规模对象转换：

   • 对于大量对象转换，考虑使用 MapStruct 等编译时映射工具，性能比反射高 10-100 倍
   • 示例：

     @Mapper
     public interface UserMapper {
         UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);
         UserDTO entityToDto(UserEntity entity);
     }
     

五、总结

BeanUtil 是 Java 开发中操作 Bean 的实用工具，根据场景选择：

• 简单场景：使用 Spring BeanUtils（性能好、无依赖）
• 复杂类型转换：使用 Apache BeanUtils（支持更多转换器）
• 高性能需求：使用 MapStruct 等专用映射工具

实际开发中，建议优先使用 Spring BeanUtils，如需更灵活的类型转换，可结合 Apache 的转换器一起使用。