前言

以前需要異步執行一個任務時，一般是用Thread或者執行緒池Executor去創建，如果需要回傳值，則是呼叫Executor.submit獲取Future，但是多個執行緒存在依賴組合，我們又能怎么辦？可使用同步組件CountDownLatch、CyclicBarrier等；其實有簡單的方法，就是用CompeletableFuture

執行緒任務的創建
執行緒任務的串行執行
執行緒任務的并行執行
處理任務結果和例外
多任務的簡單組合
取消執行執行緒任務
任務結果的獲取和完成與否判斷

1 創建異步執行緒任務

根據supplier創建CompletableFuture任務

//使用內置執行緒ForkJoinPool.commonPool()，根據supplier構建執行任務
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier)
//指定自定義執行緒，根據supplier構建執行任務
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)

根據runnable創建CompletableFuture任務

//使用內置執行緒ForkJoinPool.commonPool()，根據runnable構建執行任務
public static CompletableFuture<Void> runAsync(Runnable runnable)
//指定自定義執行緒，根據runnable構建執行任務
public static CompletableFuture<Void> runAsync(Runnable runnable, Executor executor)

使用示例

ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> rFuture = CompletableFuture
        .runAsync(() -> System.out.println("hello siting"), executor);
//supplyAsync的使用
CompletableFuture<String> future = CompletableFuture
        .supplyAsync(() -> {
            System.out.print("hello ");
            return "siting";
        }, executor);

//阻塞等待，runAsync 的future 無回傳值，輸出null
System.out.println(rFuture.join());
//阻塞等待
String name = future.join();
System.out.println(name);
executor.shutdown(); // 執行緒池需要關閉
--------輸出結果--------
hello siting
null
hello siting

常量值作為CompletableFuture回傳

//有時候是需要構建一個常量的CompletableFuture
public static <U> CompletableFuture<U> completedFuture(U value)

2 執行緒串行執行

任務完成則運行action，不關心上一個任務的結果，無回傳值

public CompletableFuture<Void> thenRun(Runnable action)
public CompletableFuture<Void> thenRunAsync(Runnable action)
public CompletableFuture<Void> thenRunAsync(Runnable action, Executor executor)

使用示例

CompletableFuture<Void> future = CompletableFuture
        .supplyAsync(() -> "hello siting", executor)
        .thenRunAsync(() -> System.out.println("OK"), executor);
executor.shutdown();
--------輸出結果--------
OK

任務完成則運行action，依賴上一個任務的結果，無回傳值

public CompletableFuture<Void> thenAccept(Consumer<? super T> action)
public CompletableFuture<Void> thenAcceptAsync(Consumer<? super T> action)
public CompletableFuture<Void> thenAcceptAsync(Consumer<? super T> action, Executor executor)

使用示例

ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> future = CompletableFuture
        .supplyAsync(() -> "hello siting", executor)
        .thenAcceptAsync(System.out::println, executor);
executor.shutdown();
--------輸出結果--------
hello siting

任務完成則運行fn，依賴上一個任務的結果，有回傳值

public <U> CompletableFuture<U> thenApply(Function<? super T,? extends U> fn)
public <U> CompletableFuture<U> thenApplyAsync(Function<? super T,? extends U> fn)        
public <U> CompletableFuture<U> thenApplyAsync(Function<? super T,? extends U> fn, Executor executor)

使用示例

ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<String> future = CompletableFuture
        .supplyAsync(() -> "hello world", executor)
        .thenApplyAsync(data -> {
            System.out.println(data); return "OK";
        }, executor);
System.out.println(future.join());
executor.shutdown();
--------輸出結果--------
hello world
OK

thenCompose - 任務完成則運行fn，依賴上一個任務的結果，有回傳值

類似thenApply（區別是thenCompose的回傳值是CompletionStage，thenApply則是回傳 U），提供該方法為了和其他CompletableFuture任務更好地配套組合使用

public <U> CompletableFuture<U> thenCompose(Function<? super T, ? extends CompletionStage<U>> fn) 
public <U> CompletableFuture<U> thenComposeAsync(Function<? super T, ? extends CompletionStage<U>> fn)
public <U> CompletableFuture<U> thenComposeAsync(Function<? super T, ? extends CompletionStage<U>> fn,
		Executor executor)

使用示例

//第一個異步任務，常量任務
CompletableFuture<String> f = CompletableFuture.completedFuture("OK");
//第二個異步任務
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<String> future = CompletableFuture
        .supplyAsync(() -> "hello world", executor)
        .thenComposeAsync(data -> {
            System.out.println(data); return f; //使用第一個任務作為回傳
        }, executor);
System.out.println(future.join());
executor.shutdown();
--------輸出結果--------
hello world
OK

3 執行緒并行執行，合并兩任務

兩個CompletableFuture并行執行完，然后執行action，不依賴上兩個任務的結果，無回傳值

public CompletableFuture<Void> runAfterBoth(CompletionStage<?> other, Runnable action)
public CompletableFuture<Void> runAfterBothAsync(CompletionStage<?> other, Runnable action)
public CompletableFuture<Void> runAfterBothAsync(CompletionStage<?> other, Runnable action, Executor executor)

使用示例

//第一個異步任務，常量任務
CompletableFuture<String> first = CompletableFuture.completedFuture("hello world");
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() -> "hello siting", executor)
        // () -> System.out.println("OK") 是第三個任務
        .runAfterBothAsync(first, () -> System.out.println("OK"), executor);
executor.shutdown();
--------輸出結果--------
OK

兩個CompletableFuture并行執行完，然后執行action，依賴上兩個任務的結果，無回傳值

//第一個任務完成再運行other，fn再依賴消費兩個任務的結果，無回傳值
public <U> CompletableFuture<Void> thenAcceptBoth(CompletionStage<? extends U> other,
        BiConsumer<? super T, ? super U> action)
//兩個任務異步完成，fn再依賴消費兩個任務的結果，無回傳值     
public <U> CompletableFuture<Void> thenAcceptBothAsync(CompletionStage<? extends U> other,
        BiConsumer<? super T, ? super U> action)  
//兩個任務異步完成（第二個任務用指定執行緒池執行），fn再依賴消費兩個任務的結果，無回傳值                
public <U> CompletableFuture<Void> thenAcceptBothAsync(CompletionStage<? extends U> other,
        BiConsumer<? super T, ? super U> action, Executor executor)

使用示例

//第一個異步任務，常量任務
CompletableFuture<String> first = CompletableFuture.completedFuture("hello world");
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() -> "hello siting", executor)
        // (w, s) -> System.out.println(s) 是第三個任務
        .thenAcceptBothAsync(first, (s, w) -> System.out.println(s), executor);
executor.shutdown();
--------輸出結果--------
hello siting

兩個CompletableFuture并行執行完，然后執行action，依賴上兩個任務的結果，有回傳值

//第一個任務完成再運行other，fn再依賴消費兩個任務的結果，有回傳值
public <U,V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, 
		BiFunction<? super T,? super U,? extends V> fn)
//兩個任務異步完成，fn再依賴消費兩個任務的結果，有回傳值
public <U,V> CompletableFuture<V> thenCombineAsync(CompletionStage<? extends U> other,
        BiFunction<? super T,? super U,? extends V> fn)   
//兩個任務異步完成（第二個任務用指定執行緒池執行），fn再依賴消費兩個任務的結果，有回傳值        
public <U,V> CompletableFuture<V> thenCombineAsync(CompletionStage<? extends U> other,
        BiFunction<? super T,? super U,? extends V> fn, Executor executor)

使用示例

//第一個異步任務，常量任務
CompletableFuture<String> first = CompletableFuture.completedFuture("hello world");
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<String> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() -> "hello siting", executor)
        // (w, s) -> System.out.println(s) 是第三個任務
        .thenCombineAsync(first, (s, w) -> {
            System.out.println(s);
            return "OK";
        }, executor);
System.out.println(future.join());
executor.shutdown();
--------輸出結果--------
hello siting
OK

4 執行緒并行執行，誰先執行完則誰觸發下一任務（二者選其最快）

上一個任務或者other任務完成, 運行action，不依賴上個任務的結果，無回傳值

public CompletableFuture<Void> runAfterEither(CompletionStage<?> other, Runnable action)   
public CompletableFuture<Void> runAfterEitherAsync(CompletionStage<?> other, Runnable action)
public CompletableFuture<Void> runAfterEitherAsync(CompletionStage<?> other,
		Runnable action, Executor executor)

使用示例

//第一個異步任務，休眠1秒，保證最晚執行晚
CompletableFuture<String> first = CompletableFuture.supplyAsync(()->{
    try{ Thread.sleep(1000); }catch (Exception e){}
    System.out.println("hello world");
    return "hello world";
});
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() ->{
            System.out.println("hello siting");
            return "hello siting";
        } , executor)
        //() ->  System.out.println("OK") 是第三個任務
        .runAfterEitherAsync(first, () ->  System.out.println("OK") , executor);
executor.shutdown();
--------輸出結果--------
hello siting
OK

上一個任務或者other任務完成, 運行action，依賴最先完成任務的結果，無回傳值

public CompletableFuture<Void> acceptEither(CompletionStage<? extends T> other,
		Consumer<? super T> action)
public CompletableFuture<Void> acceptEitherAsync(CompletionStage<? extends T> other,
		Consumer<? super T> action, Executor executor)       
public CompletableFuture<Void> acceptEitherAsync(CompletionStage<? extends T> other,
		Consumer<? super T> action, Executor executor)

使用示例

//第一個異步任務，休眠1秒，保證最晚執行晚
CompletableFuture<String> first = CompletableFuture.supplyAsync(()->{
    try{ Thread.sleep(1000);  }catch (Exception e){}
    return "hello world";
});
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<Void> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() -> "hello siting", executor)
        // data ->  System.out.println(data) 是第三個任務
        .acceptEitherAsync(first, data ->  System.out.println(data) , executor);
executor.shutdown();
--------輸出結果--------
hello siting

上一個任務或者other任務完成, 運行fn，依賴最先完成任務的結果，有回傳值

public <U> CompletableFuture<U> applyToEither(CompletionStage<? extends T> other,
		Function<? super T, U> fn) 
public <U> CompletableFuture<U> applyToEitherAsync(CompletionStage<? extends T> other,
		Function<? super T, U> fn)         
public <U> CompletableFuture<U> applyToEitherAsync(CompletionStage<? extends T> other,
		Function<? super T, U> fn, Executor executor)

使用示例

//第一個異步任務，休眠1秒，保證最晚執行晚
CompletableFuture<String> first = CompletableFuture.supplyAsync(()->{
    try{ Thread.sleep(1000);  }catch (Exception e){}
    return "hello world";
});
ExecutorService executor = Executors.newSingleThreadExecutor();
CompletableFuture<String> future = CompletableFuture
        //第二個異步任務
        .supplyAsync(() -> "hello siting", executor)
        // data ->  System.out.println(data) 是第三個任務
        .applyToEitherAsync(first, data ->  {
            System.out.println(data);
            return "OK";
        } , executor);
System.out.println(future);
executor.shutdown();
--------輸出結果--------
hello siting
OK

5 處理任務結果或者例外

exceptionally-處理例外

public CompletableFuture<T> exceptionally(Function<Throwable, ? extends T> fn)

如果之前的處理環節有例外問題，則會觸發exceptionally的呼叫相當于 try…catch
使用示例

CompletableFuture<Integer> first = CompletableFuture
        .supplyAsync(() -> {
            if (true) {
                throw new RuntimeException("main error!");
            }
            return "hello world";
        })
        .thenApply(data -> 1)
        .exceptionally(e -> {
            e.printStackTrace(); // 例外捕捉處理，前面兩個處理環節的日常都能捕獲
            return 0;
        });

handle-任務完成或者例外時運行fn，回傳值為fn的回傳

相比exceptionally而言，即可處理上一環節的例外也可以處理其正常回傳值

public <U> CompletableFuture<U> handle(BiFunction<? super T, Throwable, ? extends U> fn) 
public <U> CompletableFuture<U> handleAsync(BiFunction<? super T, Throwable, ? extends U> fn) 
public <U> CompletableFuture<U> handleAsync(BiFunction<? super T, Throwable, ? extends U> fn, 
		Executor executor)

使用示例

CompletableFuture<Integer> first = CompletableFuture
        .supplyAsync(() -> {
            if (true) { throw new RuntimeException("main error!"); }
            return "hello world";
        })
        .thenApply(data -> 1)
        .handleAsync((data,e) -> {
            e.printStackTrace(); // 例外捕捉處理
            return data;
        });
System.out.println(first.join());
--------輸出結果--------
java.util.concurrent.CompletionException: java.lang.RuntimeException: main error!
	... 5 more
null

whenComplete-任務完成或者例外時運行action，有回傳值

whenComplete與handle的區別在于，它不參與回傳結果的處理，把它當成監聽器即可
即使例外被處理，在CompletableFuture外層，例外也會再次復現
使用whenCompleteAsync時，回傳結果則需要考慮多執行緒操作問題，畢竟會出現兩個執行緒同時操作一個結果

public CompletableFuture<T> whenComplete(BiConsumer<? super T, ? super Throwable> action) 
public CompletableFuture<T> whenCompleteAsync(BiConsumer<? super T, ? super Throwable> action) 
public CompletableFuture<T> whenCompleteAsync(BiConsumer<? super T, ? super Throwable> action,
		Executor executor)

使用示例

CompletableFuture<AtomicBoolean> first = CompletableFuture
        .supplyAsync(() -> {
            if (true) {  throw new RuntimeException("main error!"); }
            return "hello world";
        })
        .thenApply(data -> new AtomicBoolean(false))
        .whenCompleteAsync((data,e) -> {
            //例外捕捉處理, 但是例外還是會在外層復現
            System.out.println(e.getMessage());
        });
first.join();
--------輸出結果--------
java.lang.RuntimeException: main error!
Exception in thread "main" java.util.concurrent.CompletionException: java.lang.RuntimeException: main error!
	... 5 more

6 多個任務的簡單組合

public static CompletableFuture<Void> allOf(CompletableFuture<?>... cfs)
public static CompletableFuture<Object> anyOf(CompletableFuture<?>... cfs)

使用示例

 CompletableFuture<Void> future = CompletableFuture
        .allOf(CompletableFuture.completedFuture("A"),
                CompletableFuture.completedFuture("B"));
//全部任務都需要執行完
future.join();
CompletableFuture<Object> future2 = CompletableFuture
        .anyOf(CompletableFuture.completedFuture("C"),
                CompletableFuture.completedFuture("D"));
//其中一個任務行完即可
future2.join();

8 取消執行執行緒任務

// mayInterruptIfRunning 無影響；如果任務未完成,則回傳例外
public boolean cancel(boolean mayInterruptIfRunning) 
//任務是否取消
public boolean isCancelled()

使用示例

CompletableFuture<Integer> future = CompletableFuture
        .supplyAsync(() -> {
            try { Thread.sleep(1000);  } catch (Exception e) { }
            return "hello world";
        })
        .thenApply(data -> 1);

System.out.println("任務取消前:" + future.isCancelled());
// 如果任務未完成,則回傳例外,需要對使用exceptionally，handle 對結果處理
future.cancel(true);
System.out.println("任務取消后:" + future.isCancelled());
future = future.exceptionally(e -> {
    e.printStackTrace();
    return 0;
});
System.out.println(future.join());
--------輸出結果--------
任務取消前:false
任務取消后:true
java.util.concurrent.CancellationException
	at java.util.concurrent.CompletableFuture.cancel(CompletableFuture.java:2276)
	at Test.main(Test.java:25)
0

9 任務的獲取和完成與否判斷

// 任務是否執行完成
public boolean isDone()
//阻塞等待 獲取回傳值
public T join()
// 阻塞等待 獲取回傳值,區別是get需要回傳受檢例外
public T get()
//等待阻塞一段時間，并獲取回傳值
public T get(long timeout, TimeUnit unit)
//未完成則回傳指定value
public T getNow(T valueIfAbsent)
//未完成，使用value作為任務執行的結果，任務結束，需要future.get獲取
public boolean complete(T value)
//未完成，則是例外呼叫,回傳例外結果，任務結束
public boolean completeExceptionally(Throwable ex)
//判斷任務是否因發生例外結束的
public boolean isCompletedExceptionally()
//強制地將回傳值設定為value，無論該之前任務是否完成；類似complete
public void obtrudeValue(T value)
//強制地讓例外拋出，例外回傳，無論該之前任務是否完成；類似completeExceptionally
public void obtrudeException(Throwable ex)

使用示例

CompletableFuture<Integer> future = CompletableFuture
        .supplyAsync(() -> {
            try { Thread.sleep(1000);  } catch (Exception e) { }
            return "hello world";
        })
        .thenApply(data -> 1);

System.out.println("任務完成前:" + future.isDone());
future.complete(10);
System.out.println("任務完成后:" + future.join());
--------輸出結果--------
任務完成前:false
任務完成后:10

歡迎指正文中錯誤

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/230719.html

標籤：java

上一篇：java網路編程1、2章習題

下一篇：《Java開發手冊》閱讀筆記（三）

基礎篇：異步編程不會？我教你啊！CompeletableFuture（JDK1.8）

前言