Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

CompletableFuture.supplyAsync con un ejecutor explícito

Pasa tu propio `Executor` para decidir cómo se ejecuta la tarea. Con `Runnable::run`, se ejecuta de inmediato en el hilo que llama, sin usar el grupo de hilos común.

Versión: Java SE 21

Sintaxis

public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)

En Java SE 21, CompletableFuture.supplyAsync(Supplier,Executor) es un método estático de java.util.concurrent.CompletableFuture. Recibe un java.util.function.Supplier<U>, cuyo método get() no toma argumentos y devuelve un valor de tipo U, y un java.util.concurrent.Executor. Envía para su ejecución una tarea que llama a get() y completa un nuevo CompletableFuture<U> con el valor devuelto.

La sobrecarga de un argumento, supplyAsync(supplier), utiliza ForkJoinPool.commonPool(). Si ese grupo de hilos no admite un nivel de paralelismo de al menos 2, Java crea un hilo nuevo por tarea. Según la documentación, la sobrecarga de dos argumentos utiliza el ejecutor proporcionado. OpenJDK 21 hace una excepción: si pasas explícitamente ForkJoinPool.commonPool() y su nivel de paralelismo es inferior a 2, el método utiliza en su lugar un ejecutor que crea un hilo por tarea. Este comportamiento alternativo de la sobrecarga de dos argumentos es un detalle de implementación que Java SE no garantiza. Async no garantiza que se use otro hilo ni que el método retorne de inmediato.

Con Executor sameThread = Runnable::run, execute llama de inmediato a run() de la tarea en el hilo que realiza la llamada. En el ejemplo, el cálculo termina antes de que retorne supplyAsync, así que join() obtiene 42 sin esperar. Una tarea lenta o bloqueante retendría el hilo que llama hasta que terminase.

Si get() lanza una excepción, el futuro se completa de forma excepcional y join() lanza una CompletionException no comprobada. Si es el propio execute el que lanza RejectedExecutionException, la excepción se propaga directamente desde supplyAsync, que en ese caso no devuelve ningún futuro. Ninguno de los dos argumentos puede ser null, pero el valor devuelto por get() sí.

Ejemplos

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());
    }
}

Resultado

before supplyAsync
same thread: true
after supplyAsync
result: 42

La línea `same thread: true` aparece entre `before supplyAsync` y `after supplyAsync`. Esto muestra que el proveedor se ejecuta en el hilo que llama antes de que el método retorne. No hay ningún grupo de hilos que cerrar.

Lecciones relacionadas

  • Java · Lección 51 · Intermedio · Versión: 2

Fuentes