我将为我的应用程序创建自定义 fluent API。我决定检查现有库的代码，并在至少 2 个使用 fluent api 的项目中发现了一些怪物。
我看到有许多类和接口，它们的区别仅在于泛型类型的数量。
例如：在jOOQ库中DerivedColumnList22
在 RxJava 中：Action9
这样的怪物的目的是什么？它仅适用于性能案例吗？或者是流利的api有一些共性和方法吗？
当你看到这样的怪物时，在 fluent api 中实现自己的 DSL 看起来很可怕。
【问题讨论】：
既然你提到了jOOQ library，我将在这里给出一个权威的答案，作为jOOQ的作者，并写了这篇关于设计流畅API的帖子（或者更确切地说：用Java设计内部特定领域的语言）： https://blog.jooq.org/2012/01/05/the-java-fluent-api-designer-crash-course
您发现的是 API 设计人员使用元组的共同愿望。一些语言内置了对结构化元组类型的支持，即可以以特别方式创建的元组类型，而不是提前声明它们并给它们命名。后者称为名义类型。 More details about nominal/structural typing here.
SQL 是允许创建临时元组类型的语言的一个很好的例子：
SELECT first_name, last_name, age
FROM people
上述查询创建了一个类型为(string, string, number) 的3 级元组表。 JavaScript 是另一个示例，我可以在其中快速生成这样的元组：
var x = {
firstName: "Lukas",
lastName: "Eder",
age: undefined
};
还有其他语言在某种程度上支持元组。理想情况下，元组允许通过名称和索引访问单个属性。有时，只能通过名称授予访问权限。在其他情况下，它仅由索引给出。但从概念上讲，它总是一样的。
DerivedColumnList22 和 Action9 是什么意思
不幸的是，Java 语言没有这样的工具来创建临时结构元组类型。 （几乎）Java 中的所有内容都需要在名义上键入。甚至“匿名函数”（lambda 表达式）也需要分配给名义上的 SAM 类型：
Runnable r = () -> { doSomething(); }
// ^^^^^^^^^^^^^^^^^^^^^^^^ --- Syntactically looks like a structural type
// ^^^^^^^^^^ ------------------------------ But it's really a nominal type
因此，如果 API 想要给用户一种支持真实结构元组类型的错觉，它必须提前为每种支持的类型提供名称。比如Action9:
Action9<T1, T2, T3, T4, T5, T6, T7, T8, T9> action =
(a, b, c, d, e, f, g, h, i) -> { doSomething(); }
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^ ------------- Look ma! Almost a structural tuple type!
因此，这种技术主要由 RxJava（它鼓励结构元组类型真正发挥作用的函数式编程）或 jOOQ（它鼓励结构元组类型也真正发挥作用的 SQL）等库实现。
其他库/API 包括：
Tuple1 - Tuple22
Tuple1 - Tuple8
这并不意味着您在自己的 DSL 中需要这些类型。开始简单。最终，您可能会觉得需要添加它们。
【讨论】：
Record22 而不是 Record21 或 Record23 ？这个数字是怎么决定的？根据一些统计数据？
在 RxJava 中，这些编号的接口为需要同时处理 2-9 个源/值的用户提供了 lambda 便利。 Action9 没有被 RxJava 使用，但它的姐妹 Func9 可以作为 combineLatest 和 zip 的参数使用。根据 Rx.NET 的经验，我们认为人们不太可能将 combine/zip 与超过 9 个直接来源一起使用，而且在列出它们时没有Func10 可以避免成员排序问题（即Func1、Func10 , Func2)。
对于超过 9 个来源，FuncN<R> 定义为具有单个方法 R call(Object... args) 的功能接口，代价是您必须手动提取元素并将它们转换回各自的类型：
Observable.zip(Arrays.asList(ints, strings, objects, t4, t5, t6, ...), a -> {
int p1 = (Integer)a[0];
String p2 = (String)a[1];
//...
})
在底层，常规的 Func2-Func9 are wrapped 变成了 combineLatest/zip 的 FuncN，因此这些运算符每个都可以有任意数量的源实现，而不是 9 个略有不同的源实现。然后包装器只是解包它被调用的数组，就像上面一样。
【讨论】：