Un convertidor de divisas que consulta el tipo de cambio en otro servicio con RestClient, el cliente HTTP de Spring que reemplaza a RestTemplate, con los errores del otro lado bien atendidos.
También te puede interesar
RestClient, el cliente HTTP de Spring
Tu aplicación muchas veces necesita pedirle datos a otra: un tipo de cambio, el estado de un envío, la validación de un pago. RestClient es el cliente HTTP de Spring Framework para eso, con una forma de escribir encadenada y clara. Reemplaza al viejo RestTemplate, cuyo soporte en Spring Boot 4.2 quedó obsoleto. Se agrega con la dependencia HTTP Client de start.spring.io (spring-boot-starter-restclient), junto con Spring Web para la API propia.
spring.application.name=divisas divisas.url=http://localhost:8080/simulado spring.mvc.problemdetails.enabled=true
La dirección del servicio va en la configuración, para cambiarla por ambiente. Como aquí probamos sin internet, la misma aplicación hace el papel del servicio externo en /simulado; en la vida real sería la URL de otra empresa:
package com.ejemplo.divisas;
import java.math.BigDecimal;
import java.util.Map;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.server.ResponseStatusException;
/** Hace el papel del servicio externo, para probar sin internet. En la vida real estaría en otro servidor. */
@RestController
public class ServicioSimulado {
private static final Map<String, BigDecimal> TIPOS = Map.of(
"USD", new BigDecimal("18.42"), "EUR", new BigDecimal("21.37"));
@GetMapping("/simulado/tipos/{moneda}")
public Map<String, Object> tipo(@PathVariable String moneda) {
BigDecimal valor = TIPOS.get(moneda);
if (valor == null) throw new ResponseStatusException(HttpStatus.NOT_FOUND);
return Map.of("moneda", moneda, "pesos", valor);
}
}El cliente
Spring Boot ofrece un RestClient.Builder ya configurado (con Jackson, con las métricas de Actuator si las tienes) que conviene inyectar en vez de crear uno con RestClient.create(). Con él se arma un cliente con la URL base:
package com.ejemplo.divisas;
import java.math.BigDecimal;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestClient;
import org.springframework.web.server.ResponseStatusException;
@Component
public class ClienteDivisas {
public record Tipo(String moneda, BigDecimal pesos) {
}
private final RestClient http;
public ClienteDivisas(RestClient.Builder builder, @Value("${divisas.url}") String url) {
this.http = builder.baseUrl(url).build();
}
public Tipo tipo(String moneda) {
return http.get()
.uri("/tipos/{moneda}", moneda)
.retrieve()
.onStatus(s -> s.value() == 404, (pet, resp) -> {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "No conocemos la moneda " + moneda);
})
.body(Tipo.class);
}
}La petición se lee en orden: get() el método, uri(...) la ruta con su variable (que se escapa sola, igual que en los controladores), retrieve() la envía, onStatus decide qué hacer con ciertos códigos y body(Tipo.class) convierte el JSON en un record. Sin onStatus, cualquier 4xx o 5xx lanza una RestClientResponseException.
package com.ejemplo.divisas;
import java.math.BigDecimal;
import java.math.RoundingMode;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ConversionController {
public record Conversion(String moneda, BigDecimal cantidad, BigDecimal tipo, BigDecimal pesos) {
}
private final ClienteDivisas divisas;
public ConversionController(ClienteDivisas divisas) {
this.divisas = divisas;
}
@GetMapping("/convertir")
public Conversion convertir(@RequestParam String moneda, @RequestParam BigDecimal cantidad) {
ClienteDivisas.Tipo t = divisas.tipo(moneda);
return new Conversion(moneda, cantidad, t.pesos(), cantidad.multiply(t.pesos()).setScale(2, RoundingMode.HALF_UP));
}
}Probarlo
terminal$ curl -s "localhost:8080/convertir?moneda=USD&cantidad=250"
{"moneda":"USD","cantidad":250,"tipo":18.42,"pesos":4605.00}
$ curl -s "localhost:8080/convertir?moneda=EUR&cantidad=99.90"
{"moneda":"EUR","cantidad":99.90,"tipo":21.37,"pesos":2134.86}
$ curl -s "localhost:8080/convertir?moneda=XYZ&cantidad=10"
{"detail":"No conocemos la moneda XYZ","status":404,"title":"Not Found"}Las dos primeras consultaron el servicio y calcularon los pesos. La tercera recibió un 404 del servicio, que onStatus convirtió en nuestro propio 404 con un mensaje claro, en vez de un 500.
Cuando el otro servicio no responde
Los servicios externos fallan, y tu aplicación debe sobrevivir. Apuntamos la URL a un puerto donde no hay nada:
terminal$ curl -s "localhost:8080/convertir?moneda=USD&cantidad=250"
{"timestamp":"2026-11-22T16:31:26.250Z","status":500,"error":"Internal Server Error","path":"/convertir"}registro de la aplicación2026-11-22T10:31:26.240-06:00 ERROR 96 --- [divisas] [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://localhost:9999/tipos/USD": null] with root cause
El cliente no pudo conectarse, se lanzó ResourceAccessException y el usuario recibió un 500 genérico. Lo correcto es atraparla (en el cliente o en un @RestControllerAdvice, como en la lección 6) y responder un 503 Service Unavailable o un dato guardado. Y define tiempos de espera: si el otro servicio se queda colgado, cada petición tuya también se quedará esperando, hasta agotar los hilos del servidor.
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.