...
← Curs ASP.NET Core: toate lecțiile
Lecția 15 · Proiect

Mini-proiect: lista de cumpărături

E timpul să pui cap la cap tot ce ai învățat: rute, parametri, record-uri, o listă în memorie, Results.Ok, NotFound, BadRequest și Created. Construiești API-ul unei aplicații de listă de cumpărături, pas cu pas, exact cum ai face într-un proiect real: întâi modelul de date, apoi citirea, apoi adăugarea cu validare.

Ce construiești

Aplicația de pe telefon afișează lista de cumpărături a familiei și permite adăugarea de articole. Ea are nevoie de trei endpoint-uri:

CerereaCe faceRăspunsuri posibile
GET /articoleîntoarce toată lista200
GET /articole/{id}întoarce un articol200 sau 404
POST /articoleadaugă un articol201 + Location sau 400

Înainte de cod, un programator bun scrie un astfel de tabel: el este contractul API-ului, pe care îl discuți cu echipa care face aplicația mobilă.

Pasul 1: modelul de date

Ai nevoie de două record-uri: articolul complet (cu id) și ce trimite clientul la adăugare (fără id). Lista pornește cu două articole:

record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var articole = new List<Articol>
{
    new(1, "Ouă", 10),
    new(2, "Mere", 3)
};

app.MapGet("/articole", () => articole);

app.Run();

record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);

// GET /articole
GET /articole → 200 OK
[{"id":1,"nume":"Ouă","cantitate":10},{"id":2,"nume":"Mere","cantitate":3}]

Pasul 2: citirea unui articol

Endpoint-ul după id folosește constrângerea int, FirstOrDefault și ternarul din lecția despre Results:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var articole = new List<Articol>
{
    new(1, "Ouă", 10),
    new(2, "Mere", 3)
};

app.MapGet("/articole", () => articole);

app.MapGet("/articole/{id:int}", (int id) =>
{
    var articol = articole.FirstOrDefault(a => a.Id == id);
    return articol is null ? Results.NotFound($"Articolul {id} nu există") : Results.Ok(articol);
});

app.Run();

record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);

// GET /articole/2
// GET /articole/7
GET /articole/2 → 200 OK
{"id":2,"nume":"Mere","cantitate":3}
GET /articole/7 → 404 Not Found
"Articolul 7 nu există"

Pasul 3: adăugarea, cu validare

La adăugare apare o regulă de business: nu are sens să cumperi 0 sau -2 ouă. Verifici regula înainte de a modifica lista; dacă nu e respectată, răspunzi 400 și nu salvezi nimic.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var articole = new List<Articol>
{
    new(1, "Ouă", 10),
    new(2, "Mere", 3)
};

app.MapGet("/articole", () => articole);

app.MapPost("/articole", (ArticolNou nou) =>
{
    if (nou.Cantitate <= 0)
    {
        return Results.BadRequest("Cantitatea trebuie să fie pozitivă");
    }
    var id = articole.Max(a => a.Id) + 1;
    var articol = new Articol(id, nou.Nume, nou.Cantitate);
    articole.Add(articol);
    return Results.Created($"/articole/{id}", articol);
});

app.Run();

record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);

// POST /articole {"nume": "Brânză", "cantitate": 1}
// POST /articole {"nume": "Roșii", "cantitate": -2}
// GET /articole
POST /articole → 201 Created
Location: /articole/3
{"id":3,"nume":"Brânză","cantitate":1}
POST /articole → 400 Bad Request
"Cantitatea trebuie să fie pozitivă"
GET /articole → 200 OK
[{"id":1,"nume":"Ouă","cantitate":10},{"id":2,"nume":"Mere","cantitate":3},{"id":3,"nume":"Brânză","cantitate":1}]
1
Primul POST e valid: primește id-ul 3, apare în listă, iar răspunsul este 201 cu Location: /articole/3.
2
Al doilea POST are cantitatea -2: răspunsul este 400, iar lista nu se schimbă.
3
GET /articole confirmă: trei articole, fără roșii.
Validarea vine prima

Regula „verifică, apoi modifică” te ferește de date stricate. Dacă ai adăuga întâi articolul și ai verifica după, un articol invalid ar rămâne în listă chiar dacă răspunsul a fost 400.

Cum l-ai testa în realitate

Într-un proiect real ai porni serverul cu dotnet run și ai trimite cererile dintr-un fișier articole.http (Visual Studio, Rider și VS Code îl pot rula, cu butoane „Send Request” deasupra fiecărei cereri):

### Toată lista
GET http://localhost:5000/articole

### Adaugă un articol
POST http://localhost:5000/articole
Content-Type: application/json

{ "nume": "Lapte", "cantitate": 2 }

În laborator, cererile din exercițiu sunt trimise automat, în ordine, iar tu vezi fiecare răspuns.

Recapitulare înainte de exercițiu

ConceptUnde îl folosești aici
recordArticol și ArticolNou
listă în memoriearticole, creată o dată, înainte de rute
constrângere {id:int}GET /articole/{id:int}
Results.Ok / NotFoundarticol găsit / lipsă
Results.BadRequestcantitate zero sau negativă
Results.Createdarticol adăugat, cu Location
Exercițiul tău

Construiește singur API-ul listei de cumpărături. Lista pornește cu (1, Ouă, 10) și (2, Mere, 3). Ai nevoie de: GET /articole (toată lista), GET /articole/{id:int} (200 cu articolul sau 404 cu mesajul Articolul {id} nu există) și POST /articole (400 cu mesajul Cantitatea trebuie să fie pozitivă dacă Cantitate <= 0, altfel 201 cu Location: /articole/{id}, id = cel mai mare + 1). Laboratorul trimite: GET /articole, POST cu Lapte 2, POST cu Pâine 0, GET /articole/3, GET /articole/99.

  • Adaugă GET /articole care întoarce lista.
  • Adaugă GET /articole/{id:int} cu Results.Ok și Results.NotFound($"Articolul {id} nu există").
  • Adaugă POST /articole: întâi validarea cu Results.BadRequest("Cantitatea trebuie să fie pozitivă"), apoi id nou, Add și Results.Created.
Poți urma exact pașii 1–3 din lecție. Validarea se face înainte de articole.Add(...).

Soluția exercițiului

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var articole = new List<Articol>
{
    new(1, "Ouă", 10),
    new(2, "Mere", 3)
};

app.MapGet("/articole", () => articole);

app.MapGet("/articole/{id:int}", (int id) =>
{
    var articol = articole.FirstOrDefault(a => a.Id == id);
    return articol is null ? Results.NotFound($"Articolul {id} nu există") : Results.Ok(articol);
});

app.MapPost("/articole", (ArticolNou nou) =>
{
    if (nou.Cantitate <= 0)
    {
        return Results.BadRequest("Cantitatea trebuie să fie pozitivă");
    }
    var id = articole.Max(a => a.Id) + 1;
    var articol = new Articol(id, nou.Nume, nou.Cantitate);
    articole.Add(articol);
    return Results.Created($"/articole/{id}", articol);
});

app.Run();

record Articol(int Id, string Nume, int Cantitate);
record ArticolNou(string Nume, int Cantitate);
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 15 · Mini-proiect: lista de cumpărături
Progres 0% 0 din 22
Lecția curentă 15 / 20 Proiect