在Java开发中,将对象转换为字符串是高频操作,当对象为null时直接调用toString方法会触发NullPointerException,影响程序正常运行。Java的Objects工具类提供了重载的toString方法,支持为null对象指定默认显示内容,能够优雅地解决这类问题。
Objects.toString() 方法的基本定义
Objects类位于java.util包下,是Java 7引入的实用工具类,其中的toString方法有两个重载版本,具体定义如下:
// 第一个重载:仅接收待转换的对象,null时返回"null"字符串
public static String toString(Object o) {
return String.valueOf(o);
}
// 第二个重载:接收待转换对象和默认显示值,null时返回默认显示值
public static String toString(Object o, String nullDefault) {
return (o != null) ? o.toString() : nullDefault;
}
第二个重载方法就是我们设置null对象默认友好显示的核心方法,当传入的对象o为null时,会直接返回我们指定的nullDefault参数,避免空指针异常。
基础使用示例
下面通过一个简单的示例展示如何使用该方法设置null对象的默认显示:
import java.util.Objects;
public class ObjectsToStringDemo {
public static void main(String[] args) {
String validStr = "正常字符串";
String nullStr = null;
// 对象不为null时,返回对象自身的toString结果
String result1 = Objects.toString(validStr, "默认空值");
System.out.println(result1); // 输出:正常字符串
// 对象为null时,返回我们设置的默认值
String result2 = Objects.toString(nullStr, "该变量暂无数据");
System.out.println(result2); // 输出:该变量暂无数据
// 对比直接调用toString的情况,会抛出空指针异常
// String result3 = nullStr.toString(); // 运行时报错:NullPointerException
}
}
自定义对象的场景应用
对于自定义类的对象,Objects.toString同样适用,默认显示值可以根据业务需求灵活设置:
import java.util.Objects;
// 自定义用户类
class User {
private String name;
private Integer age;
public User(String name, Integer age) {
this.name = name;
this.age = age;
}
@Override
public String toString() {
return "User{name='" + name + "', age=" + age + "}";
}
}
public class CustomObjectDemo {
public static void main(String[] args) {
User user = new User("张三", 20);
User nullUser = null;
// 正常对象返回自身的toString结果
System.out.println(Objects.toString(user, "未查询到用户信息"));
// 输出:User{name='张三', age=20}
// null对象返回自定义默认提示
System.out.println(Objects.toString(nullUser, "未查询到用户信息"));
// 输出:未查询到用户信息
}
}
与传统null判断写法的对比
在Objects.toString出现之前,我们通常需要手动写null判断逻辑来避免空指针,两种写法的对比如下:
| 实现方式 | 代码示例 | 优势 |
|---|---|---|
| 传统null判断 | String result = obj == null ? "默认显示" : obj.toString(); | 逻辑直观,兼容Java 7之前的版本 |
| Objects.toString方式 | String result = Objects.toString(obj, "默认显示"); | 代码更简洁,减少重复判断逻辑,可读性更高 |
注意事项
- 设置的默认显示值本身可以为null,此时如果对象也为null,会返回null而不是抛出异常,需要根据业务场景判断是否允许这种情况。
- Objects.toString的第一个重载方法(仅传对象参数的版本)在对象为null时会返回字符串"null",而不是空指针,和直接调用
String.valueOf行为一致。 - 如果对象的
toString方法被重写后返回null,那么即使对象不为null,Objects.toString也会返回该对象toString的结果null,不会触发默认值的逻辑,因为默认值仅在对象本身为null时生效。
Objects.toString方法是Java提供的轻量型空安全工具方法,合理使用可以减少冗余的null判断代码,提升代码的简洁性和可维护性,非常适合在需要对象转字符串且需要兼容null场景的业务中使用。
Objects.toString()Javanull默认值友好显示对象转字符串修改时间:2026-07-15 22:36:52