Java泛型接口实现链式调用需用F-bounded泛型：接口声明为Builder<T extends Builder<T>>，实现类如PersonBuilder implements Builder<PersonBuilder>，使每个setter返回具体子类型而非擦除后的父类型，保障类型安全与IDE提示。
在 Java 泛型接口中实现返回自身类型（self-returning）的方法，并保证链式调用的类型安全，核心是使用 递归泛型（F-bounded polymorphism） —— 即让类型参数约束为“当前接口或其实现类自身”。这样编译器就能推断每次调用后仍保持具体实现类型，避免擦除后退化为父类型。
用 F-Bounded 泛型定义接口
关键是在接口声明时，让类型参数 T extends 该接口本身，形成自引用：
public interface Builder<T extends Builder<T>> {
T setName(String name);
T setAge(int age);
T setEmail(String email);
Person build();
}
这里 T 表示“实现该接口的具体子类型”，比如 PersonBuilder 实现 Builder<PersonBuilder>，那么所有 setter 方法都明确返回 PersonBuilder，而非模糊的 Builder<?>。
具体实现类必须正确绑定类型参数
实现类需将自身作为类型实参传入，否则链式调用会丢失类型信息：
立即学习“Java免费学习笔记（深入）”；
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
public class PersonBuilder implements Builder<PersonBuilder> {
private String name;
private int age;
private String email;
@Override
public PersonBuilder setName(String name) {
this.name = name;
return this; // 返回 PersonBuilder，非 Builder<?>
}
@Override
public PersonBuilder setAge(int age) {
this.age = age;
return this;
}
@Override
public PersonBuilder setEmail(String email) {
this.email = email;
return this;
}
@Override
public Person build() {
return new Person(name, age, email);
}
}
此时可安全链式调用：new PersonBuilder().setName("Alice").setAge(30).setEmail("a@b.c").build()，每一步返回的都是 PersonBuilder，IDE 和编译器都能准确提示可用方法。
支持继承与扩展（如子构建器）
若存在子类构建器（如 EmployeeBuilder 继承 PersonBuilder），仍可保持类型安全：
public class EmployeeBuilder extends PersonBuilder
implements Builder<EmployeeBuilder> {
private String employeeId;
public EmployeeBuilder setEmployeeId(String id) {
this.employeeId = id;
return this;
}
@Override
public Employee build() {
return new Employee(name, age, email, employeeId);
}
}
注意：由于 EmployeeBuilder 要同时满足 Builder<EmployeeBuilder>，它需重写所有继承来的 Builder 方法，确保返回 EmployeeBuilder。更实用的做法是让基类也采用 F-bound 并提供模板方法，或使用组合代替继承。
常见陷阱与注意事项
-
不能省略类型实参：写
class PersonBuilder implements Builder（裸类型）会导致类型擦除，链式调用返回Builder，失去子类型信息。 -
避免无限递归声明：不要写
<T extends Builder<T>>在方法里重复——接口层级定义一次即可。 -
构造器不能是泛型的：无法直接 new
T()，需用工厂、Supplier 或反射（不推荐）来创建实例。 -
泛型方法不能替代 F-bound 接口：仅靠
<T> T method()无法约束返回值为调用者自身类型，编译器无法推断。
这种模式被广泛用于构建器（如 Lombok 的 @Builder）、流式 API（如 JUnit 5 的 Assertions 风格）和 Fluent DSL 设计中，本质是用泛型契约把“this”语义编码进类型系统。
