Cuando JPA estorba, JdbcClient deja escribir SQL directo con parámetros con nombre y resultados convertidos a records. Aquí, un reporte de ventas por sucursal, una alta y la prueba de que la inyección SQL no pasa.
También te puede interesar
¿Por qué no JPA?
Spring Data JPA (lección 5) es cómodo para guardar y leer entidades, pero a veces estorba: para reportes con group by, para consultas que ya tienes escritas en SQL o cuando quieres saber exactamente qué se ejecuta. JdbcClient, de Spring Framework, es la forma moderna de escribir SQL directo, sin las piezas de JPA, con parámetros con nombre y resultados convertidos a records. Se usa con la dependencia JDBC API de start.spring.io (spring-boot-starter-jdbc), aquí con H2.
La tabla y los datos
Sin Hibernate, nadie crea las tablas por ti. Spring Boot ejecuta al arrancar schema.sql y luego data.sql si los encuentra en src/main/resources y la base está en memoria:
create table venta (
id bigint auto_increment primary key,
sucursal varchar(40) not null,
fecha date not null,
total numeric(10, 2) not null
);insert into venta (sucursal, fecha, total) values
('Centro', '2026-11-20', 1520.50), ('Centro', '2026-11-21', 980.00),
('Norte', '2026-11-20', 2310.75), ('Norte', '2026-11-21', 645.00),
('Sur', '2026-11-21', 1189.90);El repositorio
package com.ejemplo.ventas;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.List;
import org.springframework.jdbc.core.simple.JdbcClient;
import org.springframework.jdbc.support.GeneratedKeyHolder;
import org.springframework.jdbc.support.KeyHolder;
import org.springframework.stereotype.Repository;
@Repository
public class VentaRepository {
public record Venta(long id, String sucursal, LocalDate fecha, BigDecimal total) {
}
public record Resumen(String sucursal, long ventas, BigDecimal total) {
}
private final JdbcClient jdbc;
public VentaRepository(JdbcClient jdbc) {
this.jdbc = jdbc;
}
public List<Venta> deSucursal(String sucursal) {
return jdbc.sql("select id, sucursal, fecha, total from venta where sucursal = :s order by fecha")
.param("s", sucursal)
.query(Venta.class)
.list();
}
public List<Resumen> resumen() {
return jdbc.sql("""
select sucursal, count(*) as ventas, sum(total) as total
from venta group by sucursal order by total desc
""")
.query(Resumen.class)
.list();
}
public long registrar(String sucursal, LocalDate fecha, BigDecimal total) {
KeyHolder llave = new GeneratedKeyHolder();
jdbc.sql("insert into venta (sucursal, fecha, total) values (:s, :f, :t)")
.param("s", sucursal).param("f", fecha).param("t", total)
.update(llave, "id");
return llave.getKey().longValue();
}
}sql(...)recibe la consulta con parámetros con nombre (:s), yparam("s", valor)los llena. Los valores nunca se pegan dentro del texto del SQL, así que no hay inyección SQL posible.query(Venta.class)convierte cada fila en un record, empatando columnas y componentes por nombre;list()las junta. También haysingle(),optional()yset().update(llave, "id")ejecuta elinserty guarda el id que generó la base en unKeyHolder.
Probarlo
terminal$ curl -s localhost:8080/ventas/Norte; echo
[{"id":3,"sucursal":"Norte","fecha":"2026-11-20","total":2310.75},{"id":4,"sucursal":"Norte","fecha":"2026-11-21","total":645.00}]
$ curl -s localhost:8080/ventas/resumen; echo
[{"sucursal":"Norte","ventas":2,"total":2955.75},{"sucursal":"Centro","ventas":2,"total":2500.50},{"sucursal":"Sur","ventas":1,"total":1189.90}]
$ curl -s -X POST "localhost:8080/ventas?sucursal=Sur&fecha=2026-11-22&total=2500"; echo
6
$ curl -s localhost:8080/ventas/resumen; echo
[{"sucursal":"Sur","ventas":2,"total":3689.90},{"sucursal":"Norte","ventas":2,"total":2955.75},{"sucursal":"Centro","ventas":2,"total":2500.50}]Las fechas salen en formato ISO (2026-11-20) y el resumen sumó por sucursal en la base, no en Java. La venta nueva, con id 6, ya aparece en el segundo resumen. Y el intento de inyección SQL clásico:
terminal$ curl -s "localhost:8080/ventas/Norte'%20or%20'1'='1"; echo []
Una lista vacía: el texto completo Norte' or '1'='1 se buscó como nombre de sucursal, tal cual, porque viajó como parámetro y no como parte del SQL.
schema.sql en producción. Con una base de datos real, Spring Boot no ejecuta estos archivos de fábrica (solo con las bases en memoria), y es lo correcto: los cambios de estructura van en migraciones versionadas. Mira el ejemplo de Flyway.
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.