CompletableFuture API-Verbesserungen

Die CompletableFuture-Klasse wurde in Java 8 eingeführt, um die Zukunft darzustellen, die vervollständigt werden kann, indem ihr Wert und Status explizit festgelegt werden. Es kann als java.util.concurrent.CompletionStage verwendet werden. Es unterstützt abhängige Funktionen und Aktionen, die nach Abschluss der Zukunft ausgelöst wurden. In Java 9 wurde die CompletableFuture API weiter verbessert. Im Folgenden sind die relevanten Änderungen an der API aufgeführt.

• Unterstützung für Verzögerungen und Zeitüberschreitungen.
• Verbesserte Unterstützung für Unterklassen.
• Neue Fabrikmethoden hinzugefügt.

Unterstützung für Verzögerungen und Zeitüberschreitungen

public CompletableFuture<T> completeOnTimeout(T value, long timeout, TimeUnit unit)

Diese Methode vervollständigt diese CompletableFuture mit dem angegebenen Wert, wenn sie nicht vor dem angegebenen Timeout abgeschlossen wird.

public CompletableFuture<T> orTimeout(long timeout, TimeUnit unit)

Diese Methode schließt diese CompletableFuture ausnahmsweise mit einer TimeoutException ab, wenn sie nicht anderweitig vor dem angegebenen Timeout abgeschlossen wird.

Verbesserte Unterstützung für Unterklassen

public Executor defaultExecutor()

Sie gibt den standardmäßigen Executor zurück, der für asynchrone Methoden verwendet wird, die keinen Executor angeben. Diese Methode kann in Unterklassen überschrieben werden, um einen Executor zurückzugeben, der mindestens einen unabhängigen Thread bereitstellt.

public <U> CompletableFuture<U> newIncompleteFuture()

Gibt eine neue unvollständige CompletableFuture des Typs zurück, der von einer CompletionStage-Methode zurückgegeben werden soll. Unterklassen der CompletableFuture-Klasse sollten diese Methode überschreiben, um eine Instanz derselben Klasse wie diese CompletableFuture zurückzugeben. Die Standardimplementierung gibt eine Instanz der Klasse CompletableFuture.

Neue Fabrikmethoden

public static <U> CompletableFuture<U> completedFuture(U value)

Diese Factory-Methode gibt eine neue CompletableFuture zurück, die bereits mit dem angegebenen Wert abgeschlossen ist.

public static <U> CompletionStage<U> completedStage(U value)

Diese Factory-Methode gibt eine neue CompletionStage zurück, die bereits mit dem angegebenen Wert abgeschlossen ist, und unterstützt nur die Methoden, die in der Schnittstelle CompletionStage vorhanden sind.

public static <U> CompletionStage<U> failedStage(Throwable ex)

Diese Factory-Methode gibt eine neue CompletionStage zurück, die ausnahmsweise bereits mit der angegebenen Ausnahme abgeschlossen ist, und unterstützt nur die Methoden, die in der Schnittstelle CompletionStage vorhanden sind.