在Java接口中重新定义等待方法

Question

我想使用 wait(int) 作为 Fluent API 中方法的签名（用于 http://www.jooq.org）。目标是能够构建像下面这样的 SQL 查询：

SELECT * FROM T_AUTHOR
WHERE ROWNUM <= 1
FOR UPDATE OF FIRST_NAME, LAST_NAME
WAIT 5

的 FOR UPDATE 子句语法规范（至少对于 Oracle）可以在此处查看：

FOR UPDATE [ OF [ [ schema. ] { table | view } . ] column
             [, [ [ schema. ] { table | view } . ] column]...]
[ { NOWAIT | WAIT integer | SKIP LOCKED } ]

完整 oracle.com/docs/cd/B28359_01/server.111/b28286/img_text/for_update_clause.htm" rel="nofollow">http://download.oracle.com/docs/cd/B28359_01/server.111/b28286/img_text/for_update_clause.htm

使用jOOQ，我真的很想接近SQL语法。因此，我希望能够使用 jOOQ Fluent API 对上述 SQL 子句进行建模，如下所示：

Result<Record> result = create.select()
                              .from(T_AUTHOR)
                              .limit(1)
                              .forUpdate()
                              .of(FIRST_NAME, LAST_NAME)
                              .wait(5) // Here's the issue
                              .fetch();

fetch 方法用于将 API 的底层对象呈现为 SQL，并针对 Oracle（或任何其他）数据库运行 SQL 语句。上面的内容可以在接口中合法地指定：

/**
 * A type that models a "step" in the creation of a query using the fluent API
 */
public interface SelectForUpdateWaitStep extends SelectFinalStep {
    // [...]

    /**
     * Add a "FOR UPDATE .. WAIT n" clause to the query
     */
    SelectFinalStep wait(int seconds);

    // [...]
}

不过，我对此有些怀疑，因为存在与另一种方法发生冲突的风险：

public class Object {
    // [...]

    public final native void wait(long timeout) throws InterruptedException;

    // [...]
}

感谢方法重载（int vs. long 参数），我实际上可以做到这一点。但我担心这可能会让我的用户感到困惑并导致错误。所以这是错误的：

                              .forUpdate()
                              .of(FIRST_NAME, LAST_NAME)
                              .wait((long) 5) // This doesn't make sense
                              .fetch();       // This doesn't compile

所以我的问题是：

1. 我可以以某种方式阻止调用/访问 Object.wait(long) 吗？我不这么认为，因为它被声明为最终的，但也许有人知道编译器技巧，或者其他什么？
2. 除了将方法重命名为像 doWait(int) 或 WAIT(int) 这样愚蠢的名称之外，您对我的 API 设计还有更好的想法吗？

Answer 1

您可以尝试改用 waitFor 方法，该方法指定要等待的时间和“条件”。实现细节将被隐藏，但一种可能的实现是立即尝试您的操作并循环，直到满足指定的条件，并在尝试之间适当暂停。

这是我自己使用的 Condition 的示例接口（如您所见，它不需要很复杂）：

public interface Condition {
    public boolean met();
}

Answer 2

void wait(long) 是 Object 提供的合约的一部分，因此不应更改。想象一下，有人存储您的对象并尝试将其用于等待/通知线程逻辑。所以完全改变它的逻辑就是违反规则。所以你必须想出不同的名字。

另一方面，似乎让 forUpdate 接受指示等待时间的参数将符合要求。除了现有版本之外，您还可以拥有另一个版本的 forUpdate。

Answer 3

这需要一种禁用 Object 方法的方法。主要原因似乎是因为它有一个好名称，适合专有 API 的用途。

首先，这与继承的整个概念相矛盾——一旦从一个类继承，所有子类都必须公开相同的非私有字段和私有字段。方法。您始终可以重写方法，除非 (1) 它被标记为 final 并且 (2) 它具有不兼容（非协变）的返回类型，这两种情况对于 都是正确的void wait(long) 方法。

此外，由于Java中每个对象都是一个Object，所以所有东西都必须有一个方法void wait(long)，并且不应该有办法隐藏/删除/禁用/转发/覆盖它。假设可以隐藏 void wait(long) 方法，您将如何调用它？您是否希望调用它？

但是，假设您永远不需要为特定类调用 void wait(long)，则 AspectJ 始终使用按顺序使用的源代码/字节代码编织方法根据某些调用规则更改 .class Java 字节码。您可以捕获对 wait(long) 的每次调用并声明错误/警告。在此处查看更多信息： http://www.eclipse.org/aspectj /doc/released/adk15notebook/annotations-decp.html

但是，即使使用具有字节码编织的 AspectJ，本机方法切入点也是不可能的。即使使用源代码编织，这很可能也是不可能的——但可能值得一试。

Answer 4

为了 DSL 而使用核心 Java 根本不是一个好主意。

为什么不让你的 DSL 更具表现力呢？

wait(int n) 到底是什么意思？等待N毫秒、秒、分钟？

更好的签名是：

wait(long period, java.util.concurrent.TimeUnit){ ... }

读起来更好，例如：

wait(30, TimeUnit.MILLISECONDS)