...
← Curs ASP.NET Core: toate lecțiile
Lecția 16 · PUT

MapPut: actualizezi o resursă

Prețurile se schimbă, numele produselor se corectează, clienții își mută adresa. Pentru a modifica o resursă care există deja, REST folosește metoda PUT: clientul trimite la adresa resursei noua ei formă completă, iar serverul o înlocuiește. În lecția aceasta scrii endpoint-ul MapPut și înveți cum actualizezi un record, care este imuabil.

PUT: înlocuiește resursa de la o adresă

Cererea PUT combină ce știi deja: id-ul în cale (ca la GET după id) și datele în corp (ca la POST).

PUT /produse/2 HTTP/1.1
Content-Type: application/json

{"nume": "Mouse wireless", "pret": 149}
POST /produsePUT /produse/2
scopcreează o resursă nouăînlocuiește resursa 2
cine alege id-ulserverulclientul, în cale
răspuns la succes201 Created200 OK cu resursa nouă (sau 204 No Content)
resursa nu existănu se aplică404 Not Found
PUT trimite resursa întreagă

La PUT, corpul conține toate câmpurile resursei, nu doar cel modificat. Dacă vrei să schimbi doar prețul, tot trimiți și numele. Pentru modificări parțiale există metoda PATCH, mai rar folosită în API-urile simple.

Record-urile nu se modifică: le înlocuiești

Proprietățile unui record pozițional sunt doar de citire, deci produs.Pret = 149 nu compilează. Ai două unelte ca să obții un produs actualizat:

  • creezi un record nou: new Produs(id, nou.Nume, nou.Pret);
  • sau o copie modificată cu with: produs with { Pret = 149 } (din cursul de C#) păstrează restul valorilor.

Apoi pui noul record în listă, în locul celui vechi. FindIndex întoarce poziția primului element care respectă condiția sau -1 dacă nu există niciunul; cu poziția, înlocuiești elementul prin produse[index] = ....

var index = produse.FindIndex(p => p.Id == id);   // 1 pentru id-ul 2, -1 dacă nu există
produse[index] = new Produs(id, nou.Nume, nou.Pret);

Endpoint-ul MapPut complet

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.MapPut("/produse/{id:int}", (int id, ProdusNou nou) =>
{
    var index = produse.FindIndex(p => p.Id == id);
    if (index == -1)
    {
        return Results.NotFound();
    }
    var actualizat = new Produs(id, nou.Nume, nou.Pret);
    produse[index] = actualizat;
    return Results.Ok(actualizat);
});

app.Run();

record Produs(int Id, string Nume, decimal Pret);
record ProdusNou(string Nume, decimal Pret);

// PUT /produse/2 {"nume": "Mouse wireless", "pret": 149}
// GET /produse/2
// PUT /produse/42 {"nume": "Tabletă", "pret": 1200}
PUT /produse/2 → 200 OK
{"id":2,"nume":"Mouse wireless","pret":149}
GET /produse/2 → 200 OK
{"id":2,"nume":"Mouse wireless","pret":149}
PUT /produse/42 → 404 Not Found
1
Parametrul int id vine din cale, iar ProdusNou nou din corp: ASP.NET Core le leagă pe amândouă.
2
FindIndex caută poziția produsului; pentru id-ul 42 întoarce -1, deci răspunsul este 404.
3
Pentru id-ul 2, construiește produsul actualizat (păstrând id-ul din cale) și îl pune în listă pe aceeași poziție.
4
Răspunsul este 200 cu produsul nou; GET /produse/2 confirmă schimbarea.

Observă că refolosim ProdusNou de la POST: clientul trimite numele și prețul, iar id-ul vine din adresă. Așa nu poate exista conflict între un id din cale și altul din corp.

Varianta cu with și 204

Dacă produsul ar avea multe câmpuri, with te scutește să le copiezi pe toate. Unele API-uri nu trimit nimic înapoi la PUT și răspund 204 No Content (succes, fără corp):

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.MapPut("/produse/{id:int}/pret", (int id, decimal pretNou) =>
{
    var index = produse.FindIndex(p => p.Id == id);
    if (index == -1)
    {
        return Results.NotFound();
    }
    produse[index] = produse[index] with { Pret = pretNou };
    return Results.NoContent();
});

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

app.Run();

record Produs(int Id, string Nume, decimal Pret);
record ProdusNou(string Nume, decimal Pret);

// PUT /produse/3/pret?pretNou=799
// GET /produse
PUT /produse/3/pret?pretNou=799 → 204 No Content
GET /produse → 200 OK
[{"id":1,"nume":"Laptop","pret":3500},{"id":2,"nume":"Mouse","pret":99},{"id":3,"nume":"Monitor","pret":799}]

Aici prețul vine din query (?pretNou=799), iar with creează o copie a monitorului cu prețul nou. Răspunsul 204 nu are corp. Ambele variante (200 cu resursa sau 204) sunt corecte; alege una pentru tot API-ul.

Greșeli frecvente

  • Încerci să modifici record-ul: produs.Pret = 149 dă eroarea CS8852 (proprietatea init poate fi setată doar la inițializare). Folosește new sau with.
  • Uiți să pui record-ul nou în listă: var actualizat = produs with { ... }; fără produse[index] = actualizat nu schimbă nimic în listă.
  • Nu verifici -1: produse[-1] aruncă ArgumentOutOfRangeException, iar clientul primește 500 în loc de 404.
  • Iei id-ul din corp: id-ul resursei este cel din cale; corpul descrie doar noile valori.

PUT în aplicații reale

AcțiuneaCererea
îți schimbi adresa de livrarePUT /utilizatori/512/adresa
adminul corectează un produsPUT /produse/15
modifici o notițăPUT /notite/7
schimbi cantitatea din coșPUT /cos/produse/3
Exercițiul tău

Adaugă actualizarea de produse. Lista are (1, Laptop, 3500), (2, Mouse, 99), (3, Monitor, 899), iar GET /produse/{id:int} există deja. PUT /produse/{id:int} primește un ProdusNou în corp, înlocuiește produsul cu acel id (păstrând id-ul) și întoarce 200 cu produsul actualizat sau 404 dacă nu există. Laboratorul trimite PUT /produse/2 cu Mouse wireless 149, PUT /produse/9 și GET /produse/2.

  • Adaugă app.MapPut("/produse/{id:int}", (int id, ProdusNou nou) => ...).
  • Găsește poziția cu FindIndex; dacă este -1, întoarce Results.NotFound().
  • Pune în listă new Produs(id, nou.Nume, nou.Pret) (sau o copie cu with) și întoarce Results.Ok(...) cu el.
produse[index] = actualizat; înlocuiește elementul de pe poziția găsită.

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() : Results.Ok(produs);
});

app.MapPut("/produse/{id:int}", (int id, ProdusNou nou) =>
{
    var index = produse.FindIndex(p => p.Id == id);
    if (index == -1)
    {
        return Results.NotFound();
    }
    var actualizat = new Produs(id, nou.Nume, nou.Pret);
    produse[index] = actualizat;
    return Results.Ok(actualizat);
});

app.Run();

record Produs(int Id, string Nume, decimal Pret);
record ProdusNou(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 16 · MapPut: actualizezi o resursă
Progres 0% 0 din 22
Lecția curentă 16 / 20 Put