Middleware Pertamamu
Termasuk bagian Minimal API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 13 dari 20.
Middleware adalah kode yang dilalui setiap permintaan, sesuai urutan aplikasi menambahkannya, sebelum endpoint memberikan jawaban. app.Use menambahkan middleware. Middleware menerima HttpContext, yang menyimpan permintaan dan respons, serta next, yang menjalankan bagian pipeline selanjutnya.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});Kode sebelum await next() dijalankan saat permintaan masuk, sedangkan kode setelahnya dijalankan saat respons keluar. Respons mengirim header sebelum body, jadi atur header sebelum next(): setelah endpoint menulis body, header tidak dapat diubah lagi. Middleware hanya melihat permintaan yang sampai kepadanya, dan app.UseStaticFiles() menangani permintaan file sendiri, jadi middleware yang ditambahkan setelahnya tidak akan melihat /index.html.
Tantangan
MudahSetiap respons menunjukkan versi API yang menjawabnya pada header X-Api-Version: 1.
- Di
Program.cs, antaravar app = builder.Build();danapp.UseStaticFiles();, tambahkan middleware denganapp.Use(async (context, next) => { ... });. - Middleware tersebut menetapkan
context.Response.Headers["X-Api-Version"] = "1";, lalu memanggilawait next();.
Coba: tekan Jalankan. GET /api/recipes memberikan respons seperti sebelumnya, dan tab Headers menampilkan X-Api-Version: 1. Kirim GET /index.html: header tersebut juga ada. Kirim GET /nothing: status 404, dengan header tersebut.
Coba sendiri
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
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();
Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.
Semua pelajaran di Minimal API
4Middleware dan Logging
Middleware Pertamamu