التحديث باستخدام PUT
جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 9 من 20.
يستبدل طلب PUT المورد الموجود في عنوان ما بمحتوى الطلب الذي يرسله. تستقبل الدالة اللامبدا مَعلمة مسار ومحتوى الطلب معًا:
app.MapPut("/notes/{id:int}", (int id, NewNote input) =>
{
var index = notes.FindIndex(n => n.Id == id);
if (index == -1)
return Results.NotFound();
notes[index] = new Note(id, input.Text);
return Results.Ok(notes[index]);
});تعيد FindIndex موضع أول تطابق، أو -1. لا يمكن تغيير السجل بعد إنشائه، لذا تنشئ نقطة النهاية سجلًا جديدًا بالمعرّف نفسه وتضعه في ذلك الموضع. يؤدي إرسال طلب PUT نفسه مرتين إلى النتيجة نفسها؛ أما إرسال طلب POST نفسه مرتين فيضيف موردين.
التحدي
سهليمكن للعملاء تغيير وصفة.
- في
Program.cs، اربطPUT /api/recipes/{id:int}. تتلقى دالة lambda الخاصة بهint idوNewRecipe input. - اعثر على موضع الوصفة باستخدام
recipes.FindIndex(r => r.Id == id). عندما تكون القيمة-1، أعدResults.NotFound(new { error = $"Recipe {id} not found" }). - وإلا، أنشئ
new Recipe(id, input.Name, input.Category, input.Minutes)، وضعها في ذلك الموضع منrecipes، وأعدResults.Ok(recipe).
جرّب ذلك: اضغط على «تشغيل»، واختر PUT، والمسار /api/recipes/2، ومتن الطلب {"name":"Banana Pancakes","category":"breakfast","minutes":20}، ثم اضغط على «إرسال»: ستكون الحالة 200 مع {"id":2,"name":"Banana Pancakes","category":"breakfast","minutes":20}. أرسل GET /api/recipes: ستظهر ثلاث وصفات، وتكون Banana Pancakes في المنتصف. ويُرجع طلب PUT إلى /api/recipes/99 الحالة 404.
جرّب بنفسك
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var recipes = new List<Recipe>
{
new(1, "Tomato Soup", "soup", 25),
new(2, "Pancakes", "breakfast", 15),
new(3, "Lentil Soup", "soup", 40),
};
var nextId = 4;
app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
var recipe = recipes.FirstOrDefault(r => r.Id == id);
if (recipe is null)
return Results.NotFound(new { error = $"Recipe {id} not found" });
return Results.Ok(recipe);
});
app.MapPost("/api/recipes", (NewRecipe input) =>
{
if (string.IsNullOrWhiteSpace(input.Name))
return Results.BadRequest(new { error = "Name is required" });
if (input.Minutes <= 0)
return Results.BadRequest(new { error = "Minutes must be more than 0" });
var recipe = new Recipe(nextId++, input.Name, input.Category, input.Minutes);
recipes.Add(recipe);
return Results.Created($"/api/recipes/{recipe.Id}", recipe);
});
app.Run();
جميع دروس واجهات API المصغّرة
4البرمجيات الوسيطة والتسجيل
أول Middleware لك2النتائج ومحتوى JSON
حالة Ok وحالة Not Found