Java中如何进行方法链？ o.m1().m2().m3().m4()

Question

我在许多 Java 代码符号中看到，在一个方法之后我们调用另一个方法，下面是一个例子。

Toast.makeText(text).setGravity(Gravity.TOP, 0, 0).setView(layout).show();

正如您所看到的，在返回时调用 makeText 后，我们调用 setGravity ，到目前为止，

我如何使用自己的类来做到这一点？我需要做一些特别的事情吗？

Answer 1

这种模式称为“Fluent Interfaces”（请参阅​​维基百科）

只需返回此； 来自方法而不是返回任何内容。

例如

public void makeText(String text) {
    this.text = text;
}

会变成

public Toast makeText(String text) {
    this.text = text;
    return this;
}

Answer 2

class PersonMethodChaining {
    private String name;
    private int age;
 
    // In addition to having the side-effect of setting the attributes in question,
    // the setters return "this" (the current Person object) to allow for further chained method calls.
 
    public PersonMethodChaining setName(String name) {
        this.name = name;
        return this;
    }
 
    public PersonMethodChaining setAge(int age) {
        this.age = age;
        return this;
    }
 
    public void introduce() {
        System.out.println("Hello, my name is " + name + " and I am " + age + " years old.");
    }
 
    // Usage:
    public static void main(String[] args) {
        PersonMethodChaining person = new PersonMethodChaining();
        // Output: Hello, my name is Peter and I am 21 years old.
        person.setName("Peter").setAge(21).introduce();
    }
}

没有方法链接

class Person {
    private String name;
    private int age;
 
    // Per normal Java style, the setters return void.
 
    public void setName(String name) {
        this.name = name;
    }
 
    public void setAge(int age) {
        this.age = age;
    }
 
    public void introduce() {
        System.out.println("Hello, my name is " + name + " and I am " + age + " years old.");
    }
 
    // Usage:
    public static void main(String[] args) {
        Person person = new Person();
        // Not using chaining; longer than the chained version above.
        // Output: Hello, my name is Peter and I am 21 years old.
        person.setName("Peter");
        person.setAge(21);
        person.introduce();
    }
}

方法链接也称为命名参数惯用语，是面向对象编程语言中调用多个方法的常见语法。每个方法返回一个对象，允许在单个语句中将调用链接在一起。链接是语法糖，消除了对中间变量的需要。方法链也称为火车残骸，因为随着更多方法链接在一起，同一行中的方法数量会不断增加，即使方法之间经常添加换行符。

类似的语法是方法级联，其中在方法调用之后，表达式的计算结果为当前对象，而不是方法的返回值。级联可以使用方法链来实现，方法是返回当前对象本身（this）。级联是流畅接口中的一项关键技术，由于链接在面向对象语言中广泛实现，而级联则不然，因此这种形式的“通过返回 this 进行级联”通常简称为“链接”。链接和级联都来自 Smalltalk 语言。

Answer 3

从你的例子来看：

Toast.makeText(text).setGravity(Gravity.TOP, 0, 0).setView(layout).show();

链中的每个方法都必须返回一个类或一个接口。链中的下一个方法必须是返回类的一部分。

我们从吐司开始。 makeText 方法在 Toast 类中定义为静态方法，必须返回一个类或接口。在这里，它返回 Gravity 类的一个实例。

Gravity类中定义的方法setGravity返回类View的实例。View

类中定义的方法setView返回类JPanel的实例。

这条链可以一步步写出来。

Gravity gravity = Toast.makeText(text);
View view       = gravity.setGravity(Gravity.TOP, 0, 0);
JPanel panel    = view.setView(layout);
panel.show();

将链写为链会从源代码中删除所有中间实例变量。

Answer 4

在谷歌上搜索构建器模式或流畅的界面以了解更多详细信息。

在大多数情况下，在方法末尾返回“this”就可以解决问题。

Answer 5

添加返回此；肯定有助于此类的链接，但对于子类则失败。

如果您希望将链接行为继承到子类，则也可以更改您的类签名，如下所示：

Class SuperClass < SubClass extends SuperClass >{}

这样所有的子类都会继承方法链。

例子：

public class SuperClass<SubClass extends SuperClass> {

    public SubClass testMethod(){
        return (SubClass)this;
    }

    public static void main(String[] args) {
        SuperClass<SuperClass> superClass = new SuperClass<SuperClass>();
        superClass.testMethod().testMethod().testMethod();
        System.out.println(superClass.toString());
    }

}

Answer 6

或者您可以使用 Diezel 来根据您的流利的正则表达式生成您需要的所有接口API。