Java 25 Primitive Types in Patterns 怎样避免模式匹配中的装箱误判
Java 25 的 Primitive Types in Patterns 允许 instanceof 和 switch 直接使用基本类型模式。最容易误判的地方是:case Integer 是引用类型模式,而 case int 会按预览特性规定的匹配转换处理包装值、基本值和 null。因此,先确认预览开关,再根据“是否允许拆箱”和“是否需要区分包装类型”选择写法。
需要精确区分 Integer、Long 等包装类型时保留引用类型模式;只关心数值能否按目标基本类型匹配时,才使用 primitive pattern,并单独处理 null。
官方资料:https://openjdk.org/jeps/507
先把预览特性边界固定下来
这项能力属于 Java 25 的预览语言特性,示例编译和运行都要显式打开预览开关。发布到生产代码时,还要让编译器、运行时和部署说明使用同一个 JDK 主版本,不能只在本地 IDE 中打开预览。
# 使用 JDK 25 编译预览语法,release 保证语言级别一致 javac --enable-preview --release 25 PatternDemo.java # 运行时也要打开预览开关,否则类文件无法按预览语义启动 java --enable-preview PatternDemo
这里的开关只负责启用语言特性,不会把所有包装类型都自动视为同一种数值。后面的匹配仍然受目标 primitive pattern、可用转换和空值规则约束。
instanceof 中怎样看待装箱值
引用类型模式回答的是“对象是不是某个引用类型”,例如 Integer 模式只会绑定 Integer 引用。primitive pattern 的关注点不同:它把目标写成基本类型,让代码表达“这个值是否能按目标基本类型参与模式匹配”。两者不要只靠变量名判断。
static String describe(Object value) {
// 引用类型模式保留 Integer 的对象身份,不表达通用数值匹配
if (value instanceof Integer integerValue) {
return "Integer: " + integerValue;
}
// primitive pattern 表达按 int 目标进行匹配的意图
if (value instanceof int intValue) {
return "int pattern: " + intValue;
}
// null 不会匹配 primitive pattern,应在业务分支外明确处理
return value == null ? "null" : "other";
}
示例中的两个判断不是“更短写法”和“更长写法”的关系。第一个适合保留包装类边界,第二个适合把判断目标放在基本类型上。若后续逻辑依赖对象的具体包装类型、重载选择或是否存在 null,就不要为了省一个分支贸然改成 primitive pattern。
switch 中怎样同时处理数值类型和 null
当分支本身就是分类器时,switch 更适合集中表达选择规则。把 case Integer 和 case int 混在一起时,要先写清楚二者承担的职责:前者保留包装类型语义,后者表达基本类型模式语义;null 则作为独立分支处理。
static String classify(Number value) {
// switch 中显式列出 null,避免把空值交给 default 猜测
return switch (value) {
case null -> "空值";
// 引用模式用于保留 Integer 的类型信息
case Integer integerValue -> "Integer: " + integerValue;
// primitive pattern 用于表达目标基本类型的匹配意图
case long longValue -> "long pattern: " + longValue;
case double doubleValue -> "double pattern: " + doubleValue;
// 其它 Number 子类型落入兜底分支
default -> "其它 Number: " + value.getClass().getSimpleName();
};
}
这个写法的重点不是尽可能列出所有数字类型,而是让分支顺序和语义可读:先处理 null,再处理必须保留的包装类,最后使用 primitive pattern 或 default 覆盖真正需要的数值范围。若把 Integer 分支删除,读者就无法从代码中看出你是否有意放弃包装类型区分。
用四个问题选择匹配方案
| 你要表达的判断 | 优先写法 | 需要留意 |
|---|---|---|
| 对象必须是 Integer | Integer i | 保留包装类型身份,不等价于所有可转成 int 的值 |
| 只关心目标 primitive 的匹配 | int i、long l | 确认预览开关与允许的匹配转换,不要凭变量名推断 |
| 空值有单独业务含义 | case null 或显式 null 判断 | 不要把 null 留给 default 隐式兜底 |
| 需要兼容非目标 Number 子类 | primitive pattern + default | 兜底分支要说明未覆盖的类型范围 |
最稳的排查顺序是:先确认输入静态类型,再确认是否要保留包装类身份,然后检查 null 分支,最后才考虑能否用 primitive pattern 合并重复代码。这样能避免把“数值相等”误写成“对象类型相同”。
常见问题
primitive pattern 能替代所有 Integer 模式吗?
不能。两者的表达目标不同。需要包装类型身份、对象 API 或 null 语义时,应保留引用类型模式;只有确实要按基本类型匹配时才使用 primitive pattern。
为什么本地能编译,部署时却失败?
最常见原因是编译和运行没有同时使用 --enable-preview,或者部署 JDK 不是编译时的 Java 25。把 JDK 版本、编译命令和启动命令作为同一份构建配置管理。
default 能代替 null 分支吗?
不要这样设计业务语义。null 是独立输入状态,显式分支更容易审查,也避免未来新增模式后改变兜底含义。