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 /produse | PUT /produse/2 | |
|---|---|---|
| scop | creează o resursă nouă | înlocuiește resursa 2 |
| cine alege id-ul | serverul | clientul, în cale |
| răspuns la succes | 201 Created | 200 OK cu resursa nouă (sau 204 No Content) |
| resursa nu există | nu se aplică | 404 Not Found |
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 FoundObservă 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 /produsePUT /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țiunea | Cererea |
|---|---|
| îți schimbi adresa de livrare | PUT /utilizatori/512/adresa |
| adminul corectează un produs | PUT /produse/15 |
| modifici o notiță | PUT /notite/7 |
| schimbi cantitatea din coș | PUT /cos/produse/3 |
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.
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); 