CompletableToekomstige API-verbeteringen

De klasse CompletableFuture is geïntroduceerd in Java 8 om de toekomst te vertegenwoordigen, die kan worden voltooid door de waarde en status expliciet in te stellen. Het kan worden gebruikt als java.util.concurrent.CompletionStage. Het ondersteunt afhankelijke functies en acties die werden geactiveerd bij de voltooiing van de toekomst. In java 9 is de CompletableFuture API verder verbeterd. Hieronder volgen de relevante wijzigingen die in de API zijn aangebracht.

• Ondersteuning voor vertragingen en time-outs.
• Verbeterde ondersteuning voor subclassificatie.
• Nieuwe fabrieksmethoden toegevoegd.

Ondersteuning voor vertragingen en time-outs

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

Deze methode voltooit deze CompletableFuture met de opgegeven waarde, tenzij anders voltooid vóór de opgegeven time-out.

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

Deze methode voltooit deze CompletableFuture uitzonderlijk met een TimeoutException indien niet anders voltooid vóór de gegeven time-out.

Verbeterde ondersteuning voor subclassificatie

public Executor defaultExecutor()

Het retourneert de standaard Executor die wordt gebruikt voor asynchrone methoden die geen Executor specificeren. Deze methode kan in subklassen worden overschreven om een ​​Uitvoerder te retourneren die minimaal één onafhankelijke thread levert.

public <U> CompletableFuture<U> newIncompleteFuture()

Retourneert een nieuwe onvolledige CompletableFuture van het type dat moet worden geretourneerd door een methode CompletionStage. Subklassen van de CompletableFuture-klasse moeten deze methode overschrijven om een ​​instantie van dezelfde klasse als deze CompletableFuture te retourneren. De standaardimplementatie retourneert een instantie van de klasse CompletableFuture.

Nieuwe fabrieksmethoden

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

Deze fabrieksmethode retourneert een nieuwe CompletableFuture die al is voltooid met de opgegeven waarde.

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

Deze fabrieksmethode retourneert een nieuwe CompletionStage die al is voltooid met de opgegeven waarde en ondersteunt alleen de methoden die aanwezig zijn in de interface CompletionStage.

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

Deze fabrieksmethode retourneert een nieuwe CompletionStage die al uitzonderlijk is voltooid met de gegeven uitzondering en ondersteunt alleen de methoden die aanwezig zijn in de interface CompletionStage.