דף HTML סטטי
חלק מהיחידה Minimal APIs במסלול ה-ASP.NET Core של Coddy. שיעור 12 מתוך 20.
אפליקציית אינטרנט שולחת לעיתים קרובות קבצים שאינם משתנים לעולם: דפי HTML, קובצי CSS ותמונות. ASP.NET Core מגיש אותם מתוך תיקיית wwwroot של הפרויקט לאחר הוספת תוכנת הביניים middleware לקבצים סטטיים. תוכנת ביניים היא קוד שכל בקשה עוברת דרכו בדרכה לנקודות הקצה; בפרק הבא נכתוב אחת כזאת.
var app = builder.Build();
app.UseStaticFiles();כאשר בפרויקט נמצאים wwwroot/about.html ו-wwwroot/css/site.css, הבקשות GET /about.html ו-GET /css/site.css מחזירות את הקבצים האלה, עם Content-Type שתואם לסיומת: text/html, text/css. הכתובת היא הנתיב בתוך wwwroot, בלי wwwroot עצמו. בקשה לקובץ שאינו קיים ממשיכה לנקודות הקצה, ולכן GET / עדיין מגיעה אל MapGet("/").
אתגר
קלל־API יש דף בית. wwwroot/index.html הוא קובץ חדש בפרויקט שלך.
- ב־
Program.cs, בשורה שאחריvar app = builder.Build();, הוסףapp.UseStaticFiles();. - ב־
wwwroot/index.html, מתחת לפסקה הראשונה, הוסף<p><a href="/api/recipes">All recipes</a></p>.
נסה זאת: לחץ על „הרצה”. הבקשה הראשונה היא GET /index.html: הסטטוס הוא 200, סוג התוכן הוא Content-Type: text/html, והדף מוצג עם הכותרת Recipe Box. הכרטיסייה Source מציגה את ה־HTML שלו. לחץ על All recipes כדי לשלוח GET /api/recipes. שלח GET /: עדיין מתקבל Recipe API is running.
נסו בעצמכם
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
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();