如何在 Java 中通过类型系统区分“旧版”与“新版”数据列表，防止误用-java教程

java 无法原生支持类型别名，但可通过定义语义明确的独立类（如 oldfoo 和 newfoo）或共享接口/抽象基类，在编译期强制区分两类数据，从根本上避免将旧列表误传给仅接受新列表的方法。

在 Java 中，List 本身不携带语义信息——无论 oldFoos 还是 newFoos 都是 List 类型，编译器无法识别其业务含义差异，因而极易发生误传（例如将历史兼容数据传入面向新版逻辑的处理器）。解决这一问题的核心思路是：让类型承载意图，而非依赖变量命名或运行时注释。

✅ 推荐方案：语义化子类（零运行时开销，强类型安全）

为“旧版”和“新版”分别定义不可互换的具体类型：

// 语义清晰、无继承关系 → 编译期完全隔离
final class OldFoo {
    private final double someNum;
    public OldFoo(double someNum) { this.someNum = someNum; }
}

final class NewFoo {
    private final double someNum;
    public NewFoo(double someNum) { this.someNum = someNum; }
}

// 方法签名即契约：只接受新版
class NewFooRunner {
    public double runFoos(List foos) {
        return foos.stream()
                   .mapToDouble(f -> f.someNum)
                   .sum();
    }
}

此时以下调用会编译失败：

List oldFoos = List.of(new OldFoo(1.0));
List newFoos = List.of(new NewFoo(2.0));

new NewFooRunner().runFoos(oldFoos); // ❌ 编译错误：incompatible types
new NewFooRunner().runFoos(newFoos); // ✅ 正确

⚠️ 注意：若 OldFoo 与 NewFoo 在业务上存在共性（如都需序列化、都含 id 字段），可提取公共接口（如 FooContract），但绝不应让二者共享父类或实现同一接口后用于泛型参数位置——否则仍会破坏类型隔离。接口仅用于跨场景通用能力，不用于替代类型区分。

? 进阶场景：需部分兼容时使用标记接口（轻量且灵活）

当某些工具方法需同时处理两类对象（如日志打印、基础校验），可引入空标记接口：