并发是一个难题，但是可以通过使用强力简单的抽象来显著的简化，为了简化问题，guava扩展了Future接口，即 ListenableFuture （可以监听的Future）。
我强烈建议你在你的所有代码里使用ListenableFuture去替代Future，原因如下：
- 很多的Futures 类的方法需要它。（Futures工具类使用）
- 它比后来改造为ListenableFutrue更简单。（早点使用比重构更简单）
- 工具方法的提供者不需要提供Future和ListenableFuture方法的变体。（不需要兼容两套）
接口
一个传统的Futrue代表一个异步计算的结果：一个可能完成也可能没有完成输出结果的计算。
一个Future可以用在进度计算，或者说是 一个提供给我们结果的服务的承诺。
一个ListenableFuture允许注册当你在计算完成的时候的回调，或者计算已经完成了。
这个简单的增强让高效支持多种操作成为可能。而Future接口并不能支持。
ListenbleFuture中添加的基本操作是
addListener（Runnable , Executor ），
它指出了当未来计算完成时，指定的Runnable会在指定的Executor中运行。
增加回调
很多用户喜欢使用 Futures.addCallback(ListenableFuture,FutureCallback,Executor)方法。
FutureCallback实现了下面两个方法：
- onSuccess(v) 当未来成功执行的动作，基于计算结果
- onFailure(Throwable) 当未来失败执行的动作，基于失败
创建
相较于jdk提供的 ExecutorService.submit(Callable)方法来初始化一个异步计算。它返回一个常规的Future,
guava提供了ListeningExecutorService接口，它返回ListenableFuture。
把ExecutorService转换为ListenableExecutorService
使用：MoreExecutors.listeningDecorator(ExecutorService)
基础用法如下：
/**
* 说明：使用例子代码
* @author carter
* 创建时间： 2020年03月19日 9:54 上午
**/
@Slf4j
public class ListenableFutureUtils {
public static void main(String[] args) {
ListeningExecutorService service = MoreExecutors.listeningDecorator(
Executors.newFixedThreadPool(10));
final ListenableFuture listenableFuture = service.submit(() -> {
try {
TimeUnit.SECONDS.sleep(5);
} catch (InterruptedException e) {
e.printStackTrace();
}
return new AResult(30, "male", 1);
});
Futures.addCallback(listenableFuture,
new FutureCallback() {
@Override
public void onSuccess(AResult aResult) {
log.info("计算成功，{}",aResult);
}
@Override
public void onFailure(Throwable throwable) {
log.error("计算错误",throwable);
}
},service);
}
@Data
@AllArgsConstructor
public static class AResult{
private Integer age;
private String sex;
private Integer id;
}
}
相对的，如果你想从基于FutureTask的API转换过来，
Guava提供了
ListenableFutureTask.create(Callable)
和
ListenableFutureTask.create(Runnable)
不同于jdk,ListenableFutureTask并不是直接扩展的。
如果你喜欢抽象的设置future的值，而不是实现一个方法然后计算值，可以考虑使用AbstractFuture或使用SettableFuture ；
如果你必须转换Future为ListenableFuture,你别无选择，必须使用 JdkFutureAdapters.listenInPoolThread(Future)来转换Future为ListenableFuture
任何时候只要可能，推荐你修改源码让它返回一个 ListenableFuture
应用
使用ListenablFuture最重要的原因是可以使用链式异步操作。
代码如下：
package com.xxx.demo;
import com.google.common.util.concurrent.AsyncFunction;
import com.google.common.util.concurrent.Futures;
import com.google.common.util.concurrent.ListenableFuture;
import lombok.AllArgsConstructor;
import lombok.Data;
/**
* 说明：异步操作链
* @author carter
* 创建时间： 2020年03月19日 10:11 上午
**/
public class ApplicationUtils {
public static void main(String[] args) {
Query query = new Query(30);
ListenableFuture rowKeyFuture = lookUp(query);
AsyncFunction queryFun = rowKey -> readData(rowKey);
final ListenableFuture queryResultListenableFuture =
Futures.transformAsync(rowKeyFuture, queryFun);
}
private static ListenableFuture readData(RowKey rowKey) {
return null;
}
private static ListenableFuture lookUp(Query query) {
return null;
}
@Data
@AllArgsConstructor
public static class RowKey {
private String id;
}
@Data
@AllArgsConstructor
public static class Query {
private Integer age;
}
@Data
@AllArgsConstructor
public static class QueryResult {
private String id;
private String age;
}
}
很多其他高效支持的操作ListenableFuture提供，而Future不提供。
不同的操作可以被不同的线程池执行，一个简单的ListenableFuture可以有多个操作去等待。
只要一个操作开始，其他多个操作应该开始，fan-out， 千帆竞发。
ListenableFuture可以实现这样的操作：它触发了所有请求的回调。
通过少量的工作，我们可以 fan-in.
触发一个ListenableFuture 来获得计算结果，当其他的Future结束的时候。
Futures.allAsList是一个例子。
方法介绍：
| 方法 | 描述 |
|---|---|
| transformAsync(ListenableFuture , AsyncFunction , Executor) | 返回一个新的ListenableFuture，它的结果是执行异步函数的返回，函数入参是ListenableFuture的返回结果； |
| transform(ListenableFuture , Function , Executor) | 返回一个新的ListenableFuture，它的结果是执行函数的返回，函数入参是ListenableFuture的返回结果； |
| allAsList(Iterable |
返回一个ListenableFuture，它的结果是一个list,包含每一个列表中的ListenableFuture的执行结果，任何一个ListenableFuture执行失败或者取消，最后的返回结果取消 |
| successfullAsList(Iterable |
返回一个ListenableFuture，它的结果是一个list,包含每一个列表中的ListenableFuture的执行结果，成功的是结果，失败或者取消的值使用null替代 |
AsyncFunction
代码如下：
package com.xxx.demo;
import com.google.common.collect.Lists;
import com.google.common.util.concurrent.FutureCallback;
import com.google.common.util.concurrent.Futures;
import com.google.common.util.concurrent.ListenableFuture;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import java.util.List;
/**
* 说明：成功执行结果汇集
* @author carter
* 创建时间： 2020年03月19日 10:34 上午
**/
@Slf4j
public class Test3 {
public static void main(String[] args) {
List> querys = Lists.newLinkedList();
final ListenableFuture> successfulAsList =
Futures.successfulAsList(querys);
Futures.addCallback(successfulAsList, new FutureCallback>() {
@Override
public void onSuccess(List queryResults) {
log.info("执行结果列表：{}",queryResults);
}
@Override
public void onFailure(Throwable throwable) {
log.error("执行失败",throwable);
}
});
}
@Data
@AllArgsConstructor
public static class QueryResult{
private Integer age;
}
}
嵌套的Future
你的代码调用一个通用接口并返回一个Future,很可能最终返回一个嵌套的Future.
package com.xxx.demo;
import com.google.common.util.concurrent.ListenableFuture;
import com.google.common.util.concurrent.ListeningExecutorService;
import com.google.common.util.concurrent.MoreExecutors;
import lombok.AllArgsConstructor;
import lombok.Data;
import java.util.concurrent.Callable;
import java.util.concurrent.Executors;
/**
* 说明：嵌套的ListenableFuture
* @author carter
* 创建时间： 2020年03月19日 10:43 上午
**/
public class Test4 {
public static void main(String[] args) {
final ListeningExecutorService executorService = MoreExecutors
.listeningDecorator(Executors.newFixedThreadPool(2));
final ListeningExecutorService otherExecutorService = MoreExecutors
.listeningDecorator(Executors.newFixedThreadPool(2));
Callable otherCallback = ()->new Foo("aaa");
final ListenableFuture> submit =
executorService.submit(() -> otherExecutorService.submit(otherCallback));
}
@Data
@AllArgsConstructor
public static class Foo{
private String name;
}
}
例子最后返回的是： ListenableFuture
这个代码不对，因为当外层的Future 取消的时候，无法传播到内层的Future,
这也是一个 使用get()检查别的Future或者Listnener的常规的错误，
但是，除非特别关注 否则 otherCallback抛出的异常会被压制。
为了避免这种情况，所有的guava的Future处理方法（有些从jdk来），有 *Async版本来安全的解开这个嵌套。
比如：transform，transformAsyn， submit, submitAsync方法。
深入研究
原创不易，转载请注明出处。