Răspunsuri JSON cu record-uri
Aplicațiile nu vor texte, vor date structurate: JSON. Vestea bună: în Spring Boot nu scrii JSON de mână. Metoda întoarce un obiect Java, iar Spring îl transformă singur în JSON. Forma ideală pentru astfel de date este record-ul, pe care îl știi din cursul de Java.
De la text la JSON
Până acum metodele au întors String: un text pe care clientul îl afișează ca atare. O aplicație mobilă însă vrea să știe separat titlul, prețul și numărul de lecții, ca să le pună fiecare la locul lui pe ecran. Pentru asta există JSON (JavaScript Object Notation), un format text cu perechi "cheie": valoare:
{
"titlu": "Spring Boot",
"lectii": 120,
"pret": 350.0,
"gratuit": false
}Textul se poate scrie de mână, dar e ușor să greșești o ghilimea sau o virgulă. În Spring Boot întorci un obiect, iar biblioteca Jackson (inclusă în Spring Web) îl transformă în JSON automat.
Metoda întoarce un record
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Curs(String titlu, int lectii, double pret, boolean gratuit) { }
@RestController
class CursController {
@GetMapping("/curs")
Curs curs() {
return new Curs("Spring Boot", 120, 350.0, false);
}
}
// > GET /cursTomcat started on port 8080 (http)
Started Application
GET /curs → 200
{"titlu":"Spring Boot","lectii":120,"pret":350.0,"gratuit":false}Cheile apar în ordinea componentelor din record: titlu, lectii, pret, gratuit. Laboratorul afișează JSON-ul compact, pe o singură linie, exact cum îl trimite serverul; Postman și browserele îl afișează frumos, pe mai multe linii.
Tipurile Java în JSON
| Tip Java | În JSON | Exemplu |
|---|---|---|
| String | text, între ghilimele | "Ana Pop" |
| int, long | număr întreg | 28 |
| double | număr cu zecimale (mereu cu punct) | 350.0 |
| boolean | true / false | false |
| null (referință goală) | null | "telefon":null |
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Utilizator(long id, String nume, String telefon, int varsta) { }
@RestController
class UtilizatorController {
@GetMapping("/utilizatori/{id}")
Utilizator utilizator(@PathVariable long id) {
if (id == 1) {
return new Utilizator(1, "Ana Pop", "0722000111", 28);
}
return new Utilizator(id, "Vizitator", null, 0);
}
}
// > GET /utilizatori/1
// > GET /utilizatori/5Tomcat started on port 8080 (http)
Started Application
GET /utilizatori/1 → 200
{"id":1,"nume":"Ana Pop","telefon":"0722000111","varsta":28}
GET /utilizatori/5 → 200
{"id":5,"nume":"Vizitator","telefon":null,"varsta":0}Pentru vizitator, telefon este null și apare în JSON ca null. Componentele de tip int nu pot fi null, așa că varsta are valoarea 0. Mai târziu în curs înveți cum ascunzi câmpurile null din răspuns.
Calcule și reutilizare
Obiectul din răspuns se poate construi din parametrii cererii și din calcule. Și pentru că un record are metode de acces, o rută poate folosi datele alteia:
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Livrare(String awb, String oras, double greutate, boolean livrat) { }
@RestController
class LivrareController {
@GetMapping("/livrari/{awb}")
Livrare livrare(@PathVariable String awb) {
double greutate = awb.length() * 0.5;
return new Livrare(awb, "Brașov", greutate, awb.startsWith("L"));
}
@GetMapping("/livrari/{awb}/oras")
String oras(@PathVariable String awb) {
return livrare(awb).oras();
}
}
// > GET /livrari/L1234
// > GET /livrari/X9/orasTomcat started on port 8080 (http)
Started Application
GET /livrari/L1234 → 200
{"awb":"L1234","oras":"Brașov","greutate":2.5,"livrat":true}
GET /livrari/X9/oras → 200
BrașovRuta /livrari/{awb}/oras apelează metoda primei rute și întoarce doar orașul, ca text. Același obiect, două forme de răspuns.
Exemple reale
- Magazin: GET /produse/15 întoarce {"id":15,"nume":"Mouse","pret":99.0,"inStoc":true}; aplicația afișează prețul și butonul „Adaugă în coș” doar dacă inStoc este true.
- Bancă: GET /conturi/sold întoarce {"iban":"RO49...","sold":1250.5,"moneda":"RON"}.
- Vremea: GET /vreme/Cluj întoarce temperatura, umiditatea și o descriere.
Record-urile sunt potrivite pentru datele trimise clientului: sunt scurte, imutabile (nu se pot modifica după creare) și au numele câmpurilor exact cum vor apărea în JSON. Vei folosi record-uri pentru majoritatea răspunsurilor din curs.
Greșeli frecvente
- Construiești JSON-ul ca text ("{\"id\":" + id + "}"): greu de citit, ușor de stricat cu o ghilimea uitată. Întoarce un obiect.
- Nume de componente nepotrivite: numele din record devin cheile JSON; pretProdus apare ca pretProdus, nu ca pret. Alege numele gândindu-te la client.
- **Te aștepți la 350 pentru un double**: Jackson scrie 350.0. Dacă vrei număr întreg, folosește int.
- **Uiți că null apare în răspuns**: clientul trebuie să se descurce cu el sau îl ascunzi (lecția 20).
Pe scurt
- Metoda unui controller poate întoarce un obiect; Spring îl transformă în JSON cu Jackson.
- Record-ul este forma ideală pentru datele de răspuns; cheile JSON sunt numele componentelor, în aceeași ordine.
- String → text, int/long → număr, double → număr cu punct (99.0), boolean → true/false, null → null.
- Răspunsul primește automat Content-Type: application/json.
Fă din produse răspunsuri JSON. Declară record Produs(long id, String nume, double pret, boolean inStoc) și ruta GET /produse/{id}, care întoarce un produs construit din id: numele Produs + id, prețul 100.0 * id, iar inStoc este true pentru id-urile impare. Laboratorul trimite /produse/1 și /produse/2.
- Declară record-ul Produs cu componentele, în ordinea: id, nume, pret, inStoc.
- Adaugă ruta @GetMapping("/produse/{id}") cu @PathVariable long id, care întoarce Produs.
- Calculează valorile din id: "Produs " + id, 100.0 * id, id % 2 == 1.
Soluția exercițiului
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Produs(long id, String nume, double pret, boolean inStoc) { }
@RestController
class ProdusController {
@GetMapping("/produse/{id}")
Produs produs(@PathVariable long id) {
return new Produs(id, "Produs " + id, 100.0 * id, id % 2 == 1);
}
} 