核心一句话：longValue() 是 Integer 类继承自抽象类 Number 的方法，用于将 Integer 对象转换为 long 类型的基本值。

一、方法定义

public long longValue()
  • 所属类：java.lang.Integer
  • 继承自：java.lang.Number（抽象类）
  • 返回类型：long
  • 参数：无
  • 作用：将当前 Integer 对象的值以 long 类型返回。

二、功能说明

Integer.longValue() 的主要功能是类型转换，将一个包装的 int 值（以 Integer 对象形式存在）安全地提升为 long 类型。

✅ 为什么需要这个方法？

  1. 继承自 Number 抽象类，所有数字包装类（Integer, Long, Double 等）都必须实现 longValue()、intValue() 等方法，便于统一处理数值类型。
  2. 在泛型或反射中处理 Number 类型时，可通过 longValue() 统一获取 long 值。
  3. 避免手动强制转换，提高代码可读性和安全性。

三、示例代码

✅ 示例 1：基本使用

Integer num = 100;
long value = num.longValue();
System.out.println(value); // 输出：100

✅ 示例 2：自动拆箱 vs 显式调用 longValue()

Integer num = 200;

// 方式1：自动拆箱 + 隐式类型提升
long a = num; // 自动拆箱为 int，再提升为 long

// 方式2：显式调用 longValue()
long b = num.longValue();

System.out.println(a); // 200
System.out.println(b); // 200

⚠️ 两者结果相同，但 longValue() 更明确表达意图。

✅ 示例 3：在 Number 泛型中使用

public static void printLong(Number number) {
    System.out.println("Long value: " + number.longValue());
}

// 调用
printLong(123);           // Integer
printLong(456L);          // Long
printLong(78.9);          // Double（会截断小数部分）

// 输出：
// Long value: 123
// Long value: 456
// Long value: 78

💡 Number 是所有数值包装类的父类，longValue() 提供统一访问方式。

四、使用技巧

🔧 技巧 1：用于泛型数值处理

List<Number> numbers = Arrays.asList(1, 2L, 3.14f, 4.5);
for (Number n : numbers) {
    System.out.println(n.longValue()); // 统一转为 long（注意浮点数会截断）
}

🔧 技巧 2：避免溢出判断（int → long 安全）

Integer maxInt = Integer.MAX_VALUE;
long safeLong = maxInt.longValue();
System.out.println(safeLong); // 2147483647（无溢出风险）

int 转 long 是安全的向上转型，不会丢失精度。

🔧 技巧 3：与 Optional 结合使用

Integer num = getNumberFromSomewhere();
long result = Optional.ofNullable(num)
                      .map(Integer::longValue)
                      .orElse(0L);

五、常见错误

❌ 错误 1：对 null 调用 longValue() 导致 NullPointerException

Integer num = null;
long value = num.longValue(); // ❌ 抛出 NPE

✅ 正确做法：

long value = (num != null) ? num.longValue() : 0L;
// 或
long value = Optional.ofNullable(num).map(Integer::longValue).orElse(0L);

❌ 错误 2：误以为 longValue() 可以保留浮点精度

Double d = 3.9;
long l = d.longValue(); // 结果是 3，不是 4（直接截断，不四舍五入）

⚠️ longValue() 对浮点数是截断（truncation），不是四舍五入。

六、注意事项

注意点 说明
✅ 安全转换 int → long 是安全的，不会溢出
⚠️ null 安全 必须确保 Integer 对象不为 null
⚠️ 精度丢失（浮点） 若 Number 是 Double 或 Float，调用 longValue() 会截断小数部分
⚠️ 性能开销 方法调用本身极轻量，但频繁调用仍建议缓存或避免冗余
⚠️ 自动类型转换优先 多数情况下 long l = integer; 更简洁，longValue() 用于明确语义

七、最佳实践

✅ 1. 在处理 Number 接口时优先使用 longValue()

public void processNumber(Number num) {
    long value = num.longValue(); // 统一处理所有数字类型
    // ...
}

✅ 2. 显式调用 longValue() 提高代码可读性

// 更清晰地表达“我要转成 long”
long timestamp = user.getAge().longValue(); // 比 (long)user.getAge() 更易读

✅ 3. 配合 Optional 避免空指针

return Optional.ofNullable(integerValue)
               .map(Integer::longValue)
               .orElse(DEFAULT_VALUE);

✅ 4. 不要用于频繁性能敏感场景的冗余调用

// ❌ 不推荐：循环中重复调用
for (int i = 0; i < list.size(); i++) {
    System.out.println(list.get(i).longValue());
}

// ✅ 推荐：先获取再使用
Integer value = list.get(i);
if (value != null) {
    long l = value.longValue();
    System.out.println(l);
}

八、性能优化建议

场景 建议
单次调用 longValue() 性能极佳，无需担心
高频调用 缓存 long 值，避免重复调用
null 判断 提前判空，避免异常开销
替代方案 若已知是 Integer，直接赋值 long l = integer; 更简洁
大数据处理 考虑使用原始 int[] 或 long[]，避免对象开销

💡 longValue() 本质只是 return (long)value;，性能几乎等同于直接转换。

九、源码简析（JDK 8+）

// Integer.java
public long longValue() {
    return (long)value;
}
  • 非常简单，只是将内部的 int value 强转为 long。
  • 无额外计算或对象创建，性能极高。

十、总结：快速掌握要点 ✅

项目 内容
方法签名 public long longValue()
功能 将 Integer 转为 long 类型
是否安全 int → long 安全，无溢出
是否可空 null 调用会抛 NullPointerException
典型用途 泛型处理 Number、明确类型转换、反射
替代写法 long l = integer;（自动拆箱 + 类型提升）
最佳实践 判空处理、配合 Optional、用于统一接口
性能 极高，几乎无开销

🎯 一句话总结：

Integer.longValue() 是一个简单、安全、高效的类型转换方法，用于将 Integer 转为 long，适用于泛型、反射或需要明确语义的场景，使用时注意 null 安全即可。