Améliorations de l'API CompletableFuture

La classe CompletableFuture a été introduite dans Java 8 pour représenter le futur qui peut être complété en définissant explicitement sa valeur et son statut. Il peut être utilisé comme java.util.concurrent.CompletionStage. Il prend en charge les fonctions et les actions dépendantes qui se sont déclenchées lors de l'achèvement du futur. Dans Java 9, l'API CompletableFuture a été encore améliorée. Voici les modifications pertinentes apportées à l'API.

• Prise en charge des retards et des délais d'attente.
• Amélioration de la prise en charge des sous-classes
• Nouvelles méthodes d'usine ajoutées.

Prise en charge des retards et des délais d'attente

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

Cette méthode complète ce CompletableFuture avec la valeur donnée si elle n'est pas complétée avant le délai d'attente donné.

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

Cette méthode complète exceptionnellement ce CompletableFuture avec une TimeoutException si elle n'est pas complétée avant le délai d'attente donné.

Amélioration de la prise en charge des sous-classes

public Executor defaultExecutor()

Il renvoie l'exécuteur par défaut utilisé pour les méthodes asynchrones qui ne spécifient pas d'exécuteur. Cette méthode peut être remplacée dans les sous-classes pour renvoyer un exécuteur afin de fournir au moins un thread indépendant.

public <U> CompletableFuture<U> newIncompleteFuture()

Retourne un nouveau CompletableFuture incomplet du type à retourner par une méthode CompletionStage. Les sous-classes de la classe CompletableFuture doivent remplacer cette méthode pour renvoyer une instance de la même classe que ce CompletableFuture. L'implémentation par défaut renvoie une instance de la classe CompletableFuture.

Nouvelles méthodes d'usine

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

Cette méthode de fabrique renvoie un nouveau CompletableFuture qui est déjà complété avec la valeur donnée.

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

Cette méthode de fabrique renvoie un nouveau CompletionStage qui est déjà terminé avec la valeur donnée et ne prend en charge que les méthodes présentes dans l'interface CompletionStage.

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

Cette méthode de fabrique renvoie un nouveau CompletionStage qui est déjà terminé exceptionnellement avec l'exception donnée et ne prend en charge que les méthodes présentes dans l'interface CompletionStage.