Hutool ObjectUtil 教程

一、简介Hutool 的ObjectUtil是一个对象操作工具类提供了一系列实用的对象处理方法包括判空、比较、默认值、序列化等。二、Maven依赖dependency groupIdcn.hutool/groupId artifactIdhutool-all/artifactId version5.8.25/version /dependency三、核心方法详解1. 判空方法import cn.hutool.core.util.ObjectUtil; // isNull - 判断对象是否为null String str null; ObjectUtil.isNull(str); // true // isNotNull - 判断对象是否不为null ObjectUtil.isNotNull(str); // false // isEmpty - 判断是否为空支持String、Collection、Map、Array等 ObjectUtil.isEmpty(null); // true ObjectUtil.isEmpty(); // true ObjectUtil.isEmpty(new int[0]); // true ObjectUtil.isEmpty(new ArrayList()); // true // isNotEmpty - 判断是否不为空 ObjectUtil.isNotEmpty(hello); // true // isNullOrDefault - 判断是否为null或默认值 ObjectUtil.isNullOrDefault(null, default); // true ObjectUtil.isNullOrDefault(test, default); // false2. 默认值处理// defaultIfNull - 如果为null则返回默认值 String value null; String result ObjectUtil.defaultIfNull(value, 默认值); System.out.println(result); // 默认值 // defaultIfEmpty - 如果为空则返回默认值 String emptyStr ; String result2 ObjectUtil.defaultIfEmpty(emptyStr, 默认值); System.out.println(result2); // 默认值 // 带Supplier的默认值懒加载 String result3 ObjectUtil.defaultIfNull(value, () - { // 只有在value为null时才会执行 return 懒加载默认值; });3. 对象比较// equals - 安全比较支持null ObjectUtil.equals(a, a); // true ObjectUtil.equals(null, a); // false ObjectUtil.equals(null, null); // true // notEqual - 判断是否不相等 ObjectUtil.notEqual(a, b); // true // compare - 对象比较实现Comparable接口 Integer a 10, b 20; ObjectUtil.compare(a, b); // -1 // 带null值处理的比较 ObjectUtil.compare(null, 5, true); // null被视为较小值 ObjectUtil.compare(null, 5, false); // null被视为较大值4. 对象克隆// clone - 克隆对象需实现Cloneable接口 public class User implements Cloneable { private String name; private int age; // getter/setter... Override public User clone() { try { return (User) super.clone(); } catch (CloneNotSupportedException e) { return null; } } } User user new User(张三, 25); User clonedUser ObjectUtil.clone(user); // cloneByStream - 通过流方式克隆深克隆需实现Serializable User user2 new User(李四, 30); User deepCloned ObjectUtil.cloneByStream(user2);5. 类型转换// typeConvert - 类型转换 Object value 123; Integer intValue ObjectUtil.typeConvert(value, Integer.class); System.out.println(intValue); // 123 // 复杂类型转换 ListString list ObjectUtil.typeConvert([1,2,3], List.class);6. 序列化// serialize - 序列化为字节数组 User user new User(王五, 28); byte[] bytes ObjectUtil.serialize(user); // deserialize - 反序列化 User deserializedUser ObjectUtil.deserialize(bytes); // 序列化为Base64字符串 String base64Str ObjectUtil.serialize(user, true); User userFromBase64 ObjectUtil.deserialize(base64Str, User.class);7. 获取对象信息// length - 获取对象长度支持String、Collection、Map、Array ObjectUtil.length(hello); // 5 ObjectUtil.length(new int[3]); // 3 ObjectUtil.length(new ArrayList()); // 0 // contains - 检查元素是否包含支持String、Collection、Map、Array ObjectUtil.contains(hello, e); // true ObjectUtil.contains(Arrays.asList(1,2,3), 2); // true // getClassName - 获取类名不包含包名 ObjectUtil.getClassName(new User()); // User // getType - 获取对象实际类型 Class? type ObjectUtil.getType(new User()); // User.class8. 字符串表示// toString - 安全的toStringnull返回null ObjectUtil.toString(null); // null ObjectUtil.toString(hello); // hello // toStringOrNull - null返回null否则返回toString ObjectUtil.toStringOrNull(null); // null ObjectUtil.toStringOrNull(123); // 123 // identityToString - 返回对象的identity string类名hashCode ObjectUtil.identityToString(new User()); // User7b23ec81四、综合示例import cn.hutool.core.util.ObjectUtil; import java.util.*; public class ObjectUtilDemo { public static void main(String[] args) { // 1. 安全获取值 String data getData(); String safeData ObjectUtil.defaultIfEmpty(data, 默认数据); System.out.println(安全数据: safeData); // 2. 条件判断 ListString list null; if (ObjectUtil.isEmpty(list)) { list new ArrayList(); list.add(初始化数据); } // 3. 对象比较 User user1 new User(张三, 25); User user2 new User(张三, 25); if (ObjectUtil.equals(user1.getName(), user2.getName())) { System.out.println(用户名相同); } // 4. 深克隆 User original new User(原对象, 30); User cloned ObjectUtil.cloneByStream(original); System.out.println(克隆对象: cloned.getName()); // 5. 链式判空 String result ObjectUtil.defaultIfNull( getNullableValue(), () - { // 复杂的默认值计算逻辑 return 计算出的默认值; } ); } private static String getData() { // 模拟可能返回null的方法 return null; } private static String getNullableValue() { return Math.random() 0.5 ? 有值 : null; } } class User implements java.io.Serializable { private String name; private int age; // 构造函数、getter、setter... public User(String name, int age) { this.name name; this.age age; } public String getName() { return name; } public void setName(String name) { this.name name; } }五、最佳实践1. 避免空指针异常// 不推荐 if (obj ! null obj.toString().length() 0) { } // 推荐 if (ObjectUtil.isNotEmpty(obj.toString())) { }2. 优雅的默认值处理// 多层默认值 String value ObjectUtil.defaultIfNull( firstChoice, ObjectUtil.defaultIfNull(secondChoice, defaultValue) );3. 结合Optional使用Optional.ofNullable(getValue()) .filter(ObjectUtil::isNotEmpty) .orElseGet(() - 默认值);六、注意事项序列化要求使用cloneByStream需要对象实现Serializable接口性能考虑cloneByStream性能低于clone适用于深克隆场景null安全所有方法都做了null处理可放心使用类型转换typeConvert可能抛出转换异常需自行处理七、总结ObjectUtil提供了丰富的对象操作方法能有效简化代码、避免空指针异常。建议在实际开发中优先使用这些工具方法而不是自己重复实现判空、比较等逻辑。