Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

CompletableFuture.get(): čekanje rezultata

Upotrijebi `get()` za dohvat rezultata ili `get(timeout, unit)` za ograničavanje čekanja. Za razliku od `join()`, obje inačice deklariraju provjeravane iznimke.

Verzija: Java SE 21

Sintaksa

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

U Javi SE 21 CompletableFuture.get je instancijska metoda klase java.util.concurrent.CompletableFuture<T>. Poziv get() blokira pozivajuću dretvu samo ako mora čekati dovršetak. Ako je objekt već dovršen, metoda ne čeka; u slučaju uspješnog dovršetka vraća rezultat tipa T.

Obje preopterećene inačice bacaju InterruptedException ako se pozivajuća dretva prekine tijekom čekanja ili ExecutionException ako izračun ne uspije. Uzrok pogreške možeš pregledati metodom getCause(). Otkazivanje samog objekta uzrokuje bacanje neprovjeravane iznimke CancellationException. Provjeravane iznimke moraš uhvatiti ili deklarirati pomoću throws.

get(long timeout, TimeUnit unit) ograničava čekanje, primjerice pri pozivu future.get(2, TimeUnit.SECONDS). Ako rok istekne prije dovršetka, poziv baca provjeravanu iznimku TimeoutException; istek roka ne otkazuje niti dovršava objekt.

I join() može blokirati te pri otkazivanju također baca CancellationException, ali ne deklarira provjeravane iznimke: neuspjeh izračuna prijavljuje neprovjeravanom iznimkom CompletionException. Za obradu rezultata bez blokirajućeg dohvata na mjestu poziva nadoveži sljedeću fazu, primjerice metodom thenApply.

Primjeri

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());
        }
    }
}

Rezultat

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

Vremensko ograničenje od nula milisekundi dovodi do `TimeoutException` jer `pending` još nije dovršen. Nakon `complete(42)` metoda `get()` vraća `42` bez čekanja. Na kraju `get()` i `join()` prikazuju isti uzrok pogreške omotan dvjema različitim iznimkama.

Povezane lekcije

  • Java · Lekcija 51 · Srednje · Verzija: 2

Izvori