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>() {@Overridepublic String call() throws Exception {return IOUtils.toString(siteUrl, StandardCharsets.UTF_8);}});future.addListener(new Runnable() {@Overridepublic 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>() {@Overridepublic void onSuccess(String contents) {//...process web site contents}@Overridepublic 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