CompletableFuture API 개선 사항

CompletableFuture 클래스는 값과 상태를 명시적으로 설정하여 완료할 수 있는 Future를 나타내기 위해 Java 8에 도입되었습니다. java.util.concurrent.CompletionStage로 사용할 수 있습니다. 미래의 완료 시 트리거되는 종속 기능 및 작업을 지원합니다. Java 9에서는 CompletableFuture API가 더욱 향상되었습니다. 다음은 API에 적용된 관련 변경 사항입니다.

• 지연 및 시간 초과 지원
• 하위 분류에 대한 지원이 향상되었습니다.
• 새로운 팩토리 메소드가 추가되었습니다.

지연 및 시간 초과 지원

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

이 메서드는 지정된 시간 초과 전에 완료되지 않은 경우 지정된 값으로 이 CompletableFuture를 완료합니다.

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

이 메서드는 주어진 시간 초과 전에 완료되지 않은 경우 TimeoutException을 사용하여 이 CompletableFuture를 예외적으로 완료합니다.

하위 분류 지원 개선

public Executor defaultExecutor()

Executor를 지정하지 않는 비동기 메서드에 사용되는 기본 Executor를 반환합니다. 이 메소드는 최소한 하나의 독립 스레드를 제공하기 위해 실행자를 반환하기 위해 서브클래스에서 재정의될 수 있습니다.

public <U> CompletableFuture<U> newIncompleteFuture()

CompletionStage 메서드에서 반환할 형식의 불완전한 새 CompletableFuture를 반환합니다. CompletableFuture 클래스의 하위 클래스는 이 메서드를 재정의하여 이 CompletableFuture와 동일한 클래스의 인스턴스를 반환해야 합니다. 기본 구현은 CompletableFuture 클래스의 인스턴스를 반환합니다.

새로운 팩토리 메소드

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

이 팩토리 메소드는 이미 주어진 값으로 완료된 새로운 CompletableFuture를 반환합니다.

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

이 팩토리 메소드는 주어진 값으로 이미 완료된 새로운 CompletionStage를 반환하고 인터페이스 CompletionStage에 있는 메소드만 지원합니다.

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

이 팩토리 메서드는 주어진 예외와 함께 이미 예외적으로 완료된 새로운 CompletionStage를 반환하며 인터페이스 CompletionStage에 있는 메서드만 지원합니다.