Guava - 並行編程Futures

Guava為Java並行編程Future提供了很多有用擴展，其主要接口為ListenableFuture，並借助於Futures靜態擴展。

繼承至Future的ListenableFuture，允許我們添加回調函數在線程運算完成時返回值或者方法執行完成立即返回。

對ListenableFuture添加回調函數：

Futures.addCallback(ListenableFuture<V>, FutureCallback<V>, Executor)

其中 FutureCallback是一個包含onSuccess(V),onFailure(Throwable)的接口。

使用如：

Futures.addCallback(ListenableFuture, new FutureCallback<Object>() {

    public void onSuccess(Object result) {
        System.out.printf("onSuccess with: %s%n", result);
    }

    public void onFailure(Throwable thrown) {
        System.out.printf("onFailure %s%n", thrown.getMessage());
    }
});

同時Guava中Futures對於Future擴展還有：

• transform：對於ListenableFuture的返回值進行轉換。
• allAsList：對多個ListenableFuture的合並，返回一個當所有Future成功時返回多個Future返回值組成的List對象。注：當其中一個Future失敗或者取消的時候，將會進入失敗或者取消。
• successfulAsList：和allAsList相似，唯一差別是對於失敗或取消的Future返回值用null代替。不會進入失敗或者取消流程。
• immediateFuture/immediateCancelledFuture： 立即返回一個待返回值的ListenableFuture。
• makeChecked: 將ListenableFuture 轉換成CheckedFuture。CheckedFuture 是一個ListenableFuture ，其中包含了多個版本的get 方法，方法聲明拋出檢查異常.這樣使得創建一個在執行邏輯中可以拋出異常的Future更加容易
• JdkFutureAdapters.listenInPoolThread(future): guava同時提供了將JDK Future轉換為ListenableFuture的接口函數。

下邊是一個對於Future的測試demo：

@Test
public void should_test_furture() throws Exception {
    ListeningExecutorService service = MoreExecutors.listeningDecorator(Executors.newFixedThreadPool(10));

    ListenableFuture future1 = service.submit(new Callable<Integer>() {
        public Integer call() throws InterruptedException {
            Thread.sleep(1000);
            System.out.println("call future 1.");
            return 1;
        }
    });

    ListenableFuture future2 = service.submit(new Callable<Integer>() {
        public Integer call() throws InterruptedException {
            Thread.sleep(1000);
            System.out.println("call future 2.");
    //       throw new RuntimeException("----call future 2.");
            return 2;
        }
    });

    final ListenableFuture allFutures = Futures.allAsList(future1, future2);

    final ListenableFuture transform = Futures.transform(allFutures, new AsyncFunction<List<Integer>, Boolean>() {
        @Override
        public ListenableFuture apply(List<Integer> results) throws Exception {
            return Futures.immediateFuture(String.format("success future:%d", results.size()));
        }
    });

    Futures.addCallback(transform, new FutureCallback<Object>() {

        public void onSuccess(Object result) {
            System.out.println(result.getClass());
            System.out.printf("success with: %s%n", result);
        }

        public void onFailure(Throwable thrown) {
            System.out.printf("onFailure%s%n", thrown.getMessage());
        }
    });

    System.out.println(transform.get());
}

官方資料主頁：https://awk.so/@code.google.com!/p/guava-libraries/wiki/ListenableFutureExplained

更多Guava博文：

1. Guava – 並行編程Futures
2. Guava – EventBus(事件總線)