番石榴的ListenableFuture

Guava中的ListenableFuture试图为Future对象定义一致的API，以注册完成回调。 通过在Future完成时添加回调的功能，我们可以异步有效地响应传入的事件。 如果您的应用程序与许多将来的对象高度并发，我强烈建议您尽可能使用ListenableFuture 。 从技术上讲， ListenableFuture通过添加以下简单ListenableFuture扩展了Future接口：

void addListener(Runnable listener, Executor executor)

方法。 而已。 如果掌握了ListenableFuture ，则可以注册Runnable以在有问题的将来完成时立即执行。 您还必须提供将用于执行您的侦听Executor （ ExecutorService扩展）–这样长时间运行的侦听器不会占用您的工作线程。

让我们付诸行动。 我们将从重构我们的第一个Web ListenableFuture 器示例以使用ListenableFuture 。 幸运的是，在线程池的情况下，只需使用MoreExecutors.listeningDecorator()将它们包装起来MoreExecutors.listeningDecorator() ：

ListeningExecutorService pool = MoreExecutors.listeningDecorator(Executors.newFixedThreadPool(10));

for (final URL siteUrl : topSites) {
    final ListenableFuture<String> future = pool.submit(new Callable<String>() {
        @Override
        public String call() throws Exception {
            return IOUtils.toString(siteUrl, StandardCharsets.UTF_8);
        }
    });

    future.addListener(new Runnable() {
        @Override
        public void run() {
            try {
                final String contents = future.get();
                //...process web site contents
            } catch (InterruptedException e) {
                log.error("Interrupted", e);
            } catch (ExecutionException e) {
                log.error("Exception in task", e.getCause());
            }
        }
    }, MoreExecutors.sameThreadExecutor());
}

有几个有趣的发现。 首先，请注意ListeningExecutorService如何包装现有的Executor 。 这类似于ExecutorCompletionService方法 。 稍后，我们注册自定义Runnable ，以便在每个任务完成时得到通知。 其次，请注意错误处理变得多么丑陋：我们必须处理InterruptedException （从技术上讲，这应该永远不会发生，因为Future已经解决，并且get()永远不会抛出它）和ExecutionException 。 我们还没有介绍，但是Future<T>必须以某种方式处理异步计算期间发生的异常。 此类异常包含在从get()引发的ExecutionException （因此在记录期间调用getCause() get() 。

最后请注意正在使用MoreExecutors.sameThreadExecutor() 。 这是一个方便的抽象，您可以使用每API一些想要使用的时间Executor / ExecutorService （大概线程池），而你的罚款使用当前线程。 这在单元测试期间特别有用–即使您的生产代码使用异步任务，在测试期间您也可以从同一线程运行所有内容。

不管它多么方便，整个代码看起来都有些混乱。 幸运的是，在梦幻般的Futures类中有一个简单的实用程序方法：

Futures.addCallback(future, new FutureCallback<String>() {
    @Override
    public void onSuccess(String contents) {
        //...process web site contents
    }

    @Override
    public void onFailure(Throwable throwable) {
        log.error("Exception in task", throwable);
    }
});

FutureCallback是一个更简单的抽象方法，可以解决将来的问题并为您执行异常处理。 如果需要，您仍然可以为侦听器提供自定义线程池。 如果您仍然使用一些仍会返回Future旧式API，则可以尝试JdkFutureAdapters.listenInPoolThread() ，它是将普通Future<V>转换为ListenableFuture<V>的适配器。 但是请记住，一旦开始使用addListener() ，每个这样的适配器将只需要一个线程即可工作，因此此解决方案根本无法扩展，因此应避免使用它。

Future<String> future = //...
ListenableFuture<String> listenableFuture =
        JdkFutureAdapters.listenInPoolThread(future);

一旦了解了基础知识，我们就可以深入探究听期货的最大优势： 转型和连锁 。 这是高级材料，已被警告。

参考： NoBlogDefFound博客中来自JCG合作伙伴 Tomasz Nurkiewicz的番石榴中的ListenableFuture 。

翻译自: https://www.javacodegeeks.com/2013/02/listenablefuture-in-guava.html