Java record pattern 怎么拆解嵌套数据

Java 21 之后，record pattern 可以在类型匹配的同时拆出 record 组件。面对“订单里嵌地址，地址里还有城市和邮编”这类数据，不必先判断类型、再强制转换、最后逐层调用访问器；把组件结构写进模式，就能在一次匹配中拿到需要的值。

先把嵌套数据建模成 record

先用一个小模型表示订单。Order 的第二个组件是 Address，而 Address 自己包含城市和邮编。模式匹配的关键不是字段名，而是组件顺序和组件类型。

// 订单的地址继续用 record 表示，方便按结构解构
record Address(String city, String postalCode) {}
record Order(String orderNo, Address shipping, int amount) {}

Object input = new Order(
        "A-1008",
        new Address("杭州", "310000"),
        299);

// 这里的模式形状对应 Order(String, Address, int)
if (input instanceof Order order) {
    System.out.println(order.orderNo());
}

上面仍然只是绑定了整个 Order。如果只需要订单号、城市和金额，可以把组件模式直接嵌进去。

用 instanceof 一次拆出多层组件

下面的模式同时匹配外层订单和内层地址。匹配成功后，orderNo、city、postalCode 与 amount 都是当前分支中的局部变量，不需要额外强转。

// 外层 Order 和内层 Address 在同一个模式中完成类型检查与解构
if (input instanceof Order(
        String orderNo,
        Address(String city, String postalCode),
        int amount)) {
    // 匹配成功后，变量只在这个分支内可用
    System.out.printf("订单 %s：%s %s，金额 %d%n",
            orderNo, city, postalCode, amount);
}

如果组件类型已经由 record 声明充分确定，也可以使用 var 缩短模式，例如 Order(var orderNo, Address(var city, var postalCode), var amount)。显式类型更适合公共示例和复杂分支，var 更适合局部的小型模式。

null 和类型边界决定模式是否成功

record pattern 不是深度拷贝，也不会把空对象自动转换成默认值。外层 input 不是 Order 时，或 shipping 为 null 时，整个模式都会失败，分支不会执行。这个行为可以把数据完整性判断集中在入口：

Object badInput = new Order("A-1009", null, 199);

// 内层 Address 为 null，所以嵌套模式不会匹配
if (badInput instanceof Order(
        String orderNo,
        Address(String city, String postalCode),
        int amount)) {
    System.out.println("不会打印：" + orderNo);
} else {
    // 业务上可在这里转为参数错误、补偿任务或人工处理
    System.out.println("订单缺少可用的收货地址");
}

如果业务允许地址为空，可以先匹配外层 Order(var no, var address, var amount)，再对 address 做显式判断。不要为了省几行代码，把“地址缺失”和“地址结构合法”混成同一条成功路径。

把解构模式放进 switch 分支

对于有多种订单形态的场景，switch 能让类型分支和数据解构保持在一起。下面以金额和城市作为守卫条件，先匹配结构，再判断业务条件：

static String route(Object value) {
    return switch (value) {
        // 结构匹配成功后，再用 when 检查金额阈值
        case Order(var no, Address(var city, var zip), var amount)
                when amount >= 2000 -> "人工复核：" + no;
        // 同一个结构可以用另一个守卫表达普通配送
        case Order(var no, Address(var city, var zip), var amount)
                when !city.isBlank() -> "正常配送：" + city;
        // 处理 null、其他对象和不完整数据
        default -> "无法路由";
    };
}

具体项目要以所用 JDK 的语言特性和编译器设置为准；如果项目尚未启用对应的模式匹配语法，先升级编译环境，或者退回普通 instanceof 与访问器写法。

显式类型、var 与泛型模式怎么选

嵌套泛型 record 也可以被模式匹配。例如 Box> 可以写成 Box(Box(String value))，编译器依据目标类型推断参数。实际落地时建议遵循三条边界：

• 跨团队维护的核心分支优先写显式组件类型，让模式形状一眼可读。
• 局部临时变量可以使用 var，但不要让多个同名字段遮住业务含义。
• record pattern 只负责匹配和拆出组件，不负责校验邮编、金额范围或做对象复制；这些规则仍应放在明确的业务函数中。

常见问题

嵌套 record pattern 能不能匹配 null？

不能把 null 当成成功的嵌套记录。外层或内层记录为空时，模式不匹配；允许缺失时先绑定外层组件再单独判断。

record pattern 会创建新的 Address 对象吗？

不会。它只是按组件访问器取得已有对象中的值，不做深拷贝，也不改变原对象。

什么时候不适合继续嵌套模式？

当模式已经长到难以看出业务条件，或每层都有独立错误处理时，应拆成几个小分支或调用命名方法，优先保证可读性。

判断一段嵌套数据是否适合 record pattern，可以按“结构是否稳定、空值是否有统一语义、分支是否需要同时使用多个组件”来决定。三点都满足时，模式匹配能明显减少强转和访问器噪声；否则保留显式步骤，通常更容易维护。