java Boolean.toString将布尔值对象转换为对应的字符串

方法定义

Boolean.toString() 是 Java 中 Boolean 类提供的静态方法，用于将布尔值（boolean 或 Boolean 对象）转换为对应的字符串表示。

重载方法

Boolean 类提供了两个重载的 toString 方法：

public static String toString(boolean b)
接收一个原始类型 boolean 值，返回其字符串表示。
public String toString()（实例方法）
Boolean 对象实例调用，返回该对象所代表的布尔值的字符串形式。

功能说明

将 true 转换为字符串 "true"。
将 false 转换为字符串 "false"。
主要用于布尔值的字符串化输出、日志记录、JSON 序列化等场景。

示例代码

示例 1：静态方法 `toString(boolean b)`

public class BooleanToStringExample {
    public static void main(String[] args) {
        boolean flag = true;
        String str = Boolean.toString(flag);
        System.out.println(str); // 输出: true

        boolean anotherFlag = false;
        System.out.println(Boolean.toString(anotherFlag)); // 输出: false
    }
}

示例 2：实例方法 `toString()`

public class BooleanInstanceExample {
    public static void main(String[] args) {
        Boolean boolObj = Boolean.TRUE;
        System.out.println(boolObj.toString()); // 输出: true

        Boolean anotherObj = new Boolean(false);
        System.out.println(anotherObj.toString()); // 输出: false
    }
}

示例 3：与字符串拼接结合使用

public class ConcatenationExample {
    public static void main(String[] args) {
        boolean isActive = true;
        String message = "User is active: " + Boolean.toString(isActive);
        System.out.println(message); // 输出: User is active: true
    }
}

使用技巧

替代字符串拼接自动调用
在字符串拼接中，Java 会自动调用 toString()，但显式使用 Boolean.toString() 可提高可读性和性能（避免装箱）。

// 推荐：显式调用
String result = "Result: " + Boolean.toString(success);

// 不推荐：依赖自动装箱和 toString()
String result = "Result: " + success; // 隐式调用 Boolean.valueOf(success).toString()

与三元运算符对比
Boolean.toString() 更简洁、语义清晰，避免冗长的三元表达式。
```
// 推荐
String str = Boolean.toString(flag);

// 不推荐
String str = flag ? "true" : "false";
```

日志输出中使用

boolean isValid = validateInput();
logger.debug("Validation result: {}", Boolean.toString(isValid));

常见错误

对 null 的 Boolean 对象调用 toString()

Boolean nullableBool = null;
// 错误：抛出 NullPointerException
String str = nullableBool.toString();

修正方法：

String str = nullableBool != null ? nullableBool.toString() : "null";
// 或使用 Objects.toString()
String str = Objects.toString(nullableBool, "null");

混淆静态方法与实例方法
- 错误地对原始 boolean 调用实例方法（编译错误）：
```
boolean b = true;
b.toString(); // 编译错误：原始类型无方法
```

注意事项

返回值是小写字符串
Boolean.toString(true) 返回 "true"，不是 "True" 或 "TRUE"。
null 安全性
静态方法 toString(boolean b) 接收原始类型，不会出现 null 问题；但实例方法 toString() 在 Boolean 对象为 null 时会抛出异常。
性能考虑
Boolean.toString(boolean) 是静态方法，不涉及对象创建，性能优于 new Boolean(b).toString()。

最佳实践与性能优化

优先使用静态方法 Boolean.toString(boolean)
避免不必要的对象创建，提升性能。
避免 new Boolean(...) 构造函数
该构造函数已过时（deprecated），应使用 Boolean.valueOf(boolean) 或直接使用原始类型。
```
// 推荐
Boolean b = Boolean.valueOf(true);
String s = b.toString();

// 不推荐（且已过时）
Boolean b = new Boolean(true);
```
在高频率调用场景中缓存结果（极少需要）
由于 true 和 false 的字符串形式是固定的，但 Boolean.toString() 本身已高效，通常无需手动缓存。
使用 String.valueOf(boolean) 作为替代
String.valueOf(boolean) 内部调用 Boolean.toString(boolean)，功能一致，可互换使用。
```
String s1 = Boolean.toString(true);
String s2 = String.valueOf(true); // 等效
```

日志框架中使用占位符避免不必要的字符串转换

// 推荐：仅当日志级别启用时才执行 toString
logger.debug("Flag value: {}", flag);

// 不推荐：总是执行 toString，即使不输出
logger.debug("Flag value: " + Boolean.toString(flag));

总结

项目	说明
核心功能	将 `boolean` 值转换为 `"true"` 或 `"false"` 字符串
推荐方法	`Boolean.toString(boolean b)`（静态方法）
性能	高效，无对象创建开销
安全性	注意 `null` 的 `Boolean` 对象调用实例方法会抛出异常
最佳实践	使用静态方法、避免 `new Boolean()`、结合日志占位符
替代方案	`String.valueOf(boolean)` 功能等价

一句话总结：
Boolean.toString() 是将布尔值安全、高效转换为字符串的标准方法，推荐在需要显式字符串化的场景中使用静态版本，注意 null 安全性，并结合日志框架的占位符机制优化性能。