Futures工具类使用
Futures是guava提供的工具类，全类名是com.google.common.util.concurrent.Futures。配合MoreExecutors使用，效果极佳。
主要方法如下：
1、addCallback()方法：
public static void addCallback(ListenableFuture future, FutureCallback callback, Executor executor)：给ListenableFuture实例添加一个回调，作用等同于调用ListenableFuture实例的addListener(Runnable listener, Executor executor)方法。
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<Integer> future = listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1);
Futures.addCallback(future, new FutureCallback<Integer>() {
@Override
public void onSuccess(Integer result) {
System.out.println(Thread.currentThread().getName() + "@" + result);
}
@Override
public void onFailure(Throwable t) {
System.out.println(Thread.currentThread().getName() + "@" + t.getMessage());
}
}, threadPoolExecutor);
System.out.println(Thread.currentThread().getName() + "@888");
}
ExecutorService对应Future，ListeningExecutorService对应ListenableFuture。
2、allAsList()方法的两个重载：
public static ListenableFuture<List<V>> allAsList(ListenableFuture<V>... futures)
public static ListenableFuture<List<V>> allAsList(Iterable<ListenableFuture<V>> futures)
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<List<Integer>> mergedListenableFuture = Futures.allAsList(
Lists.newArrayList(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 2)
)
);
try {
List<Integer> resultList = mergedListenableFuture.get();
System.out.println(resultList);
} catch (Exception e) {
e.printStackTrace();
}
Futures.addCallback(mergedListenableFuture,
new FutureCallback<List<Integer>>() {
@Override
public void onSuccess(List<Integer> result) {
try {
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName() + ", success callback");
} catch (InterruptedException e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Throwable t) {
try {
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName() + ", " + t.getMessage());
} catch (InterruptedException e) {
e.printStackTrace();
}
}
},
threadPoolExecutor);
}
可以用来把多个ListenableFuture实例合并成一个ListenableFuture实例，组合的ListenableFuture实例的get()方法返回一个集合，集合中的元素是之前各ListenableFuture实例的get()方法返回值，且元素顺序同allAsList()方法入参Future实例对应。假如对这个组合的ListenableFuture实例添加回调，则回调会在原来所有ListenableFuture实例都done之后才执行。同样，假如某一个ListenableFuture实例对应任务抛异常，则组合的ListenableFuture实例的get()也会抛异常。
3、successfulAsList()方法的两个重载：
public static ListenableFuture<List<V>> successfulAsList(ListenableFuture<V>... futures)
public static ListenableFuture<List<V>> successfulAsList(Iterable<ListenableFuture<V>> futures)
successfulAsList()方法和allAsList()方法有一点区别，就是组合的ListenableFuture实例的get()方法永远不会抛异常，即使之前某ListenableFuture实例对应的任务抛异常。如果某任务抛异常，则get()方法返回的集合中对应位置的值为null。极端情况下，get()方法会返回一个纯null的集合。
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<List<Integer>> mergedListenableFuture = Futures.successfulAsList(
Lists.newArrayList(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println(Lists.newArrayList(1, 2).get(3));
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println("".substring(2));
}, 2)
)
);
try {
List<Integer> resultList = mergedListenableFuture.get();
System.out.println(resultList);
} catch (Exception e) {
e.printStackTrace();
}
Futures.addCallback(mergedListenableFuture,
new FutureCallback<List<Integer>>() {
@Override
public void onSuccess(List<Integer> result) {
try {
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName() + ", success callback");
} catch (InterruptedException e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Throwable t) {
try {
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName() + ", " + t.getMessage());
} catch (InterruptedException e) {
e.printStackTrace();
}
}
},
threadPoolExecutor);
}
4、whenAllComplete()方法的两个重载：
public static FutureCombiner<V> whenAllComplete(ListenableFuture<V>... futures)
public static FutureCombiner<V> whenAllComplete(Iterable<ListenableFuture<V>> futures)
当所有ListenableFuture实例都执行完后，做一些操作，其中一些ListenableFuture实例对应任务抛异常也不要紧，不影响接下来要做的事情。
返回的FutureCombiner实例，有三个实例方法可以使用，返回值都是ListenableFuture类型，利用这个特性还可以实现链式异步操作。异步1执行完后执行异步2，异步2完成之后执行异步3，只要需要，就可以一直这么链式下去。
FutureCombiner常用实例方法：
public ListenableFuture<C> call(Callable<C> combiner, Executor executor)
public ListenableFuture<C> callAsync(AsyncCallable<C> combiner, Executor executor)
public ListenableFuture<?> run(Runnable combiner, Executor executor)
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<Integer> listenableFuture1 = Futures.whenAllComplete(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println(Lists.newArrayList(1, 2).get(3));
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println("".substring(2));
}, 2)
).call(() -> {
System.out.println(123);
return 1;
}, threadPoolExecutor);
Futures.whenAllComplete(listenableFuture1).call(() -> {
System.out.println(456);
return 2;
}, threadPoolExecutor);
}
5、whenAllSucceed()方法的两个重载
public static FutureCombiner<V> whenAllSucceed(ListenableFuture<V>... futures)
public static FutureCombiner<V> whenAllSucceed(Iterable<ListenableFuture<V>> futures)
whenAllSucceed()方法和whenAllComplete()方法有一点区别，就是如果入参某个实例对应任务抛异常，则返回值FutureCombiner实例的call()方法或者run()方法入参的任务不会执行，也不抛异常。
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
Futures.FutureCombiner futureCombiner = Futures.whenAllSucceed(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println("".substring(2));
}, 2)
);
futureCombiner.call(() -> {
System.out.println(123);
return 1;
}, threadPoolExecutor);
try {
Thread.sleep(5000);
} catch (Exception e) {
e.printStackTrace();
}
System.out.println(456);
}
本例由于whenAllSucceed()方法第二个入参ListenableFuture实例对应的任务会抛异常，所以FutureCombiner实例的call()方法的任务不会执行，故不会打印123。
6、catching开头的两个方法：
public static ListenableFuture<V> catching(ListenableFuture<V> input, Class<X> exceptionType, Function<X, V> fallback, Executor executor)
注意，这里的Function不是jdk的java.util.function.Function，而是guava的Function，在base 子package中，全类名是com.google.common.base.Function。
public static ListenableFuture<V> catchingAsync(ListenableFuture<V> input, Class<X> exceptionType, AsyncFunction<X, V> fallback, Executor executor)
当ListenableFuture实例对应的任务抛异常时，假如抛出的异常是指定的类型，则可以执行planB。
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<List<Integer>> mergedListenableFuture = Futures.allAsList(
Lists.newArrayList(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
System.out.println(Thread.currentThread().getName() + "".substring(2));
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 2)
)
);
ListenableFuture<List<Integer>> withFallbackListenableFuture = Futures.catching(mergedListenableFuture,
StringIndexOutOfBoundsException.class,
input -> getBackUpList(),
threadPoolExecutor
);
try {
System.out.println(withFallbackListenableFuture.get());
} catch (Exception e) {
e.printStackTrace();
}
}
private static List<Integer> getBackUpList() {
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
return new ArrayList<>();
}
只有当input抛出指定异常时，才会执行fallback方法。如果fallback方法也抛了异常，则最终ListenableFuture实例的get()方法会抛异常。
catchingAsync()方法，第三个参数是AsyncFunction实例，AsyncFunction也是个函数式接口，只是这个接口的方法的返回值必须是ListenableFuture类型，用起来没有catching()方法方便。
7、public static ImmutableList<ListenableFuture<T>> inCompletionOrder(Iterable<ListenableFuture<T>> futures)
返回一个不可变的ListenableFuture实例的集合，集合中元素顺序和各ListenableFuture实例执行完的顺序一致
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ImmutableList<ListenableFuture<Integer>> listenableFutureList = Futures.inCompletionOrder(Lists.newArrayList(
listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1),
listeningExecutorService.submit(() -> {
try {
Thread.sleep(2000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 2)
)
);
listenableFutureList.forEach(p -> {
try {
System.out.println(Thread.currentThread().getName() + p.get());
} catch (Exception e) {
e.printStackTrace();
}
});
}
8、transform()相关的三个方法：
public static ListenableFuture<O> transform(ListenableFuture<I> input, Function<I, O> function, Executor executor)
public static ListenableFuture<O> transformAsync(ListenableFuture<I> input, AsyncFunction<I, O> function, Executor executor)
public static Future<O> lazyTransform(Future<I> input, Function<I, O> function)
transform()方法和transformAsync()方法，返回一个ListenableFuture实例，其结果是由入参ListenableFuture实例的结果通过入参Function实例计算得出。如果入参ListenableFuture实例对应的任务抛异常，则返回的ListenableFuture实例也会抛同样的异常，Function实例不会执行。如果入参ListenableFuture实例对应的任务被取消，则返回的ListenableFuture实例也会被取消。如果返回的ListenableFuture实例被取消，则入参ListenableFuture实例也会被取消。
lazyTransform()方法比较特殊， 入参Function实例不会主动执行，只有在返回的Future实例的get()方法被调用时，Function实例才会执行，但是这样又会阻塞当前主线程。所以这个方法不是很实用。
示例：
public static void main(String[] args) throws ExecutionException, InterruptedException {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ThreadPoolExecutor threadPoolExecutor =
new ThreadPoolExecutor(10, 20, 0, TimeUnit.MINUTES, new LinkedBlockingQueue<>(3000), threadFactory);
ListeningExecutorService listeningExecutorService = MoreExecutors.listeningDecorator(threadPoolExecutor);
ListenableFuture<Integer> oriListenableFuture = listeningExecutorService.submit(() -> {
try {
Thread.sleep(4000);
System.out.println(Thread.currentThread().getName() + "@666");
} catch (InterruptedException e) {
e.printStackTrace();
}
}, 1);
Future future = Futures.lazyTransform(oriListenableFuture, input -> {
try {
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName() + "@888");
} catch (InterruptedException e) {
e.printStackTrace();
}
return String.valueOf(input);
});
future.get();
System.out.println(456);
}
9、scheduleAsync()方法的两个重载：指定多少时间后执行任务，任务只会执行一次。
public static ListenableFuture<O> scheduleAsync(AsyncCallable<O> callable, long delay, TimeUnit timeUnit, ScheduledExecutorService executorService)
public static ListenableFuture<O> scheduleAsync(AsyncCallable<O> callable, Duration delay, ScheduledExecutorService executorService)
AsyncCallable也是个函数式接口，无入参，出参是一个ListenableFuture实例。
示例：
public static void main(String[] args) {
ThreadFactory threadFactory = new ThreadFactoryBuilder().setNameFormat("async-pool-%d").build();
ScheduledExecutorService scheduledExecutorService = new ScheduledThreadPoolExecutor(5, threadFactory, new ThreadPoolExecutor.CallerRunsPolicy());
Futures.scheduleAsync(() -> {
ListenableFuture sf = MoreExecutors.listeningDecorator(scheduledExecutorService).submit(() -> {
System.out.println(Thread.currentThread().getName() + "@" + System.currentTimeMillis());
});
return sf;
}, 5, TimeUnit.SECONDS, scheduledExecutorService);
}
上例中，5s后会打印一次，只打印一次。
若要想真的定时任务，应该怎么写呢？比如说，要求每5s打印一次。
示例：
10、withTimeout()方法的两个重载：
Futures工具类使用的更多相关文章
- MoreExecutors工具类使用
MoreExecutors是guava提供的工具类,是对jdk自带的Executors工具类的扩展,主要方法如下: 1.addDelayedShutDown()方法的两个重载: public stat ...
- Retrofit+RxJava联网工具类
在python 进程.线程 (一)中简单的说过,CPython中的GIL使得同一时刻只能有一个线程运行,即并发执行.并且即使是多核CPU,GIL使得同一个进程中的多个线程也无法映射到多个CPU上运行, ...
- Java并发包线程池之Executors、ExecutorCompletionService工具类
前言 前面介绍了Java并发包提供的三种线程池,它们用处各不相同,接下来介绍一些工具类,对这三种线程池的使用. Executors Executors是JDK1.5就开始存在是一个线程池工具类,它定义 ...
- Java基础Map接口+Collections工具类
1.Map中我们主要讲两个接口 HashMap 与 LinkedHashMap (1)其中LinkedHashMap是有序的 怎么存怎么取出来 我们讲一下Map的增删改查功能: /* * Ma ...
- Android—关于自定义对话框的工具类
开发中有很多地方会用到自定义对话框,为了避免不必要的城府代码,在此总结出一个工具类. 弹出对话框的地方很多,但是都大同小异,不同无非就是提示内容或者图片不同,下面这个类是将提示内容和图片放到了自定义函 ...
- [转]Java常用工具类集合
转自:http://blog.csdn.net/justdb/article/details/8653166 数据库连接工具类——仅仅获得连接对象 ConnDB.java package com.ut ...
- js常用工具类.
一些js的工具类 复制代码 /** * Created by sevennight on 15-1-31. * js常用工具类 */ /** * 方法作用:[格式化时间] * 使用方法 * 示例: * ...
- Guava库介绍之实用工具类
作者:Jack47 转载请保留作者和原文出处 欢迎关注我的微信公众账号程序员杰克,两边的文章会同步,也可以添加我的RSS订阅源. 本文是我写的Google开源的Java编程库Guava系列之一,主要介 ...
- Java程序员的日常—— Arrays工具类的使用
这个类在日常的开发中,还是非常常用的.今天就总结一下Arrays工具类的常用方法.最常用的就是asList,sort,toStream,equals,copyOf了.另外可以深入学习下Arrays的排 ...
随机推荐
- 应用安全 - 工具 - 中间件 - Apache - Apache Tika - 漏洞汇总
CVE-2016-6809 Date2016 类型远程代码执行 影响范围Apache Tika 1.6-1.13 CVE-2018-1335 Date2018 类型命令注入 影响范围Tika-serv ...
- python 并发编程 多线程 GIL与Lock
GIL与Lock Python已经有一个GIL来保证同一时间只能有一个线程来执行了,为什么这里还需要互斥锁lock? 锁的目的是为了保护共享的数据,同一时间只能有一个线程来修改共享的数据 GIT保证了 ...
- excel常用公式--关联匹配类
index: 根据位置返回单元格的值. match: 根据单元格的值返回位置. index+match替代vlookup rank:返回一列数字的数字排位.数字的排位是其相对于列表中其他值的大小.
- C语言I博客作业12
一.我学到的内容 二.我的收获 作业链接 收获 博客第一次作业:https://www.cnblogs.com/gm12/p/11584148.html 第一次作业收获:第一次作业是我初步接触C语言的 ...
- windows jenkins 发布 springboot项目脚本
windows jenkins 发布 springboot项目脚本 1.关闭现有程序 (按端口关闭) [与按应用关闭 二选一] @echo off for /f "tokens=1-5&q ...
- Process进程 ProcessStartInfo.UseShellExecute 属性
https://docs.microsoft.com/zh-cn/previous-versions/dotnet/netframework-1.1/k7z89z41(v=vs.80) 启动进程示例: ...
- oracle ojdbc 版本须对应，否则日期字段查询结果与实际值可能不一致
1. 数据库版本:select * from v$version; 2. 版本对应:
- Exchange 2010的部署
实验拓扑: 实验准备条件:计算机基本配置的准备:DC (vbers):配置IP地址.子网掩码.网关EX (vbers2):配置IP地址.子网掩码.网关.指定DNS 域环境搭建的准备1.在计算机名为vb ...
- Jquery复习（三）之链式调用
通过 jQuery,可以把动作/方法链接在一起. Chaining 允许我们在一条语句中运行多个 jQuery 方法(在相同的元素上). jQuery 方法链接 直到现在,我们都是一次写一条 jQue ...
- java json对象转换
引入的jar包: commons-beanutils-1.9.2.jar commons-collections-3.2.1.jar commons-lang-2.6.jar commons-logg ...