CKTIS / Java
CompletableFuture.join(): получаване на резултата
`join()` получава резултата от `CompletableFuture`, като при нужда изчаква завършването му. Методът не декларира проверявани изключения, но може да хвърли непроверявано изключение.
Версия: Java SE 21
Синтаксис
public T join()В Java SE 21 CompletableFuture.join() е метод на екземпляр от класа java.util.concurrent.CompletableFuture<T>, който не приема аргументи. Ако обектът още не е завършил, извикването блокира текущата нишка до завършването му. При нормално завършване методът връща резултат от тип T; ако резултатът вече е наличен, не изчаква.
Ако изчислението завърши с грешка, join() хвърля CompletionException, а причината може да се получи с getCause(). Ако самият обект е отменен, join() хвърля директно CancellationException. И двете изключения са непроверявани: компилаторът не изисква да ги прихващаш или декларираш.
За разлика от join(), get() хвърля проверяваното изключение InterruptedException, ако изчакването бъде прекъснато, и сигнализира за грешка в изчислението с проверяваното изключение ExecutionException. join() не прекратява изчакването чрез хвърляне на InterruptedException и не приема ограничение за времето на изчакване; за такава цел използвай get(timeout, unit). За разлика от тях Thread.join() изчаква приключването на нишка, не връща резултат от изчисление (void) и декларира InterruptedException.
Примери
import java.util.concurrent.CancellationException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
public class Main {
public static void main(String[] args) {
CompletableFuture<Integer> success = CompletableFuture.completedFuture(42);
System.out.println(success.join());
CompletableFuture<Integer> failure =
CompletableFuture.failedFuture(new IllegalArgumentException("invalid input"));
try {
failure.join();
} catch (CompletionException e) {
System.out.println("failure: " + e.getCause().getMessage());
}
CompletableFuture<Integer> cancelled = new CompletableFuture<>();
cancelled.cancel(false);
try {
cancelled.join();
} catch (CancellationException e) {
System.out.println("cancelled");
}
}
}
Резултат
42 failure: invalid input cancelled
Всеки обект `CompletableFuture` вече е завършил преди извикването на `join()`. Примерът показва стойността `42`, съобщението на изключението, причинило грешката, и директно хвърлено `CancellationException`; не показва блокиране.
Свързани уроци
- Java · Урок 51 · Средно · Версия: 2