Java通过返回this实现链式调用，核心是方法返回当前对象实例以支持连续调用；结合泛型可解决继承中类型丢失问题；适用于配置类操作，需避免在返回业务结果或具副作用的方法中使用。
Java 本身没有 return_this 关键字（这是 Python 或某些 DSL 中的概念），但可以通过 返回当前对象实例（this） 的方式，手动实现链式调用。所谓“优雅”，核心在于设计清晰、类型安全、符合直觉，且不破坏封装性。
让方法返回 this，是最直接的方式
每个修改状态或配置的方法，不返回 void，而是返回 this，从而支持连续调用：
public class Builder {
private String name;
private int age;
public Builder setName(String name) {
this.name = name;
return this; // 关键：返回当前对象
}
public Builder setAge(int age) {
this.age = age;
return this;
}
public void build() {
System.out.println("Name: " + name + ", Age: " + age);
}
}
使用时就可链式调用：new Builder().setName("Alice").setAge(30).build();
用泛型提升类型安全（避免子类调用父类方法后丢失类型）
若存在继承（如 SuperBuilder → SubBuilder），直接返回 this 可能导致子类调用父类方法后返回父类类型，中断链式调用。此时可用泛型限定：
public class Builder<T extends Builder<T>> {
protected String name;
@SuppressWarnings("unchecked")
public T setName(String name) {
this.name = name;
return (T) this;
}
}
public class SubBuilder extends Builder<SubBuilder> {
public SubBuilder setTag(String tag) {
// ...
return this;
}
}
这样 new SubBuilder().setName(...).setTag(...) 就不会因 setName 返回 Builder 而中断链路。
立即学习“Java免费学习笔记（深入）”；
配合构造器或静态工厂，让入口更自然
链式调用常与构建器模式结合。提供静态方法作为入口，语义更清晰：
- 添加静态工厂方法：
public static Builder create() { return new Builder(); } - 调用变为：
Builder.create().setName("Bob").setAge(25).build(); - 也可用静态内部类（如
StringBuilder风格），但对外暴露的是不可变/只读接口，内部可变
注意边界：不是所有方法都适合链式
链式调用适用于配置型、设置型、累积型操作，应避免以下情况：
- 返回有意义业务结果的方法（如
findUser()、calculateTotal()）——不应返回this，否则语义混乱 - 有副作用且不可逆的操作（如
sendEmail()）——链式易让人误以为可继续配置，实际已提交 - 构造中途可能失败的逻辑（如校验）——建议延迟到
build()统一校验，或抛出 unchecked 异常并仍返回this（需文档说明）
不复杂但容易忽略：链式调用的本质是“命令式流程的函数式拼接”，关键不在语法糖，而在 API 设计是否一致、意图是否明确。只要每个 return this 都服务于同一个构建/配置目标，它就是优雅的。
