...
← Curs ASP.NET Core: toate lecțiile
Lecția 11 · Rezultate

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 întorciCodulCorpul
"text" sau un obiectmereu 200textul sau JSON-ul
Results.Ok(produs)200 OKprodusul ca JSON
Results.NotFound()404 Not Foundgol
Results.NotFound("mesaj")404 Not Foundmesajul 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/42
GET /produse/1 → 200 OK
{"id":1,"nume":"Laptop","pret":3500}
GET /produse/42 → 404 Not Found
1
Caută produsul cu FirstOrDefault, ca înainte.
2
Dacă nu există (produs is null), întoarce Results.NotFound(): 404 fără corp.
3
Altfel întoarce Results.Ok(produs): 200 cu produsul ca JSON.
4
Ambele ramuri întorc IResult, deci compilatorul știe ce tip are lambda-ul.
De ce is null

produs 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/7
GET /produse/2 → 200 OK
{"id":2,"nume":"Mouse","pret":99}
GET /produse/7 → 404 Not Found

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

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).
return produs is null ? Results.NotFound(...) : 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);
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 11 · Results.Ok și Results.NotFound
Progres 0% 0 din 22
Lecția curentă 11 / 20 Rezultate