Menu
CoddyTech

إنهاء الطلب مبكرًا

جزء من قسم واجهات API المصغّرة في رحلة ASP.NET Core على Coddy. الدرس 14 من 20.

تنهي البرمجية الوسيطة التي لا تستدعي next() الطلب عندها وتجيب عنه بنفسها: فلن تعمل البرمجية الوسيطة التي تليها، ولا الملفات الثابتة، ولا نقاط النهاية مطلقًا.

app.Use(async (context, next) =>
{
    if (context.Request.Path.StartsWithSegments("/admin"))
    {
        context.Response.StatusCode = 403;
        await context.Response.WriteAsync("Forbidden");
        return;
    }
    await next();
});

تكون StartsWithSegments("/admin") صحيحة للمسارين /admin و/admin/users، وليست صحيحة للمسار /administrator. لإرسال العميل إلى عنوان آخر، تجيب context.Response.Redirect(url, permanent: true) برمز 301 Moved Permanently مع العنوان في ترويسة Location، ثم يطلبه المتصفح. ومن دون permanent: true، تجيب برمز 302 Found، أي انتقال مؤقت.

challenge icon

التحدي

سهل

كان API موجودًا سابقًا على العنوان /recipes، من دون /api. تؤدي الروابط القديمة إلى العناوين الجديدة.

  1. في Program.cs، أسفل البرمجية الوسيطة X-Api-Version وفوق app.UseStaticFiles();، أضف برمجية وسيطة أخرى باستخدام app.Use.
  2. عندما يكون context.Request.Path.StartsWithSegments("/recipes")، استدعِ context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true); ثم return من دون استدعاء next().
  3. وإلا، نفّذ await next();.

جرّب ذلك: اضغط على «تشغيل». الطلب الأول هو GET /recipes/2: الحالة 301، وتعرض علامة تبويب Headers Location: /api/recipes/2 وX-Api-Version: 1. أرسل GET /recipes?category=soup: Location: /api/recipes?category=soup. أرسل GET /api/recipes/2: الحالة 200، من دون إعادة توجيه.

جرّب بنفسك

using Microsoft.AspNetCore.Http.HttpResults;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (context, next) =>
{
    context.Response.Headers["X-Api-Version"] = "1";
    await next();
});

app.UseStaticFiles();

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;
var favoriteIds = new List<int>();

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.MapPut("/api/recipes/{id:int}", (int id, NewRecipe input) =>
{
    var index = recipes.FindIndex(r => r.Id == id);
    if (index == -1)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    var recipe = new Recipe(id, input.Name, input.Category, input.Minutes);
    recipes[index] = recipe;
    return Results.Ok(recipe);
});

app.MapDelete("/api/recipes/{id:int}", Results<NoContent, NotFound> (int id) =>
{
    var removed = recipes.RemoveAll(r => r.Id == id);
    return removed > 0 ? TypedResults.NoContent() : TypedResults.NotFound();
});

var favorites = app.MapGroup("/api/favorites");
favorites.MapGet("/", () => recipes.Where(r => favoriteIds.Contains(r.Id)));
favorites.MapPost("/{id:int}", (int id) =>
{
    if (!recipes.Any(r => r.Id == id))
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    if (!favoriteIds.Contains(id))
        favoriteIds.Add(id);
    return Results.NoContent();
});
favorites.MapDelete("/{id:int}", (int id) =>
{
    favoriteIds.Remove(id);
    return Results.NoContent();
});

app.Run();

جميع دروس واجهات API المصغّرة