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

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

Източници