İlk Middleware’iniz
Coddy'nin ASP.NET Core Journey'sinin Minimal API'ler bölümünün bir parçası. Ders 13 / 20.
Ara yazılım, uygulama tarafından eklendiği sırayla her isteğin içinden geçtiği ve bir uç nokta yanıt vermeden önce çalışan koddur. app.Use bir tane ekler. İstek ve yanıtı tutan HttpContext nesnesini ve işlem hattının geri kalanını çalıştıran next değişkenini alır.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});await next() öncesindeki kod, istek ilerlerken; sonrasındaki kod ise geri dönerken çalışır. Yanıt, gövdesinden önce başlıklarını gönderir; bu nedenle başlıkları next() öncesinde ayarlayın: bir uç nokta gövdeyi yazdıktan sonra başlıklar artık değiştirilemez. Bir ara yazılım yalnızca kendisine ulaşan istekleri görür ve app.UseStaticFiles() dosya isteğini kendisi yanıtladığından, onun altına eklenen bir ara yazılım /index.html isteğini hiçbir zaman görmez.
Görev
KolayHer yanıt, başlığında hangi API sürümünün yanıt verdiğini belirtir: X-Api-Version: 1.
Program.csdosyasında,var app = builder.Build();ileapp.UseStaticFiles();arasınaapp.Use(async (context, next) => { ... });ile bir ara yazılım ekle.context.Response.Headers["X-Api-Version"] = "1";ayarını yapar, ardındanawait next();çağrısını yapar.
Deneyin: Çalıştır’a basın. GET /api/recipes önceki gibi yanıt verir ve Headers sekmesinde X-Api-Version: 1 görünür. GET /index.html isteğini gönderin: başlık orada da bulunur. GET /nothing isteğini gönderin: durum 404 olur ve başlık bulunur.
Kendin dene
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();
Bu ders kısa bir quiz içerir. Soruları yanıtlamak ve ilerlemeni kaydetmek için derse başla.
Minimal API'ler bölümündeki tüm dersler
1İlk Endpoint’ler
İlk Endpoint’inizJSON Döndürme4Middleware ve Günlük Kaydı
İlk Middleware’iniz2Sonuçlar ve JSON Gövdeleri
Tamam ve Bulunamadı