Java中实现链式调用的关键是方法返回this，即每个方法需声明当前类类型返回值并以return this结尾，确保连续调用同一对象实例，避免返回void、null或新对象；继承场景下可借助自限定泛型提升类型安全。
Java 中实现链式调用的关键是：方法返回 this（当前对象实例），而不是 void 或其他类型。
让方法返回 this
链式调用本质是连续调用同一对象的多个方法，每次调用后仍持有该对象引用。因此每个参与链式调用的方法必须返回当前对象（this），不能返回 void 或新对象（除非刻意设计为构建器模式）。
- 方法签名需声明返回类型为当前类（如
public MyClass doSomething()） - 方法体末尾写
return this; - 避免在链中修改不可变状态后返回新对象——那属于函数式风格，不是传统面向对象的链式调用
注意返回类型与泛型兼容性
如果类有继承关系（比如子类调用父类方法还想继续链式调用子类方法），直接返回 this 可能导致编译错误（父类方法返回父类型，无法调用子类特有方法）。此时可用泛型 + 自限定（self-type）提升类型安全性：
- 定义基类时使用
class Base<t extends base>></t> - 方法返回
T类型，并在子类中重写为具体类型 - 例如：Lombok 的
@Builder和 Spring 的BeanDefinitionBuilder都采用类似技巧
不要在链式方法里返回 null 或新实例
链式调用的前提是“始终可继续调用”，一旦某个方法返回 null 或新建对象，链就断了：
立即学习“Java免费学习笔记（深入）”；
-
错误示范：
public String getName() { return name; }—— 返回 String，后续无法接本类方法 -
错误示范：
public void setName(String n) { this.name = n; }—— 返回 void，无法链式 -
正确做法：统一返回
this，即使只是 setter，也写成public MyClass setName(String n) { this.name = n; return this; }
常见适用场景
链式调用多用于配置类、构建器、流式 API 设计：
- 构建器模式（Builder）：如
new User.Builder().name("Tom").age(25).build() - 流式操作（虽 Java Stream 是不可变的，但内部靠返回新 Stream 实现“伪链式”）
- DSL 风格 API：如 OkHttp 的
Request.Builder、Mockito 的when(...).thenReturn(...)
