Class BeanUtil

java.lang.Object
com.sure.tool.bean.BeanUtil

public class BeanUtil extends Object
Bean 属性操作工具类:属性拷贝、Bean/Map 互转、属性读写,参考 Hutool 的 BeanUtil 设计。

English: JavaBean property reading, writing and map-to-bean conversion.

Since:
0.1.0
Author:
suretool
  • Method Details

    • getBeanDesc

      public static BeanDesc getBeanDesc(Class<?> clazz)
      获取 Bean 描述(带缓存)。
      Parameters:
      clazz - Bean 类
      Returns:
      Bean 描述
    • copyProperties

      public static <T> T copyProperties(Object source, T target, String... ignoreProperties)
      拷贝属性(不忽略 null 值)。
      Type Parameters:
      T - 目标类型
      Parameters:
      source - 源对象
      target - 目标对象
      ignoreProperties - 忽略的属性名
      Returns:
      目标对象
    • copyProperties

      public static <T> T copyProperties(Object source, T target, boolean ignoreNullValue, String... ignoreProperties)
      拷贝属性,支持类型转换(如 String 转 int)。
      Type Parameters:
      T - 目标类型
      Parameters:
      source - 源对象
      target - 目标对象
      ignoreNullValue - 是否忽略值为 null 的属性
      ignoreProperties - 忽略的属性名
      Returns:
      目标对象
    • beanToMap

      public static Map<String,Object> beanToMap(Object bean)
      Bean 转 Map(不忽略 null 值)。
      Parameters:
      bean - Bean 对象
      Returns:
      Map
    • beanToMap

      public static Map<String,Object> beanToMap(Object bean, boolean ignoreNullValue)
      Bean 转 Map。
      Parameters:
      bean - Bean 对象
      ignoreNullValue - 是否忽略值为 null 的属性
      Returns:
      Map
    • mapToBean

      public static <T> T mapToBean(Map<String, ? extends Object> map, Class<T> beanClass)
      Map 转 Bean(自动实例化并写入属性,带类型转换)。
      Type Parameters:
      T - Bean 类型
      Parameters:
      map - Map
      beanClass - Bean 类
      Returns:
      Bean 实例
    • getProperty

      public static Object getProperty(Object bean, String name)
      读取属性值。
      Parameters:
      bean - Bean 对象
      name - 属性名
      Returns:
      属性值
    • setProperty

      public static void setProperty(Object bean, String name, Object value)
      写入属性值(带类型转换)。
      Parameters:
      bean - Bean 对象
      name - 属性名
      value - 属性值
    • toBean

      public static <T> T toBean(Object source, Class<T> beanClass)
      对象转 Bean:Map 走 mapToBean(Map, Class),普通 Bean 走 copyProperties(Object, T, String...),其他类型返回原对象。
      Type Parameters:
      T - Bean 类型
      Parameters:
      source - 源对象(Map 或 Bean)
      beanClass - 目标 Bean 类
      Returns:
      转换后的 Bean;源为 null 返回 null
    • isBean

      public static boolean isBean(Class<?> clazz)
      判断是否为可操作 Bean(非基础类型、非容器、非日期等)。
      Parameters:
      clazz - 类
      Returns:
      是否 Bean
    • deepCopy

      public static <T> T deepCopy(T source)
      深拷贝:递归复制 Bean / Map / List / Set / 数组 / 不可变值类型。

      规则:基本类型、包装类型、String、枚举、Date 直接返回原引用(不可变或无需拷贝); 集合与 Map 逐元素深拷贝;数组逐元素深拷贝;其余按 Bean 处理(无参构造 + 属性拷贝)。

      注意:循环引用不处理(会栈溢出),请勿对存在环的对象图调用。

      Type Parameters:
      T - 类型
      Parameters:
      source - 源对象
      Returns:
      深拷贝结果,入参为 null 时返回 null
    • fill

      public static <T> T fill(T bean, Map<String,Object> map)
      用 Map 填充 Bean 属性(值为 null 的键跳过,不覆盖已有值)。
      Type Parameters:
      T - Bean 类型
      Parameters:
      bean - Bean
      map - 属性名-值
      Returns:
      Bean 本身
    • copyToList

      public static <T> List<T> copyToList(Collection<?> collection, Class<T> targetClass)
      将对象集合复制为指定 Bean 类型的列表(深复制,忽略源 null 值)。
      Type Parameters:
      T - 目标 Bean 类型
      Parameters:
      collection - 源对象集合(元素可为 Bean 或 Map)
      targetClass - 目标 Bean 类
      Returns:
      新列表;输入为 null 返回 null,元素转换失败返回 null 元素
    • copyToList

      public static <T> List<T> copyToList(Collection<?> collection, Class<T> targetClass, boolean ignoreNullValue)
      将对象集合复制为指定 Bean 类型的列表。
      Type Parameters:
      T - 目标 Bean 类型
      Parameters:
      collection - 源对象集合(元素可为 Bean 或 Map)
      targetClass - 目标 Bean 类
      ignoreNullValue - 是否忽略源 null 值属性
      Returns:
      新列表;输入为 null 返回 null,元素转换失败返回 null 元素
    • toBean

      public static <T> T toBean(Object source, Class<T> beanClass, boolean ignoreNullValue)
      对象转 Bean,可指定是否忽略源 null 值。
      Type Parameters:
      T - 目标 Bean 类型
      Parameters:
      source - 源对象(Map 或 Bean)
      beanClass - 目标 Bean 类
      ignoreNullValue - 是否忽略 null 值属性
      Returns:
      转换后的 Bean;源为 null 返回 null
    • mapToBean

      public static <T> T mapToBean(Map<String, ? extends Object> map, Class<T> beanClass, boolean ignoreError)
      Map 转 Bean,可指定是否忽略转换异常(出错属性跳过)。
      Type Parameters:
      T - Bean 类型
      Parameters:
      map - Map
      beanClass - Bean 类
      ignoreError - 是否忽略属性转换异常
      Returns:
      Bean 实例