Record-uri pentru datele API-ului
Obiectele anonime sunt bune pentru un exemplu rapid, dar într-un API real același produs apare în zeci de endpoint-uri: în listă, în detalii, în coș, în comandă. Ai nevoie de un tip cu nume, pe care să-l folosești peste tot. În C#, cel mai potrivit tip pentru date trimise și primite de un API este record.
Recapitulare: ce este un record
Din cursul de C# știi că un record este o clasă gândită pentru date. Cu forma scurtă (poziționale), o singură linie definește tipul, constructorul și proprietățile:
public record Produs(int Id, string Nume, decimal Pret);
- creează proprietățile Id, Nume și Pret, doar de citire (imuabile);
- creează constructorul new Produs(7, "Căști", 199.90m);
- două record-uri cu aceleași valori sunt egale (== compară valorile, nu adresele din memorie);
- are un ToString() util și suportă with pentru copii modificate.
De ce record-uri pentru API-uri
| Avantaj | De ce contează într-un API |
|---|---|
| concis | o linie pentru fiecare formă de date, nu 15 linii de clasă cu proprietăți |
| imuabil | datele unui răspuns nu se schimbă „pe drum” din greșeală |
| egalitate pe valori | ușor de comparat în teste: produsul primit este egal cu cel așteptat |
| serializare directă | System.Text.Json transformă proprietățile în JSON, în ordinea în care le-ai scris |
În proiectele reale vei vedea des record-uri numite după rolul lor: ProdusDto, ComandaNoua, RaspunsLogin. DTO (Data Transfer Object) înseamnă „obiect pentru transferul datelor”: exact forma datelor care pleacă sau vin prin API.
Primul endpoint cu un record
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/produs-zilei", () => new Produs(7, "Căști", 199.90m));
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produs-zileiGET /produs-zilei → 200 OK
{"id":7,"nume":"Căști","pret":199.90}Unde pui tipurile în Program.cs
Cu top-level statements există o regulă fixă: instrucțiunile de sus vin primele, iar declarațiile de tipuri (clase, record-uri, interfețe) vin după ele. Dacă pui record-ul înainte de cod, compilatorul refuză:
record Produs(int Id, string Nume, decimal Pret); // greșit: tipul e înaintea instrucțiunilor var builder = WebApplication.CreateBuilder(args); var app = builder.Build(); app.Run();
Eroarea este CS8803: Top-level statements must precede namespace and type declarations, adică „instrucțiunile de nivel superior trebuie să fie înaintea declarațiilor de namespace și de tipuri”. Soluția: mută record-ul la final, după app.Run();.
Într-un proiect adevărat, fiecare tip are fișierul lui: Models/Produs.cs, Models/Comanda.cs. Program.cs rămâne doar cu configurarea și rutele. În laborator ai un singur fișier, așa că toate tipurile stau la finalul lui Program.cs.
Liste de record-uri și record-uri în record-uri
Un endpoint poate întoarce un tablou sau o listă de record-uri; rezultatul este un tablou JSON de obiecte. Un record poate conține la rândul lui alt record:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var categorie = new Categorie(1, "Audio");
app.MapGet("/recomandate", () => new[]
{
new Produs(7, "Căști", 199.90m, categorie),
new Produs(8, "Boxă portabilă", 249m, categorie)
});
app.Run();
record Categorie(int Id, string Nume);
record Produs(int Id, string Nume, decimal Pret, Categorie Categorie);
// GET /recomandateGET /recomandate → 200 OK
[{"id":7,"nume":"Căști","pret":199.90,"categorie":{"id":1,"nume":"Audio"}},{"id":8,"nume":"Boxă portabilă","pret":249,"categorie":{"id":1,"nume":"Audio"}}]Proprietatea Categorie devine un obiect JSON imbricat. Observă și 249m: un decimal fără zecimale scrise apare 249.
Greșeli frecvente
- Record-ul înainte de cod: eroarea CS8803. Tipurile merg după app.Run();.
- **Uiți m la decimal**: 199.90 fără m este double, iar compilatorul nu îl convertește singur în decimal (eroarea CS1503 sau CS0664).
- Încerci să modifici un record: produs.Pret = 150 nu compilează (proprietățile sunt init). Creează o copie: produs with { Pret = 150 }.
- Nume în română cu diacritice: scrie Pret, nu Preț. Numele tipurilor și proprietăților sunt fără diacritice; textele din ele pot avea diacritice.
Definește record-ul Produs(int Id, string Nume, decimal Pret) și folosește-l în două endpoint-uri. GET /produs-zilei întoarce produsul cu id 7, numele Căști și prețul 199.90. GET /recomandate întoarce un tablou cu două produse: (3, Mouse, 99) și (5, Tastatură, 189.50), în această ordine.
- Declară record Produs(int Id, string Nume, decimal Pret); după app.Run();.
- Adaugă GET /produs-zilei care întoarce new Produs(7, "Căști", 199.90m).
- Adaugă GET /recomandate care întoarce un tablou cu cele două produse.
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/produs-zilei", () => new Produs(7, "Căști", 199.90m));
app.MapGet("/recomandate", () => new[]
{
new Produs(3, "Mouse", 99m),
new Produs(5, "Tastatură", 189.50m)
});
app.Run();
record Produs(int Id, string Nume, decimal Pret); 