SQL directo en Spring Boot con JdbcClient

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.

¿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), y param("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 hay single(), optional() y set().
  • update(llave, "id") ejecuta el insert y guarda el id que generó la base en un KeyHolder.

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.