Menu
CoddyTech

التحديث باستخدام 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 نفسه مرتين فيضيف موردين.

challenge icon

التحدي

سهل

يمكن للعملاء تغيير وصفة.

  1. في Program.cs، اربط PUT /api/recipes/{id:int}. تتلقى دالة lambda الخاصة به int id وNewRecipe input.
  2. اعثر على موضع الوصفة باستخدام recipes.FindIndex(r => r.Id == id). عندما تكون القيمة -1، أعد Results.NotFound(new { error = $"Recipe {id} not found" }).
  3. وإلا، أنشئ 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 المصغّرة