理解链式调用（Method Chaining）
链式调用是一种编程范式，它允许开发者在同一个对象上连续调用多个方法，使得代码更加简洁、流畅，类似于自然语言的表达方式。例如，object.method1().method2().method3(); 就是典型的链式调用。这种模式在构建流畅api（fluent api）时尤为常见，极大地提高了代码的可读性和可维护性。
实现链式调用的核心：返回当前对象实例
要在Java中实现自定义类方法的链式调用，关键在于让执行修改操作的方法返回当前对象的实例。这意味着方法的返回类型必须是其所属的类本身，并且在方法体内部，需要通过 return this; 语句返回当前对象。this 关键字在Java中代表当前对象的引用。当一个方法返回 this 时，它实际上是将当前对象本身作为返回值，这样就可以在该返回值上继续调用其他方法。
示例：实现一个可链式调用的数字修改器
假设我们有一个简单的 num 类，它包含一个整数 obj。我们希望创建一个 addone() 方法，能够将 obj 的值加1，并且支持链式调用，例如 new num(4).addone()。
初始尝试（非链式调用）：
public class num {
int obj;
public num(int input) {
this.obj = input;
}
// 无法进行链式调用，因为没有返回值
public void addone() { // 注意这里是 void
this.obj = obj + 1;
}
public static void main(String[] args) {
// 这行代码会编译错误，因为 addone() 返回 void，不能赋值给 num 类型
// num testcase = new num(4).addone();
num testcase = new num(4);
testcase.addone(); // 只能这样分开调用
System.out.println(testcase.obj); // 输出 5
}
}在上述代码中，addone() 方法的返回类型是 void，这意味着它不返回任何值。因此，在 new num(4).addone() 之后，编译器无法识别 addone() 的返回值是一个 num 类型的对象，也就无法继续进行赋值或调用其他方法。
立即学习“Java免费学习笔记（深入）”；
正确实现（支持链式调用）：
为了实现链式调用，我们需要修改 addone() 方法，使其返回当前 num 类的实例。
public class num {
int obj;
public num(int input) {
this.obj = input;
}
/**
* 将 obj 的值加 1，并返回当前 num 对象的实例，
* 以支持链式调用。
* @return 当前 num 对象的实例
*/
public num addone() { // 返回类型改为 num
this.obj = obj + 1; // 修改 obj 属性
return this; // 返回当前对象实例
}
public static void main(String[] args) {
System.out.println("演示链式调用");
// 链式调用：创建 num 对象并立即调用 addone() 方法，然后将结果赋值给 testcase
num testcase = new num(4).addone();
System.out.println("testcase.obj 的值: " + testcase.obj); // 预期输出 5
// 进一步链式调用：在同一行代码中多次修改
num anotherCase = new num(10).addone().addone();
System.out.println("anotherCase.obj 的值: " + anotherCase.obj); // 预期输出 12
}
}代码解析：
- public num addone()： 方法的返回类型从 void 变为了 num，明确指出此方法会返回一个 num 类型的对象。
- this.obj = obj + 1;： 这行代码负责修改当前 num 对象内部的 obj 属性值。
- return this;： 这是实现链式调用的关键。它返回当前正在操作的 num 对象实例。当 new num(4).addone() 被执行时，new num(4) 创建了一个 num 对象，然后在这个对象上调用 addone()。addone() 方法修改了对象的 obj 属性，并将其自身（即那个被修改的 num 对象）作为返回值。这样，testcase 变量就能接收到这个已经被修改过的 num 对象。
注意事项与最佳实践
- 返回类型必须是当前类： 确保所有希望支持链式调用的方法都将其所属的类作为返回类型。
- 返回 this： 在方法的最后，务必使用 return this; 来返回当前对象实例。
- 区分修改器与访问器： 链式调用通常用于修改对象状态（如 setter 方法的变种）或执行某些操作后返回自身。对于只读取对象状态的访问器（getter 方法），通常不适合返回 this。
- 不可变对象与链式调用： 如果你的设计目标是创建不可变对象，那么链式调用通常会创建并返回一个新的对象实例，而不是修改当前对象。例如，String 类的 replace() 方法就是返回一个新的 String 对象。本教程的示例是关于修改现有对象并返回自身，属于可变对象的设计范畴。
- 提高代码可读性： 链式调用可以显著提高代码的表达力和可读性，尤其是在配置对象或构建器模式中。
总结
通过让自定义类的方法返回 this（当前对象实例），我们可以在Java中优雅地实现方法链式调用。这种模式不仅使得代码更加紧凑和富有表现力，也为构建用户友好的Fluent API提供了强大的支持。掌握这一技巧对于编写高质量、易于理解和维护的Java代码至关重要。
