CKTIS / Java
Future.get: získání výsledku úlohy nebo zpracování její chyby
Získejte výsledek asynchronní úlohy a rozlište její selhání od přerušení, zrušení, vypršení časového limitu čekání nebo selhání samotného volání `invokeAll`.
Verze: Java SE 21
Syntaxe
java.util.concurrent.Future<V>
V get() throws InterruptedException, ExecutionException
V get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutExceptionFuture.get získává výsledek asynchronního výpočtu reprezentovaného objektem java.util.concurrent.Future<V>. get() bez argumentů v případě potřeby zablokuje volající vlákno bez časového limitu. Při úspěchu vrátí hodnotu typu V, která může být null, pokud to byl výsledek úlohy.
Pokud úloha vyhodí výjimku, get() vyhodí ExecutionException. Původní výjimku získáte pomocí getCause(). Naproti tomu InterruptedException znamená, že volající vlákno bylo při čekání přerušeno, nikoli že úloha selhala. Pokud byla úloha zrušena, get() vyhodí nekontrolovanou výjimku CancellationException.
Přetížená varianta get(long timeout, TimeUnit unit) má stejné možné výsledky, ale omezuje dobu čekání. Vyprší-li při čekání časový limit, vyhodí TimeoutException. Samotné vypršení limitu úlohu nezruší; get() můžete zavolat později znovu.
Pokud se ExecutorService.invokeAll(tasks) vrátí normálně, všechny objekty Future jsou už v konečném stavu a zachovávají pořadí úloh v kolekci. isDone() neznamená úspěch: výjimku úlohy oznámí jako ExecutionException až get() na jejím objektu Future, nikoli samotné invokeAll. Samotné volání invokeAll může být při čekání přerušeno (InterruptedException) nebo nemusí být možné některou úlohu naplánovat (RejectedExecutionException). Varianta invokeAll s časovým limitem před návratem zruší nedokončené úlohy; get() na zrušeném objektu Future vyhodí CancellationException.
Příklady
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
public class FutureGetExample {
public static void main(String[] args) throws InterruptedException {
List<Callable<Integer>> tasks = List.of(
() -> 21 * 2,
() -> { throw new IllegalStateException("invalid input"); }
);
try (ExecutorService executor = Executors.newSingleThreadExecutor()) {
List<Future<Integer>> futures = executor.invokeAll(tasks);
System.out.println("invokeAll returned");
for (Future<Integer> future : futures) {
try {
System.out.println("Result: " + future.get());
} catch (ExecutionException e) {
Throwable cause = e.getCause();
System.out.println("Task failed: " + cause.getClass().getSimpleName()
+ ": " + cause.getMessage());
}
}
}
}
}Výsledek
invokeAll returned Result: 42 Task failed: IllegalStateException: invalid input
První řádek ukazuje, že se `invokeAll` vrátilo normálně. První `get()` vrátí `42`, druhé vyhodí `ExecutionException`. Program vypíše typ a zprávu příčiny, nikoli obalující výjimky. Příkaz try-with-resources uzavře executor.
Související lekce
- Java · Lekce 50 · Středně pokročilá · Verze: 2