מחיקה באמצעות DELETE
חלק מהיחידה REST APIs במסלול ה-ASP.NET Core של Coddy. שיעור 5 מתוך 20.
DELETE מסיר פריט. כשהפעולה הצליחה, התשובה היא 204 No Content: הצלחה עם גוף ריק, כי לא נשאר דבר להציג. כשהפריט אינו קיים, התשובה היא 404.
app.MapDelete("/api/notes/{id:int}", (int id) =>
{
var removed = notes.RemoveAll(n => n.Id == id);
return removed == 0 ? Results.NotFound() : Results.NoContent();
});RemoveAll מחזירה את מספר הפריטים שהסירה. מזהה שנמחק לעולם לא יינתן לפריט חדש: לקוח ששמר את כתובת ה-URL /api/notes/7 צריך לקבל בהמשך 404, ולא הערה של מישהו אחר. מונה נותן לך את זה. המזהה הגדול ביותר ועוד אחד לא: אחרי שההערה החדשה ביותר נמחקת, ההערה הבאה תקבל את המזהה שלה.
אתגר
קלאפשר ללקוחות למחוק משימה.
- ב־
Program.cs, יש למפות אתDELETE /api/tasks/{id:int}. - יש להסיר את המשימה באמצעות
tasks.RemoveAll. אם לא הוסרה שום משימה, יש להחזירResults.NotFound(); אחרת יש להחזירResults.NoContent(), עם סטטוס 204 וגוף ריק. - יש להמשיך להקצות מזהים מתוך
nextId: אחריDELETE /api/tasks/3, המשימה החדשה הבאה תקבל את המזהה 4, ולא 3.
נסו זאת: לחצו על „הפעל”, בחרו DELETE, נתיב /api/tasks/3, ולחצו על „לשלוח”: מתקבלים 204 וגוף ריק. שלחו GET /api/tasks: נותרות שתי משימות. שלחו שוב DELETE /api/tasks/3: מתקבל 404, כי המחיקה הראשונה בוצעה לפניו. שלחו POST עם { "title": "Order new chairs" } אל /api/tasks: המשימה תקבל את המזהה 4.
נסו בעצמכם
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var tasks = new List<TaskItem>
{
new(1, "Write the project brief", false),
new(2, "Book the meeting room", true),
new(3, "Send the invoice", false),
};
var nextId = 4;
app.MapGet("/api/tasks", () => tasks);
app.MapGet("/api/tasks/{id:int}", (int id) =>
{
var task = tasks.Find(t => t.Id == id);
return task is null ? Results.NotFound() : Results.Ok(task);
});
app.MapPost("/api/tasks", (TaskInput input) =>
{
var task = new TaskItem(nextId++, input.Title, input.Done);
tasks.Add(task);
return Results.Created($"/api/tasks/{task.Id}", task);
});
app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
var index = tasks.FindIndex(t => t.Id == id);
if (index == -1) return Results.NotFound();
tasks[index] = new TaskItem(id, input.Title, input.Done);
return Results.Ok(tasks[index]);
});
app.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
var index = tasks.FindIndex(t => t.Id == id);
if (index == -1) return Results.NotFound();
var task = tasks[index];
tasks[index] = task with
{
Title = patch.Title ?? task.Title,
Done = patch.Done ?? task.Done,
};
return Results.Ok(tasks[index]);
});
app.Run();
record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
record TaskPatch(string? Title, bool? Done);
כל השיעורים ביחידה REST APIs
1משאבים ופעלים
משאבים וכתובות URLיצירה באמצעות POST