java Integer.decode将字符串解析为 `Integer` 对象,支持十进制、十六进制、八进制等多种进制格式

Integer.decode() 是 Java 中用于将字符串解析为 Integer 对象的静态方法，支持十进制、十六进制、八进制等多种进制格式的自动识别与转换。它比 Integer.parseInt() 更灵活，适用于解析用户输入或配置文件中的混合进制整数。

---

一、方法定义

public static Integer decode(String nm) throws NumberFormatException

• 所属类：java.lang.Integer
• 访问修饰符：public static
• 参数：String nm —— 要解析的字符串（可包含进制前缀）
• 返回值：解析成功的 Integer 对象
• 异常：NumberFormatException（格式错误）、NullPointerException（输入为 null）

✅ 该方法继承自 Number 类的设计理念，支持多种数字格式的“智能解码”。

---

二、功能说明

Integer.decode() 能自动识别以下格式的字符串并转换为对应的整数值：

格式	示例	说明
十进制	"123"	普通数字，可带正负号
十六进制	"0x1A"、"0Xff"、"#10"	以 0x、0X 或 # 开头
八进制	"017"	以 0 开头（传统 Unix 风格）
二进制（不支持）	❌	Java 原生不支持 0b 前缀在此方法中

📌 自动处理符号：

• 支持前导 + 或 -
• 例如："-0xFF" → -255

---

三、示例代码

示例 1：基本十进制解析

Integer num = Integer.decode("100");
System.out.println(num); // 输出：100

示例 2：十六进制解析（0x 和 #）

System.out.println(Integer.decode("0x1F"));   // 输出：31
System.out.println(Integer.decode("0XFF"));   // 输出：255
System.out.println(Integer.decode("#A0"));    // 输出：160

示例 3：八进制解析（以 0 开头）

System.out.println(Integer.decode("010"));    // 输出：8  (1×8¹ + 0×8⁰)
System.out.println(Integer.decode("077"));    // 输出：63

示例 4：带符号的数值

System.out.println(Integer.decode("-123"));   // 输出：-123
System.out.println(Integer.decode("+255"));   // 输出：255
System.out.println(Integer.decode("-0x10"));  // 输出：-16
System.out.println(Integer.decode("-010"));   // 输出：-8

示例 5：组合使用场景

// 模拟配置文件读取
String[] inputs = {"100", "0x20", "0377", "-255", "#FF"};

for (String s : inputs) {
    try {
        Integer value = Integer.decode(s);
        System.out.printf("%s -> %d%n", s, value);
    } catch (NumberFormatException e) {
        System.err.println("解析失败: " + s);
    }
}

输出：

100 -> 100
0x20 -> 32
0377 -> 255
-255 -> -255
#FF -> 255

---

四、使用技巧

1. 与 parseInt 对比：自动识别进制

// ❌ parseInt 需要手动指定进制
Integer.parseInt("0xFF", 16); // 必须指定 radix=16

// ✅ decode 自动识别
Integer.decode("0xFF");       // 自动按十六进制解析

2. 处理用户输入或配置项

非常适合解析来自命令行、配置文件、UI 输入的混合格式整数。

// 用户可能输入 100, 0x64, 0144 等表示 100
String input = getUserInput();
try {
    Integer value = Integer.decode(input.trim());
    System.out.println("解析结果: " + value);
} catch (NumberFormatException e) {
    System.err.println("输入格式无效，请输入有效整数（支持 0x、0 等前缀）");
}

3. 结合系统属性使用

String portStr = System.getProperty("server.port", "8080");
int port = Integer.decode(portStr); // 支持 0x1F90 等形式

---

五、常见错误与注意事项

问题	示例	解决方案
空字符串或 null	decode(null)	先判空：if (str != null && !str.isEmpty())
非法字符	"0xGHI"、"12.3"	捕获 NumberFormatException
仅前缀无数字	"0x"、"#", "0"	确保有有效数字部分
不支持二进制	"0b1010"	手动处理或使用 Integer.parseInt("1010", 2)
空格问题	" 0xFF "	建议先 trim()

正确异常处理示例：

public static Integer safeDecode(String str) {
    if (str == null || str.trim().isEmpty()) {
        return null;
    }
    try {
        return Integer.decode(str.trim());
    } catch (NumberFormatException e) {
        System.err.println("无法解析数字: " + str);
        return null;
    }
}

---

六、与其他方法对比

方法	是否自动识别进制	是否支持 #	是否返回 Integer	适用场景
Integer.decode(s)	✅ 是	✅ 是 (#FF)	✅ 是	用户输入、混合格式
Integer.parseInt(s)	❌ 否（默认十进制）	❌ 否	❌ 返回 int	简单十进制
Integer.parseInt(s, radix)	⚠️ 需指定	❌ 否	❌ 返回 int	固定进制解析
Integer.valueOf(s)	❌ 否（仅十进制）	❌ 否	✅ 是	装箱十进制字符串

✅ 总结：
当你需要自动识别多种进制格式时，优先使用 decode()；否则使用 valueOf() 或 parseInt() 更清晰。

---

七、最佳实践

✅ 推荐做法

1. 用于配置解析、脚本引擎、REPL 工具

   // 如实现一个简易计算器
   String expr = "0xFF + 010 - 100";
   // 分词后使用 decode 解析每个操作数
   

2. 统一处理不同进制输入

   // 接受多种形式表示同一数值
   assert Integer.decode("255").equals(Integer.decode("0xFF"));
   assert Integer.decode("255").equals(Integer.decode("0377"));
   

3. 日志和调试中增强可读性

   System.out.println("掩码值: " + Integer.decode("0xFFFF"));
   

4. 避免在高性能循环中频繁调用

   • 虽然性能尚可，但正则匹配和前缀判断有一定开销
   • 若已知格式，直接用 parseInt(s, radix) 更快

---

八、性能分析

• 内部通过检查字符串前缀（0x, #, 0）来决定进制。
• 使用 String.startsWith() 和 substring() 操作，有一定开销。
• 相比 parseInt() 略慢，但在大多数业务场景中差异可忽略。

---

九、总结

项目	内容
核心功能	自动识别并解析多种进制的整数字符串
支持格式	十进制、0x/0X 十六进制、# 十六进制、0 开头八进制
返回类型	Integer 包装对象
典型用途	配置解析、用户输入、调试工具
优势	格式灵活、自动识别进制
劣势	不支持 0b 二进制、性能略低于专用解析
异常处理	必须捕获 NumberFormatException
最佳实践	输入校验 + trim + 异常处理

💡 一句话总结：
Integer.decode() 是 Java 中最灵活的整数字符串解析方法，特别适合处理包含 0x、#、0 等前缀的混合格式输入，是开发工具类、配置解析器的理想选择。