AsyncListener#onError 的使用

Question

我不明白何时调用 AsyncListener#onError 方法。 Javadoc 没有帮助：

通知此 AsyncListener 异步操作未能完成。

它怎么会失败？如何重现此错误？

更新：

// in HttpServlet doGet method
AsyncContext asyncContext = req.startAsync();
asyncContext.addListener(new AsyncListener() {
    // some code
    @Override
    public void onError(AsyncEvent event) {
        // when is it called?
    }
});
executeInSomeOtherThread(asyncContext);

我需要在其他线程中做什么才能使此异步操作失败？

Answer 1

如果在执行异步操作时抛出异常，将调用onError。

它们通常是扩展 java.io.IOException 的 Throwable，由不可靠的连接导致的 I/O 失败或由于客户端和服务器不匹配导致的逻辑错误导致的协议级别异常。

调用 onError 时可以获取 Throwable：

event.getThrowable();

编辑以解决 mjaggard 的后续问题

暂时忘记 AsyncContext，考虑以下类：

public class MyRunnableClass implements Runnable {
    private Listener mListener;

    interface Listener {
        void onError(Throwable error);
    }

    public void setListener(Listener listener) {
        mListener = listener;
    }

    @Override
    public void run() {
        // Some important code to be executed goes here

        // Pretend an exception was caught in a try/catch/finally
        // block that was doing an I/O operation

        Throwable someError = new IOException();

        if (mListener != null) {
            mListener.onError(someError);
        }
    }
}

现在是否更清楚了如何调用侦听器的 onError 方法，因为调用 MyRunnableClass 的 run 方法时引发了异常？

MyRunnableClass mrc = new MyRunnableClass();
mrc.setListener(new Listener() {
    @Override
    public void onError(Throwable error) {

    }
});

Executors.newSingleThreadScheduledExecutor().schedule(mrc, 1000L, TimeUnit.MILLISECONDS);

这与 AsyncContext 保持侦听器并在遇到希望报告给侦听器的异常时通知它的方式没有什么不同。 run 方法的调用方式实际上是次要的，因为正在执行的代码的所有者也是持有对侦听器的引用的人。