O listă în memorie ca „bază de date”
Un API are nevoie de date: produse, clienți, comenzi. Datele reale stau într-o bază de date, pe care o vei conecta în modulul despre Entity Framework Core. Până atunci, folosești ceva mult mai simplu: o List<Produs> creată la pornire. Cu ea înveți toate operațiile unui API fără să instalezi nimic.
Lista creată înainte de rute
O listă declarată în Program.cs, înainte de MapGet, este creată o singură dată, la pornirea aplicației. Toate endpoint-urile o văd și lucrează cu aceeași listă, la fiecare cerere:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs>
{
new(1, "Laptop", 3500m),
new(2, "Mouse", 99m),
new(3, "Monitor", 899m)
};
app.MapGet("/produse", () => produse);
app.MapGet("/produse/numar", () => $"Avem {produse.Count} produse");
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse
// GET /produse/numarGET /produse → 200 OK
[{"id":1,"nume":"Laptop","pret":3500},{"id":2,"nume":"Mouse","pret":99},{"id":3,"nume":"Monitor","pret":899}]
GET /produse/numar → 200 OK
Avem 3 produse- new(1, "Laptop", 3500m) este forma scurtă a lui new Produs(1, "Laptop", 3500m): tipul se deduce din listă;
- () => produse întoarce lista întreagă; ASP.NET Core o serializează ca tablou JSON;
- lambda-urile „văd” variabila produse pentru că este declarată mai sus în același fișier.
Lista trăiește în memoria procesului. Când oprești serverul și îl pornești din nou, lista revine la cele trei produse inițiale; orice modificare făcută între timp se pierde. Pentru învățare e perfect; pentru o aplicație reală ai nevoie de o bază de date.
Căutarea după id cu FirstOrDefault
Pentru GET /produse/{id} cauți în listă produsul cu id-ul cerut. Metoda LINQ FirstOrDefault (din cursul de C#) întoarce primul element care respectă condiția sau null dacă nu există niciunul:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs>
{
new(1, "Laptop", 3500m),
new(2, "Mouse", 99m),
new(3, "Monitor", 899m)
};
app.MapGet("/produse/{id:int}", (int id) => produse.FirstOrDefault(p => p.Id == id));
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse/3
// GET /produse/42GET /produse/3 → 200 OK
{"id":3,"nume":"Monitor","pret":899}
GET /produse/42 → 200 OK
nullDe ce 200 cu null nu e un răspuns bun
Pentru un client, 200 OK înseamnă „am găsit ce ai cerut”. O aplicație mobilă care primește 200 va încerca să afișeze produsul și va da peste null: în cel mai bun caz afișează o pagină goală, în cel mai rău caz se blochează.
Răspunsul corect pentru o resursă care nu există este 404 Not Found: clientul îl verifică și afișează „Produsul nu mai este disponibil”. În lecția următoare înveți să alegi tu codul de status, cu Results.Ok și Results.NotFound.
Codul de status trebuie să spună adevărul despre rezultat. Corpul null cu 200 este o capcană clasică a începătorilor.
Filtre și calcule pe listă
Orice știi din LINQ poți folosi în endpoint-uri. Rezultatul unui Where sau Select este serializat ca tablou JSON:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs>
{
new(1, "Laptop", 3500m),
new(2, "Mouse", 99m),
new(3, "Monitor", 899m)
};
app.MapGet("/produse/ieftine", () => produse.Where(p => p.Pret < 1000m));
app.MapGet("/produse/nume", () => produse.Select(p => p.Nume));
app.MapGet("/produse/total", () => produse.Sum(p => p.Pret));
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse/ieftine
// GET /produse/nume
// GET /produse/totalGET /produse/ieftine → 200 OK
[{"id":2,"nume":"Mouse","pret":99},{"id":3,"nume":"Monitor","pret":899}]
GET /produse/nume → 200 OK
["Laptop","Mouse","Monitor"]
GET /produse/total → 200 OK
4498Where păstrează produsele sub 1000 de lei, Select scoate doar numele (un tablou de stringuri), iar Sum întoarce un număr. Fiecare devine JSON-ul potrivit.
Greșeli frecvente
- Creezi lista în interiorul lambda-ului: () => { var produse = new List<Produs> {...}; ... } construiește o listă nouă la fiecare cerere, iar modificările nu rămân. Declar-o o dată, înainte de rute.
- **Folosești First în loc de FirstOrDefault**: First aruncă InvalidOperationException când nu găsește nimic, iar clientul primește 500.
- **Confunzi = cu ==** în condiție: p => p.Id = id nu compilează; comparația este p.Id == id.
- Te bazezi pe date după repornire: lista se reface de la zero la fiecare pornire.
Ce urmează
| Acum | Mai târziu în curs |
|---|---|
| List<Produs> în Program.cs | un serviciu (repository) înregistrat în DI, modulul 3 |
| date pierdute la repornire | bază de date cu Entity Framework Core, modulul 5 |
| FirstOrDefault pe listă | același LINQ, dar pe tabele din baza de date |
Vestea bună este că LINQ-ul pe care îl scrii acum rămâne aproape la fel când treci la Entity Framework Core: db.Produse.FirstOrDefault(p => p.Id == id).
Construiește API-ul de citire al magazinului. Creează o listă cu trei produse: (1, Laptop, 3500), (2, Mouse, 99), (3, Monitor, 899). GET /produse întoarce toată lista, iar GET /produse/{id:int} întoarce produsul cu id-ul dat, căutat cu FirstOrDefault. Laboratorul trimite /produse, /produse/2 și /produse/9 (pentru 9 răspunsul va fi null, deocamdată).
- Declară record Produs(int Id, string Nume, decimal Pret); la final.
- Creează lista produse cu cele trei produse, înainte de rute.
- Adaugă GET /produse care întoarce lista.
- Adaugă GET /produse/{id:int} care întoarce produse.FirstOrDefault(p => p.Id == id).
Soluția exercițiului
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var produse = new List<Produs>
{
new(1, "Laptop", 3500m),
new(2, "Mouse", 99m),
new(3, "Monitor", 899m)
};
app.MapGet("/produse", () => produse);
app.MapGet("/produse/{id:int}", (int id) => produse.FirstOrDefault(p => p.Id == id));
app.Run();
record Produs(int Id, string Nume, decimal Pret); 