CKTIS / Java
CompletableFuture.supplyAsync avec un exécuteur explicite
Passez votre propre `Executor` pour choisir comment la tâche s’exécute. Avec `Runnable::run`, elle s’exécute immédiatement dans le thread appelant, sans passer par le pool commun.
Version : Java SE 21
Syntaxe
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)Dans Java SE 21, CompletableFuture.supplyAsync(Supplier,Executor) est une méthode statique de java.util.concurrent.CompletableFuture. Elle prend un java.util.function.Supplier<U>, dont la méthode get() ne prend aucun argument et renvoie une valeur de type U, ainsi qu’un java.util.concurrent.Executor. Elle soumet une tâche qui appelle get() et termine un nouveau CompletableFuture<U> avec la valeur renvoyée.
La surcharge à un seul argument, supplyAsync(supplier), utilise ForkJoinPool.commonPool(). Si ce pool ne prend pas en charge un niveau de parallélisme d’au moins 2, Java crée un nouveau thread par tâche. D’après la documentation, la surcharge à deux arguments utilise l’exécuteur fourni. OpenJDK 21 fait une exception : si vous passez explicitement ForkJoinPool.commonPool() et que son niveau de parallélisme est inférieur à 2, la méthode utilise à la place un exécuteur qui crée un thread par tâche. Pour la surcharge à deux arguments, ce comportement de repli est un détail d’implémentation que Java SE ne garantit pas. Async ne garantit ni l’utilisation d’un autre thread ni un retour immédiat.
Avec Executor sameThread = Runnable::run, execute appelle immédiatement run() sur la tâche dans le thread appelant. Dans l’exemple, le calcul se termine avant le retour de supplyAsync, donc join() obtient 42 sans attendre. Une tâche lente ou bloquante retiendrait le thread appelant jusqu’à sa fin.
Si get() lève une exception, le future se termine exceptionnellement et join() lève une CompletionException non contrôlée. Si c’est execute lui-même qui lève une RejectedExecutionException, celle-ci se propage directement depuis supplyAsync, qui ne renvoie alors aucun future. Aucun des deux arguments ne peut être null, mais la valeur renvoyée par get() le peut.
Exemples
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executor;
public class Main {
public static void main(String[] args) {
Executor sameThread = Runnable::run;
Thread caller = Thread.currentThread();
System.out.println("before supplyAsync");
CompletableFuture<Integer> future = CompletableFuture.supplyAsync(() -> {
System.out.println("same thread: " + (Thread.currentThread() == caller));
return 42;
}, sameThread);
System.out.println("after supplyAsync");
System.out.println("result: " + future.join());
}
}Résultat
before supplyAsync same thread: true after supplyAsync result: 42
La ligne `same thread: true` apparaît entre `before supplyAsync` et `after supplyAsync` : le fournisseur s’exécute donc dans le thread appelant avant le retour de la méthode. Il n’y a aucun pool à arrêter.
Leçons associées
- Java · Leçon 51 · Intermédiaire · Version : 2