Spring Data JPA e Hibernate: Automatizando la Persistencia

@Transactional
public void ciclo() {
    var tarea = new Tarea("Leer JEP 444");     // NUEVA: Hibernate no la conoce
    em.persist(tarea);                          // GESTIONADA: se insertará en el flush

    Tarea a = em.find(Tarea.class, 7L);         // GESTIONADA: SELECT
    Tarea b = em.find(Tarea.class, 7L);         // misma instancia, sin SELECT
    System.out.println(a == b);                 // true: identidad garantizada

    em.remove(a);                               // ELIMINADA: DELETE en el flush
}                                               // commit -> flush -> el contexto se cierra

public void fuera() {
    Tarea t = repo.findById(7L).orElseThrow();  // la transacción de findById ya terminó
    t.renombrar("Nuevo título");                // SEPARADA: este cambio NO se guarda
}

@Service
class TareaService {
    private final TareaRepository repo;
    TareaService(TareaRepository repo) { this.repo = repo; }

    @Transactional
    public void completar(long id, Clock reloj) {
        Tarea tarea = repo.findById(id)
            .orElseThrow(() -> new TareaNoEncontradaException(id));
        tarea.completar(reloj);      // solo se modifica el objeto
    }                                // commit: flush detecta el cambio y emite el UPDATE

    @Transactional(readOnly = true)  // sin snapshots ni dirty checking
    public List<TareaResponse> pendientes() {
        return repo.findByCompletadaFalse().stream().map(TareaResponse::desde).toList();
    }
}

// Con spring.jpa.show-sql=true verás:
// select t1_0.id, t1_0.titulo, ... from tarea t1_0 where t1_0.id=?
// update tarea set completada=?, completada_en=?, titulo=? where id=?

// Lo que Spring genera conceptualmente para TareaService
class TareaService$$Proxy extends TareaService {
    private final TareaService objetivo;
    private final PlatformTransactionManager tm;

    @Override
    public void completar(long id, Clock reloj) {
        TransactionStatus tx = tm.getTransaction(new DefaultTransactionDefinition());
        try {
            objetivo.completar(id, reloj);       // tu código
            tm.commit(tx);
        } catch (RuntimeException | Error e) {
            tm.rollback(tx);                     // rollback por defecto
            throw e;
        } catch (Exception checked) {
            tm.commit(tx);                       // ¡las comprobadas hacen COMMIT por defecto!
            throw checked;
        }
    }
}

// Auditoría que debe persistir aunque falle la operación principal
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void registrarIntento(String accion) { auditoriaRepo.save(new Auditoria(accion)); }

@Entity
@Table(name = "tarea")
public class Tarea {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 120)
    private String titulo;

    private boolean completada;
    private Instant completadaEn;

    @ManyToOne(fetch = FetchType.LAZY, optional = false)   // LAZY: ManyToOne es EAGER por defecto
    private Proyecto proyecto;

    @Version
    private long version;                                  // bloqueo optimista

    protected Tarea() { }                                  // para JPA, no para ti

    public Tarea(String titulo, Proyecto proyecto) {
        this.titulo = Objects.requireNonNull(titulo);
        this.proyecto = Objects.requireNonNull(proyecto);
    }

    public void completar(Clock reloj) {
        if (completada) throw new IllegalStateException("Ya completada");
        completada = true;
        completadaEn = Instant.now(reloj);
    }

    @Override public boolean equals(Object o) {
        return o instanceof Tarea t && id != null && id.equals(t.id);
    }
    @Override public int hashCode() { return Tarea.class.hashCode(); }   // estable antes y después de persistir
}

# application.yml
spring:
  jpa:
    hibernate:
      ddl-auto: validate          # Hibernate solo comprueba, nunca modifica
    open-in-view: false           # evita consultas perezosas desde la vista/serialización
  flyway:
    enabled: true                 # con flyway-core en el classpath se ejecuta al arrancar

# src/main/resources/db/migration/V1__crear_tarea.sql
#   CREATE TABLE tarea (
#     id            BIGSERIAL PRIMARY KEY,
#     titulo        VARCHAR(120) NOT NULL,
#     completada    BOOLEAN      NOT NULL DEFAULT FALSE,
#     completada_en TIMESTAMPTZ,
#     version       BIGINT       NOT NULL DEFAULT 0
#   );
#
# src/main/resources/db/migration/V2__anadir_prioridad.sql
#   ALTER TABLE tarea ADD COLUMN prioridad SMALLINT NOT NULL DEFAULT 5;