...
← Curs ASP.NET Core: toate lecțiile
Lecția 9 · Modele

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

AvantajDe ce contează într-un API
conciso linie pentru fiecare formă de date, nu 15 linii de clasă cu proprietăți
imuabildatele unui răspuns nu se schimbă „pe drum” din greșeală
egalitate pe valoriuș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-zilei
GET /produs-zilei → 200 OK
{"id":7,"nume":"Căști","pret":199.90}
1
Endpoint-ul creează un Produs și îl întoarce.
2
ASP.NET Core îl serializează în JSON: Id → id, Nume → nume, Pret → pret (camelCase).
3
decimal 199.90m păstrează cele două zecimale: 199.90.
4
Record-ul este declarat după app.Run();, la finalul fișierului.

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();.

În proiectele reale

Î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 /recomandate
GET /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.
Exercițiul tău

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.
Prețurile sunt decimal, deci scrie-le cu sufixul m: 99m, 189.50m.

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);
Excelent! Continuă cu lecția următoare →
Program.csASP.NET Core
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primul tău API cu ASP.NET Core Lecția 9 · Record-uri pentru datele API-ului
Progres 0% 0 din 22
Lecția curentă 9 / 20 Modele