Menu
CoddyTech

Mengakhiri Request Lebih Awal

Termasuk bagian Minimal API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 14 dari 20.

Middleware yang tidak memanggil next() mengakhiri permintaan di situ dan menjawabnya sendiri: middleware di bawahnya, file statis, dan endpoint tidak pernah dijalankan.

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") bernilai true untuk /admin dan /admin/users, tetapi tidak untuk /administrator. Untuk mengarahkan client ke alamat lain, context.Response.Redirect(url, permanent: true) menjawab dengan 301 Moved Permanently dan alamat tersebut di header Location, lalu browser memintanya. Tanpa permanent: true, middleware menjawab dengan 302 Found, yaitu pengalihan sementara.

challenge icon

Tantangan

Mudah

API ini dulu berada di /recipes, tanpa /api. Tautan lama mengarah ke alamat baru.

  1. Di Program.cs, di bawah middleware X-Api-Version dan di atas app.UseStaticFiles();, tambahkan middleware app.Use lainnya.
  2. Jika context.Request.Path.StartsWithSegments("/recipes"), panggil context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true); dan return tanpa memanggil next().
  3. Jika tidak, await next();.

Coba: tekan Jalankan. Permintaan pertama adalah GET /recipes/2: status 301, dan tab Headers menampilkan Location: /api/recipes/2 serta X-Api-Version: 1. Kirim GET /recipes?category=soup: Location: /api/recipes?category=soup. Kirim GET /api/recipes/2: 200, tidak dialihkan.

Coba sendiri

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();

Semua pelajaran di Minimal API