Results.Ok și Results.NotFound
În lecția trecută, un produs inexistent a primit 200 OK cu corpul null. Acum preiei controlul asupra codului de status: în loc să întorci direct datele, întorci un rezultat care spune și codul, și corpul. Clasa Results îți dă rezultatele gata făcute: Results.Ok, Results.NotFound și multe altele.
IResult: un răspuns complet, nu doar date
Până acum endpoint-urile au întors un string sau un obiect, iar ASP.NET Core a ales singur codul 200. Când endpoint-ul întoarce un obiect de tip **IResult**, tu decizi tot răspunsul: codul de status, antetele și corpul.
| Ce întorci | Codul | Corpul |
|---|---|---|
| "text" sau un obiect | mereu 200 | textul sau JSON-ul |
| Results.Ok(produs) | 200 OK | produsul ca JSON |
| Results.NotFound() | 404 Not Found | gol |
| Results.NotFound("mesaj") | 404 Not Found | mesajul ca JSON (text între ghilimele) |
Results este o clasă statică din ASP.NET Core (namespace-ul Microsoft.AspNetCore.Http, inclus automat), cu câte o metodă pentru fiecare tip de răspuns.
Primul endpoint cu două rezultate posibile
Iată căutarea după id rescrisă corect. Endpoint-ul are acum un corp cu acolade, pentru că ia o decizie:
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) =>
{
var produs = produse.FirstOrDefault(p => p.Id == id);
if (produs is null)
{
return Results.NotFound();
}
return Results.Ok(produs);
});
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse/1
// GET /produse/42GET /produse/1 → 200 OK
{"id":1,"nume":"Laptop","pret":3500}
GET /produse/42 → 404 Not Foundprodus is null este forma recomandată în C# modern pentru a verifica null. Funcționează la fel ca produs == null, dar nu poate fi păcălită de un operator == redefinit.
Mai scurt, cu operatorul ternar
Pentru o decizie cu două ramuri, operatorul ternar conditie ? a : b face codul mai compact. Este forma pe care o vei vedea cel mai des în proiecte reale:
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) =>
{
var produs = produse.FirstOrDefault(p => p.Id == id);
return produs is null ? Results.NotFound() : Results.Ok(produs);
});
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse/2
// GET /produse/7GET /produse/2 → 200 OK
{"id":2,"nume":"Mouse","pret":99}
GET /produse/7 → 404 Not FoundNotFound cu un mesaj
Un 404 gol e corect, dar un mesaj ajută clientul (și pe tine, când cauți o problemă). Results.NotFound primește opțional corpul răspunsului:
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) =>
{
var produs = produse.FirstOrDefault(p => p.Id == id);
return produs is null
? Results.NotFound($"Produsul {id} nu există")
: Results.Ok(produs);
});
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// GET /produse/42 typeGET /produse/42 → 404 Not Found (application/json; charset=utf-8) "Produsul 42 nu există"
Atenție la un detaliu: corpul este "Produsul 42 nu există", cu ghilimele, iar Content-Type este application/json. Results.NotFound(valoare) serializează orice valoare ca JSON, iar un string în JSON se scrie între ghilimele. La fel se comportă Results.Ok("text").
Poți trimite și un obiect, de exemplu Results.NotFound(new { Mesaj = "Produsul nu există", Id = id }), iar clientul primește {"mesaj":"...","id":42}. Mai târziu în curs vei învăța formatul standard pentru erori, ProblemDetails.
De ce contează 404
- aplicația mobilă verifică codul înainte să citească corpul: la 404 afișează „Produsul nu mai este disponibil”, fără să încerce să citească un produs din null;
- motoarele de căutare scot din index paginile care răspund 404, dar păstrează paginile care răspund 200 (chiar dacă sunt goale);
- monitorizarea serverului numără răspunsurile pe coduri: multe 404 pe aceeași adresă arată un link stricat într-o aplicație client.
Greșeli frecvente
- Amesteci tipuri în ternar: produs is null ? Results.NotFound() : produs nu compilează, pentru că ramurile au tipuri diferite (IResult și Produs). Pune și produsul în Results.Ok(...).
- **Uiți return** într-un lambda cu acolade: fără return, compilatorul spune că nu toate drumurile întorc o valoare.
- Te aștepți la text simplu: Results.NotFound("mesaj") trimite un string JSON, cu ghilimele.
- Întorci 200 cu un mesaj de eroare: Results.Ok("Nu există") spune clientului că totul e bine. Codul trebuie să se potrivească cu situația.
Repară căutarea după id din lecția trecută. Lista are cele trei produse: (1, Laptop, 3500), (2, Mouse, 99), (3, Monitor, 899). GET /produse/{id:int} întoarce Results.Ok(produs) când produsul există și Results.NotFound cu mesajul Produsul {id} nu există când lipsește. Laboratorul trimite /produse/1 și /produse/9.
- Caută produsul cu FirstOrDefault.
- Dacă e null, întoarce Results.NotFound($"Produsul {id} nu există").
- Altfel întoarce Results.Ok(produs).
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/{id:int}", (int id) =>
{
var produs = produse.FirstOrDefault(p => p.Id == id);
return produs is null
? Results.NotFound($"Produsul {id} nu există")
: Results.Ok(produs);
});
app.Run();
record Produs(int Id, string Nume, decimal Pret); 