База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CompletableFuture.get(): изчакване на резултат

Използвай `get()`, за да получиш резултата, или `get(timeout, unit)`, за да ограничиш чакането. За разлика от `join()`, и двата варианта декларират проверявани изключения.

Версия: Java SE 21

Синтаксис

public T get() throws InterruptedException, ExecutionException
public T get(long timeout, java.util.concurrent.TimeUnit unit) throws InterruptedException, ExecutionException, java.util.concurrent.TimeoutException

В Java SE 21 CompletableFuture.get е метод на екземпляр от класа java.util.concurrent.CompletableFuture<T>. Извикването на get() блокира извикващата нишка само ако трябва да изчака завършването. Ако обектът вече е завършен, методът не чака; при успешно завършване връща резултат от тип T.

И двата претоварени варианта хвърлят InterruptedException, ако извикващата нишка бъде прекъсната по време на чакането, или ExecutionException, ако изчислението се провали. Използвай getCause(), за да видиш причината за неуспеха. Ако самият обект е отменен, се хвърля непроверяваното изключение CancellationException. Проверяваните изключения трябва да се прихванат или да се декларират с throws.

get(long timeout, TimeUnit unit) ограничава чакането, например при извикване на future.get(2, TimeUnit.SECONDS). Ако срокът изтече преди завършването, извикването хвърля проверяваното изключение TimeoutException; изтичането на срока нито отменя, нито завършва обекта.

join() също може да блокира и също хвърля CancellationException при отмяна, но не декларира проверявани изключения: неуспехът на изчислението се съобщава чрез непроверяваното изключение CompletionException. За да обработиш резултата без блокиращо извличане на мястото на извикване, добави следващ етап, например с thenApply.

Примери

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class Main {
    public static void main(String[] args) throws InterruptedException, ExecutionException {
        CompletableFuture<Integer> pending = new CompletableFuture<>();
        try {
            pending.get(0, TimeUnit.MILLISECONDS);
            throw new AssertionError("Expected a timeout");
        } catch (TimeoutException e) {
            System.out.println("Timed out");
        }

        pending.complete(42);
        System.out.println("Result: " + pending.get());

        CompletableFuture<Integer> failed =
                CompletableFuture.failedFuture(new IllegalStateException("No result"));
        try {
            failed.get();
        } catch (ExecutionException e) {
            System.out.println("get cause: " + e.getCause().getMessage());
        }
        try {
            failed.join();
        } catch (CompletionException e) {
            System.out.println("join cause: " + e.getCause().getMessage());
        }
    }
}

Резултат

Timed out
Result: 42
get cause: No result
join cause: No result

Нулевият срок води до `TimeoutException`, защото `pending` още не е завършен. След `complete(42)` методът `get()` връща `42` без чакане. Накрая `get()` и `join()` показват една и съща причина за неуспеха, обвита в две различни изключения.

Свързани уроци

  • Java · Урок 51 · Средно · Версия: 2

Източници