Cómo cotizar con tres paqueterías a la vez en lugar de una tras otra con @Async y CompletableFuture, aprovechando los hilos virtuales de Java 25, y medir la diferencia.
También te puede interesar
El problema: esperar en fila
Para mostrar el envío más barato hay que preguntarle a tres paqueterías, y cada una tarda un segundo. Si se pregunta una tras otra, el cliente espera tres segundos. Pero las tres preguntas son independientes: se pueden hacer al mismo tiempo y esperar solo lo que tarde la más lenta. Para eso sirve @Async: el método se ejecuta en otro hilo y quien lo llama recibe al instante una promesa del resultado, un CompletableFuture.
Activarlo
package com.ejemplo.asincrono;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableAsync;
@SpringBootApplication
@EnableAsync
public class AsincronoApplication {
public static void main(String[] args) {
SpringApplication.run(AsincronoApplication.class, args);
}
}spring.application.name=asincrono spring.threads.virtual.enabled=true
spring.threads.virtual.enabled=true le pide a Spring Boot usar hilos virtuales de Java 21 y posteriores, tanto para las peticiones web como para las tareas con @Async. Un hilo virtual cuesta muy poco, así que esperar un segundo a una paquetería no ocupa un hilo del sistema operativo; puedes tener miles esperando a la vez.
El servicio y el controlador
package com.ejemplo.asincrono;
import java.math.BigDecimal;
import java.util.concurrent.CompletableFuture;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;
@Service
public class Paqueterias {
private static final Logger log = LoggerFactory.getLogger(Paqueterias.class);
public record Cotizacion(String paqueteria, BigDecimal costo) {
}
@Async
public CompletableFuture<Cotizacion> cotizar(String paqueteria, BigDecimal costo) throws InterruptedException {
log.info("Cotizando con {} en el hilo {}", paqueteria, Thread.currentThread());
Thread.sleep(1000); // cada paquetería tarda un segundo en responder
return CompletableFuture.completedFuture(new Cotizacion(paqueteria, costo));
}
}package com.ejemplo.asincrono;
import java.math.BigDecimal;
import java.util.Comparator;
import java.util.List;
import java.util.concurrent.CompletableFuture;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class EnvioController {
private final Paqueterias paqueterias;
public EnvioController(Paqueterias paqueterias) {
this.paqueterias = paqueterias;
}
@GetMapping("/envio/mas-barato")
public Paqueterias.Cotizacion masBarato() throws InterruptedException {
List<CompletableFuture<Paqueterias.Cotizacion>> pendientes = List.of(
paqueterias.cotizar("Paquetería Norte", new BigDecimal("189.00")),
paqueterias.cotizar("Envíos del Bajío", new BigDecimal("149.50")),
paqueterias.cotizar("Rápido Sur", new BigDecimal("212.00")));
CompletableFuture.allOf(pendientes.toArray(CompletableFuture[]::new)).join();
return pendientes.stream().map(CompletableFuture::join)
.min(Comparator.comparing(Paqueterias.Cotizacion::costo)).orElseThrow();
}
}El controlador llama tres veces a cotizar; cada llamada regresa de inmediato con su CompletableFuture. allOf(...).join() espera a que terminen las tres, y después se elige la más barata.
Probarlo
terminal$ curl -s -w " (%{time_total} s)\n" localhost:8080/envio/mas-barato
{"paqueteria":"Envíos del Bajío","costo":149.50} (1.115759 s)registro de la aplicación2026-11-22T10:36:20.040-06:00 INFO 95 --- [asincrono] [ task-1] com.ejemplo.asincrono.Paqueterias : Cotizando con Paquetería Norte en el hilo VirtualThread[#64,task-1]/runnable@ForkJoinPool-1-worker-2 2026-11-22T10:36:20.040-06:00 INFO 95 --- [asincrono] [ task-2] com.ejemplo.asincrono.Paqueterias : Cotizando con Envíos del Bajío en el hilo VirtualThread[#65,task-2]/runnable@ForkJoinPool-1-worker-3 2026-11-22T10:36:20.040-06:00 INFO 95 --- [asincrono] [ task-3] com.ejemplo.asincrono.Paqueterias : Cotizando con Rápido Sur en el hilo VirtualThread[#67,task-3]/runnable@ForkJoinPool-1-worker-4
Tardó poco más de un segundo, no tres, y el registro muestra las tres cotizaciones empezando en el mismo instante, cada una en su propio hilo virtual (VirtualThread). Así se ve el mismo código sin @Async:
terminal$ curl -s -w " (%{time_total} s)\n" localhost:8080/envio/mas-barato
{"paqueteria":"Envíos del Bajío","costo":149.50} (3.124974 s)registro de la aplicación2026-11-22T10:36:19.508-06:00 INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias : Cotizando con Paquetería Norte en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-1 2026-11-22T10:36:20.511-06:00 INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias : Cotizando con Envíos del Bajío en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-1 2026-11-22T10:36:21.511-06:00 INFO 95 --- [asincrono] [omcat-handler-0] com.ejemplo.asincrono.Paqueterias : Cotizando con Rápido Sur en el hilo VirtualThread[#61,tomcat-handler-0]/runnable@ForkJoinPool-1-worker-2
Tres segundos, una tras otra, todas en el hilo de la petición.
Las reglas de @Async. Como @Transactional y @Cacheable, funciona con un proxy: el método debe ser público y llamarse desde otro bean; desde la misma clase se ejecuta en el mismo hilo, sin aviso (lo explicamos en las rarezas). Si el método asíncrono lanza una excepción, llega dentro del CompletableFuture y la recibes al hacer join(). Y si es void, la excepción solo queda en el registro: nadie más se entera.
Cada proyecto de esta página se compiló con Spring Boot 4.2.0, Java 25 (Temurin 25.0.5.1) y Maven 3.10.1 en un contenedor limpio y sin red, se arrancó y se probó con las peticiones de curl que ves; las respuestas y los registros están copiados de esa ejecución.