Spring Data JPA: primul tabel, fără SQL scris de mână
Construiești un jurnal de udat plante: fiecare plantă e un rând într-un tabel, iar tu nu scrii nicio comandă SQL. O scrie Hibernate în locul tău, iar cu show-sql o vezi în consolă:
Consola aplicației
Hibernate: create table planta (udare_la_zile integer not null, id bigint generated by default as identity, nume varchar(40) not null, camera varchar(255), primary key (id))
Hibernate: insert into planta (camera,nume,udare_la_zile,id) values (?,?,?,default)
Hibernate: insert into planta (camera,nume,udare_la_zile,id) values (?,?,?,default)
Hibernate: select p1_0.id,p1_0.camera,p1_0.nume,p1_0.udare_la_zile from planta p1_0 where p1_0.id=?
Busuioc
Hibernate: select count(*) from planta p1_0
2
Rândurile care încep cu „Hibernate:” sunt SQL-ul generat. Cu verde, ce afișează programul tău. Baza de date e H2, în memorie: pornește odată cu aplicația și dispare la oprire, perfectă pentru exerciții.
să salvezi și să citești rânduri prin JpaRepository
să ceri date doar din numele unei metode, ca findByCamera
să scrii o interogare JPQL cu @Query și să împarți rezultatele în pagini
Pasul 2 din 5
Urmărește ce ajunge în tabel
Aplicația are trei fișiere: entitatea Planta, interfața PlantaRepository și clasa Jurnal, care rulează la pornire. Primele două le citești la teorie. Aici urmărești Jurnal: ce SQL pleacă și ce rânduri apar în tabel.
Linia 10. Spring creează obiectul Jurnal și îi dă prin constructor un PlantaRepository. Tu ai scris doar interfața; clasa care o implementează e generată de Spring Data la pornire. Tabelul planta e deja creat și e gol.
Linia 15.save primește o plantă fără id. Hibernate trimite un insert, iar coloana id primește default: baza alege numărul, aici 1.
Linia 17. Al doilea save, al doilea insert. Busuioc primește id-ul 2.
Linia 19.findById(2L) trimite un select cu where id=?. Rezultatul nu e o plantă, ci un Optional<Planta>: o cutie care poate fi goală.
Linia 20.orElseThrow scoate planta din cutie. Dacă era goală, programul s-ar fi oprit cu o excepție. Acum p e obiectul Busuioc.
Linia 21. Getter-ul nu trimite niciun SQL: datele sunt deja în obiect. Pe ecran apare „Busuioc”.
Linia 22.count trimite select count(*) și primește 2.
Gata.run se termină, aplicația se oprește, iar H2 șterge tabelul odată cu ea.
Prezice ieșirea
Schimbi linia 19 în repo.findById(1L). Ce afișează linia 21?
Răspuns: Ficus.
Ficus a fost salvat primul, deci baza i-a dat id-ul 1. orElseThrow scoate planta din Optional, iar getNume întoarce doar numele.
Pasul 3 din 5
Entitate, repository, interogări
Patru idei, cu exemple rulate pe patru plante: Ficus (sufragerie, la 7 zile), Busuioc (bucătărie, 2), Cactus (birou, 21) și Mentă (bucătărie, 3). La final, capcanele care opresc aplicația.
@Entity îi spune lui Hibernate că fiecare obiect Planta e un rând din tabelul planta. Câmpul marcat cu @Id e cheia primară. Cu GenerationType.IDENTITY, numărul îl alege baza la insert; de aceea în SQL ai văzut default.
Numele câmpurilor devin nume de coloane: udareLaZile ajunge udare_la_zile. @Column e opțional și adaugă reguli: nullable = false a produs not null, iar length = 40 a produs varchar(40). Constructorul fără parametri e obligatoriu: Hibernate îl folosește când construiește obiecte din rândurile citite.
2
Repository: interfața pe care n-o implementezi
PlantaRepository.java
package ro.exemplu.plante;import java.util.List;import org.springframework.data.jpa.repository.*;publicinterface PlantaRepositoryextends JpaRepository<Planta, Long> { List<Planta> findByCamera(String camera); List<Planta> findByUdareLaZileLessThan(int zile);longcountByCamera(String camera);@Query(""" select p.nume from Planta p where p.udareLaZile <= :zile order by p.nume""") List<String> deUdat(int zile);}
JpaRepository<Planta, Long> primește tipul entității și tipul id-ului. Doar din extends primești gata făcute save, saveAll, findById, findAll, count și deleteById.
Restul metodelor sunt metode derivate: Spring Data citește numele și construiește interogarea. findBy înseamnă „caută după”, urmează numele unui câmp, apoi un cuvânt opțional ca LessThan, Containing sau Between. Le poți lega cu And și Or.
Hibernate: select count(p1_0.id) from planta p1_0 where p1_0.camera=?
2
Hibernate: select p1_0.id,p1_0.camera,p1_0.nume,p1_0.udare_la_zile from planta p1_0 where p1_0.udare_la_zile<?
Busuioc
Mentă
3
@Query: când numele ar fi prea lung
Apelul metodei deUdat
System.out.println(repo.deUdat(7));
Ce apare în consolă
Hibernate: select p1_0.nume from planta p1_0 where p1_0.udare_la_zile<=? order by p1_0.nume
[Busuioc, Ficus, Mentă]
Metoda deUdat din repository are interogarea scrisă de tine, în JPQL. JPQL seamănă cu SQL, dar vorbește despre clase și câmpuri, nu despre tabele: from Planta p, cu P mare, și p.udareLaZile, nu udare_la_zile. Hibernate o traduce în SQL-ul bazei pe care o folosești.
:zile e un parametru cu nume, legat de argumentul metodei care se numește la fel. Poți întoarce și altceva decât entități: aici, doar o listă de nume.
Hibernate: select p1_0.id,p1_0.camera,p1_0.nume,p1_0.udare_la_zile from planta p1_0 order by p1_0.nume offset ? rows fetch first ? rows only
Hibernate: select count(p1_0.id) from planta p1_0
Busuioc
Cactus
2
PageRequest.of(0, 2, …) cere pagina 0, adică prima, cu 2 rânduri. Paginile se numără de la zero. Rezultatul e un Page, care știe și totalul: pentru asta Hibernate trimite încă un select count. Cu 4 plante și câte 2 pe pagină, ies 2 pagini.
Capcană: id-ul care nu există
findById nu întoarce null când nu găsește nimic, ci un Optional gol. Dacă îl golești cu orElseThrow fără să te gândești, programul se oprește:
Căutarea plantei 99
System.out.println(repo.findById(99L));Planta p = repo.findById(99L) .orElseThrow();
Optional.empty
Exception in thread "main" java.util.NoSuchElementException: No value present
at java.base/java.util.Optional.orElseThrow(Optional.java:377)
…
Repară decizând ce faci la lipsă: findById(99L).orElse(null), un mesaj cu isPresent() sau, într-un API, un răspuns 404.
Capcană: o literă greșită în numele metodei
Entitatea nu are câmpul culore. Compilatorul nu observă nimic, pentru că numele e doar un nume. Spring Data îl citește la pornire, iar aplicația nu mai pornește:
PlantaRepository.java, metoda nouă
List<Planta> findByCulore(String culoare);
ERROR … o.s.boot.SpringApplication : Application run failed
…
Caused by: org.springframework.data.mapping.PropertyReferenceException: No property 'culore' found for type 'Planta'
Repară folosind exact numele unui câmp din entitate, cu prima literă mare după findBy: findByCamera, findByNume.
Capcană: tabelul care nu e creat
Pe H2, Spring Boot creează tabelele la pornire și le șterge la oprire (create-drop). Pe MySQL nu face asta implicit. Același efect îl vezi pe H2 dacă oprești generarea:
application.properties
spring.jpa.hibernate.ddl-auto=none
ERROR … o.h.engine.jdbc.spi.SqlExceptionHelper : Table "PLANTA" not found (this database is empty); SQL statement:
insert into planta (camera,nume,udare_la_zile,id) values (?,?,?,default) [42104-232]
Repară alegând valoarea potrivită: update sau create-drop cât înveți, validate plus un instrument de migrări, ca Flyway, într-o aplicație reală.
Pasul 4 din 5
Verifică-te
Cinci întrebări, pe aceleași patru plante. După fiecare răspuns vezi de ce e așa.
1 din 5 · Prezice ieșirea
Adaugi metoda în repository și o apelezi. Ce se afișează?
Metodă derivată cu And
List<Planta>findByCameraAndUdareLaZileLessThan( String camera, int zile);repo.findByCameraAndUdareLaZileLessThan("bucătărie", 3) .forEach(p -> System.out.println( p.getNume()));
Răspuns: Busuioc.
În bucătărie sunt Busuioc (2) și Mentă (3). LessThan e „strict mai mic”: 2 < 3 e adevărat, 3 < 3 nu. SQL-ul generat are where p1_0.camera=? and p1_0.udare_la_zile<?.
2 din 5 · Alege varianta
Ce întoarce repo.findById(5L) dacă în tabel nu există rândul cu id-ul 5?
Răspuns: un Optional gol.
Afișat, apare Optional.empty. Excepția vine abia când ceri valoarea cu orElseThrow() sau get() dintr-o cutie goală.
3 din 5 · Prezice ieșirea
Tabelul e gol la început, iar codul rulează în main, fără @Transactional. Ce se afișează?
Modificare fără save
repo.save(new Planta("Ficus", "sufragerie", 7));Planta p = repo.findById(1L) .orElseThrow();p.setUdareLaZile(5);System.out.println(repo.findById(1L) .orElseThrow().getUdareLaZile());
Răspuns: 7.
Fiecare apel de repository are aici propria tranzacție, care s-a încheiat. setUdareLaZile(5) schimbă doar obiectul din memorie. Al doilea findById citește din nou rândul, unde e tot 7. Cu repo.save(p) înainte de afișare, ar fi apărut 5.
4 din 5 · Alege varianta
Care interogare JPQL e scrisă corect pentru entitatea Planta?
Răspuns: select p from Planta p where p.udareLaZile > 5.
JPQL folosește numele clasei și ale câmpurilor, cu un alias. Numele de tabel și de coloană, ca udare_la_zile, merg doar într-o interogare nativă, marcată cu nativeQuery = true.
5 din 5 · Prezice ieșirea
Cu aceleași patru plante, ce se afișează?
A doua pagină, câte 3
Page<Planta> a = repo.findAll( PageRequest.of(1, 3, Sort.by("nume")));a.forEach(p -> System.out.println( p.getNume()));System.out.println(a.getTotalPages());
Răspuns: Mentă, apoi 2.
Indicele 1 înseamnă a doua pagină. În ordine alfabetică, primele trei plante umplu pagina 0, iar pe pagina 1 rămâne doar Mentă. Patru plante câte trei pe pagină fac 2 pagini.
Pasul 5 din 5
Ce ai învățat
@Entity leagă o clasă de un tabel, @Id marchează cheia primară, iar @Column adaugă reguli pe coloană.
O interfață care extinde JpaRepository primește gata făcute save, findById, findAll și count.
Numele unei metode, ca findByCameraAndUdareLaZileLessThan, devine interogare; un nume de câmp greșit oprește pornirea.
@Query scrie JPQL pe clase și câmpuri, iar PageRequest împarte rezultatul în pagini numărate de la zero.
Proprietățile aplicației
Fișierul cu care au rulat toate exemplele. Prima linie ascunde sigla Spring, a doua păstrează doar avertismentele în log, iar a treia afișează SQL-ul trimis de Hibernate.
Pune în src/main/java clasa cu @SpringBootApplication, apoi Planta, PlantaRepository și Jurnal în același pachet și pornește aplicația. Adaugă a treia plantă și încearcă metodele derivate din teorie.