Java方法链疑问：不同返回值的链式调用该如何理解？

你提到的String链式调用和JPA EntityManager的链式调用，本质是两种完全不同的设计思路：

1. String的链式调用：同一类型的方法链 #

先纠正个小误区：String是不可变类，concat()、toUpperCase()这些方法返回的其实是新的String对象，不是原对象。但它们的返回类型都是String，所以你可以一直链式调用String的方法——这种是同类型的连贯调用，所有方法都属于同一个类，完成的是字符串的各种变换操作。

2. JPA的链式调用：职责分离的多类型方法链 #

你的示例代码里的调用流程是这样的：

• em.createQuery(...) 从EntityManager（负责实体管理、查询创建的核心类）返回一个TypedQuery<Member>对象——这个类的职责是封装类型安全的JPQL查询，专门处理查询的配置和执行。
• 接着调用getResultList()是TypedQuery的方法，它的职责是执行查询并返回结果集，所以返回类型是List<Member>。

这种设计的好处在于：

• 职责拆分：把“创建查询”和“执行/配置查询”的工作分给不同的类，避免EntityManager类变得臃肿不堪。EntityManager只负责初始化查询，剩下的查询细节（分页、参数设置、排序）都交给TypedQuery处理。
• 类型安全：TypedQuery通过泛型绑定返回结果的类型，不用手动强转，比原生的Query类更安全。

再举个更完整的例子，你能更清楚这种设计的优势：

List<Member> members = em.createQuery("select m from Member m where m.age > :age", Member.class)
        .setParameter("age", 18)  // TypedQuery的方法，返回自身，继续链式配置
        .setFirstResult(0)        // 设置分页起始位置
        .setMaxResults(10)        // 设置每页数量
        .getResultList();         // 最终执行查询，返回结果列表

这里setParameter、setFirstResult这些方法返回的还是TypedQuery本身（这部分又是同类型链式调用），让你可以连贯地完成所有查询配置，最后一步执行返回结果。

简单说，这种链式调用是把不同阶段的操作交给不同的类，但通过返回下一个阶段的对象，让你不用写中间变量，保持代码简洁。

内容的提问来源于stack exchange，提问作者Soon chang Kwon