java中通过返回this实现方法链式调用，要求方法返回当前类实例、为非静态实例方法，并避免混用void方法；典型应用包括builder模式和querywrapper，需注意不可变性冲突与继承场景下的链断裂问题。
Java 中通过返回 this 实现方法调用链（即“流式 API”或“方法链”），核心是让每个修改类状态的方法返回当前对象本身，从而支持连续调用。这种设计常见于 Builder 模式、ORM 工具（如 MyBatis-Plus 的 QueryWrapper）、日志框架等。
返回 this 的基本写法
关键点：方法签名需声明返回类型为当前类（不能是 void），并在末尾写 return this;。所有参与链式调用的方法都应遵循这一约定。
- 必须是实例方法（不能是 static）
- 返回类型必须是当前类（或其父类/接口，但通常用具体类保证链式连贯）
- 避免在链中混用 void 方法——一旦出现，调用链就中断
典型示例：简易用户构建器
以下是一个可链式设置属性的 UserBuilder：
public class UserBuilder {<br> private String name;<br> private int age;<br><br> public UserBuilder name(String name) {<br> this.name = name;<br> return this; // 返回当前实例<br> }<br><br> public UserBuilder age(int age) {<br> this.age = age;<br> return this;<br> }<br><br> public User build() {<br> return new User(name, age);<br> }<br>}
使用时：new UserBuilder().name("Alice").age(25).build();
注意事项与常见陷阱
链式调用看似简洁，但需注意语义和线程安全：
-
不可变性冲突：若类设计为不可变（immutable），就不该提供返回
this的 setter 类方法；此时应返回新对象（如 String 的trim()、toUpperCase()） -
继承场景下易出错：子类调用父类返回
this的方法，可能因泛型或协变返回类型处理不当导致链断裂；推荐用泛型自引用（如<t extends userbuilder></t>）或返回接口类型 - IDE 和调试友好性：链式调用不利于单步调试，建议关键逻辑仍保留独立方法入口，链式仅作为语法糖
进阶：支持泛型自引用（更安全的继承）
为避免子类链断裂，可定义带泛型的基类：
public abstract class Builder<t extends builder>> {<br> public T setName(String name) {<br> // ...<br> return (T) this;<br> }<br>}</t>
子类继承时指定自身类型：class UserBuilder extends Builder<userbuilder></userbuilder>，这样 setName() 返回的就是 UserBuilder，链不会断。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
