ה-Middleware הראשון שלך
חלק מהיחידה Minimal APIs במסלול ה-ASP.NET Core של Coddy. שיעור 13 מתוך 20.
תוכנת ביניים היא קוד שכל בקשה עוברת דרכו, לפי הסדר שבו האפליקציה מוסיפה אותו, לפני שנקודת קצה משיבה. app.Use מוסיף תוכנת ביניים. היא מקבלת את HttpContext, שמכיל את הבקשה ואת התגובה, ואת next, שמריץ את שאר הצינור.
app.Use(async (context, next) =>
{
context.Response.Headers["Cache-Control"] = "no-store";
await next();
});קוד שלפני await next() רץ בדרך פנימה, וקוד שאחריו בדרך החוצה. תגובה שולחת את הכותרות שלה לפני הגוף שלה, לכן יש להגדיר כותרות לפני next(): לאחר שנקודת קצה כתבה את הגוף, אי אפשר עוד לשנות אותן. תוכנת ביניים רואה רק את הבקשות שמגיעות אליה, ו-app.UseStaticFiles() משיב בעצמו לבקשה לקובץ, כך שתוכנת ביניים שנוספת אחריו לא תראה לעולם את /index.html.
אתגר
קלכל תגובה מציינת בכותרת איזו גרסה של ה־API השיבה לה: X-Api-Version: 1.
- ב־
Program.cs, ביןvar app = builder.Build();לביןapp.UseStaticFiles();, הוסף תוכנת ביניים עםapp.Use(async (context, next) => { ... });. - היא מגדירה את
context.Response.Headers["X-Api-Version"] = "1";, ואז קוראת ל־await next();.
נסה את זה: לחץ על הרצה. GET /api/recipes משיב כמו קודם, ובכרטיסייה Headers מופיע X-Api-Version: 1. שלח GET /index.html: גם שם הכותרת מופיעה. שלח GET /nothing: הסטטוס הוא 404, והכותרת מופיעה.
נסו בעצמכם
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();
השיעור הזה כולל חידון קצר. התחילו את השיעור כדי לענות עליו ולעקוב אחרי ההתקדמות.
כל השיעורים ביחידה Minimal APIs
4Middleware ורישום לוגים
ה-Middleware הראשון שלך