Melhorias na API CompletableFuture

A classe CompletableFuture foi introduzida no Java 8 para representar o Futuro, que pode ser concluído definindo seu valor e status explicitamente. Ele pode ser usado como java.util.concurrent.CompletionStage. Ele suporta funções e ações dependentes que foram acionadas após a conclusão do futuro. Em java 9, a API CompletableFuture foi aprimorada ainda mais. A seguir estão as alterações relevantes feitas na API.

• Suporte para atrasos e tempos limite.
• Suporte aprimorado para subclasses.
• Novos métodos de fábrica adicionados.

Suporte para atrasos e tempos limite

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

Esse método conclui este CompletableFuture com o valor fornecido se não for concluído antes do tempo limite determinado.

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

Esse método conclui excepcionalmente este CompletableFuture com um TimeoutException se não for concluído antes do tempo limite determinado.

Suporte aprimorado para subclasses

public Executor defaultExecutor()

Ele retorna o Executor padrão usado para métodos assíncronos que não especificam um Executor. Este método pode ser substituído em subclasses para retornar um Executor para fornecer um thread independente no mínimo.

public <U> CompletableFuture<U> newIncompleteFuture()

Retorna um novo CompletableFuture incompleto do tipo a ser retornado por um método CompletionStage. As subclasses da classe CompletableFuture devem substituir esse método para retornar uma instância da mesma classe que esta CompletableFuture. A implementação padrão retorna uma instância da classe CompletableFuture.

Novos métodos de fábrica

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

Esse método de fábrica retorna um novo CompletableFuture que já está concluído com o valor fornecido.

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

Este método de fábrica retorna um novo CompletionStage que já está concluído com o valor fornecido e suporta apenas os métodos presentes na interface CompletionStage.

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

Este método de fábrica retorna um novo CompletionStage que já foi concluído excepcionalmente com a exceção dada e suporta apenas os métodos presentes na interface CompletionStage.