MapDelete și 204 No Content
Ultima literă din CRUD (Create, Read, Update, Delete) este ștergerea. Un produs scos din ofertă, un articol tăiat de pe lista de cumpărături, o notiță aruncată: toate sunt cereri DELETE. În lecția aceasta scrii endpoint-ul MapDelete, afli de ce răspunsul obișnuit este 204 No Content și ce înseamnă că DELETE este idempotent.
DELETE: cererea cea mai simplă
O cerere DELETE are nevoie doar de adresa resursei: DELETE /produse/1. Nu are corp, pentru că nu e nimic de trimis în afară de „șterge asta”.
| Situația | Răspunsul | Corp |
|---|---|---|
| resursa a fost ștearsă | 204 No Content | nu are |
| resursa nu există | 404 Not Found | gol sau un mesaj |
De ce 204 și nu 200? După ștergere nu mai ai nicio resursă de trimis înapoi. 204 No Content înseamnă exact „am reușit și nu am nimic de adăugat”. Clientul știe că, la 204, nu trebuie să încerce să citească un corp.
Ștergerea din listă: RemoveAll și Remove
Pentru o List<T> ai două metode potrivite, ambele din cursul de C#:
- produse.RemoveAll(p => p.Id == id) șterge toate elementele care respectă condiția și întoarce câte a șters (0 dacă nu a găsit nimic);
- produse.Remove(produs) șterge un element anume și întoarce true sau false; ai nevoie întâi să-l găsești cu FirstOrDefault.
RemoveAll este mai scurt: într-un singur pas cauți și ștergi, iar numărul întors îți spune dacă produsul exista.
Endpoint-ul MapDelete
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", () => produse);
app.MapDelete("/produse/{id:int}", (int id) =>
{
var sterse = produse.RemoveAll(p => p.Id == id);
return sterse == 0 ? Results.NotFound() : Results.NoContent();
});
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// DELETE /produse/2
// GET /produse
// DELETE /produse/42DELETE /produse/2 → 204 No Content
GET /produse → 200 OK
[{"id":1,"nume":"Laptop","pret":3500},{"id":3,"nume":"Monitor","pret":899}]
DELETE /produse/42 → 404 Not FoundVarianta cu Remove, dacă preferi să vezi explicit produsul găsit:
app.MapDelete("/produse/{id:int}", (int id) =>
{
var produs = produse.FirstOrDefault(p => p.Id == id);
if (produs is null)
{
return Results.NotFound();
}
produse.Remove(produs);
return Results.NoContent();
});Idempotență: ce se întâmplă la a doua ștergere
O operație este idempotentă dacă repetarea ei lasă serverul în aceeași stare ca o singură execuție. DELETE este idempotent: după prima ștergere produsul nu mai există; după a doua, tot nu există.
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", () => produse);
app.MapDelete("/produse/{id:int}", (int id) =>
{
var sterse = produse.RemoveAll(p => p.Id == id);
return sterse == 0 ? Results.NotFound() : Results.NoContent();
});
app.Run();
record Produs(int Id, string Nume, decimal Pret);
// DELETE /produse/1
// DELETE /produse/1
// GET /produseDELETE /produse/1 → 204 No Content
DELETE /produse/1 → 404 Not Found
GET /produse → 200 OK
[{"id":2,"nume":"Mouse","pret":99},{"id":3,"nume":"Monitor","pret":899}]Primul DELETE dă 204, al doilea dă 404, deci răspunsurile diferă. Dar starea serverului este aceeași după fiecare: produsul 1 lipsește. Asta contează în realitate: dacă rețeaua telefonului cade și aplicația retrimite cererea, nu se strică nimic.
| Metoda | Idempotentă? | De ce |
|---|---|---|
| GET | da | doar citește |
| PUT | da | pune aceeași valoare de fiecare dată |
| DELETE | da | resursa rămâne ștearsă |
| POST | nu | fiecare cerere creează o resursă nouă, cu alt id |
Greșeli frecvente
- Ștergi cu GET: MapGet("/stergeProdus/{id}", ...) este periculos. Motoarele de căutare și browserele urmează linkurile GET și pot șterge date fără să vrea nimeni. Ștergerea se face doar cu DELETE.
- Întorci 204 și când nu există: clientul trebuie să afle că id-ul era greșit; verifică rezultatul lui RemoveAll sau Remove.
- Trimiți un corp la 204: NoContent nu are corp, prin definiție. Dacă vrei să trimiți ceva înapoi, folosește 200.
- Modifici lista în timp ce o parcurgi cu foreach și Remove: aruncă InvalidOperationException. RemoveAll evită problema.
DELETE în aplicații reale
| Acțiunea | Cererea | Răspunsul |
|---|---|---|
| scoți un produs din coș | DELETE /cos/produse/3 | 204 |
| ștergi o notiță | DELETE /notite/7 | 204 |
| îți închizi contul | DELETE /utilizatori/512 | 204 |
Multe aplicații reale nu șterg fizic datele importante (comenzi, facturi), ci le marchează ca șterse (soft delete), ca să poată fi recuperate sau auditate. Pentru client răspunsul este tot 204.
Adaugă ștergerea de produse. Lista are (1, Laptop, 3500), (2, Mouse, 99), (3, Monitor, 899), iar GET /produse există deja. DELETE /produse/{id:int} șterge produsul și întoarce 204 No Content, sau 404 dacă produsul nu există. Laboratorul trimite DELETE /produse/1 de două ori, apoi GET /produse.
- Adaugă app.MapDelete("/produse/{id:int}", (int id) => ...).
- Șterge produsul cu RemoveAll (sau FirstOrDefault + Remove).
- Întoarce Results.NoContent() dacă s-a șters ceva, altfel Results.NotFound().
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", () => produse);
app.MapDelete("/produse/{id:int}", (int id) =>
{
var sterse = produse.RemoveAll(p => p.Id == id);
return sterse == 0 ? Results.NotFound() : Results.NoContent();
});
app.Run();
record Produs(int Id, string Nume, decimal Pret); 