Eine statische HTML-Seite
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 12 von 20.
Eine Web-App sendet häufig Dateien, die sich nie ändern: HTML-Seiten, CSS-Dateien und Bilder. ASP.NET Core stellt sie aus dem Ordner wwwroot des Projekts bereit, sobald die Middleware für statische Dateien hinzugefügt wurde. Middleware ist Code, den jede Anfrage auf dem Weg zu den Endpunkten durchläuft; im nächsten Kapitel schreibst du selbst welche.
var app = builder.Build();
app.UseStaticFiles();Befinden sich wwwroot/about.html und wwwroot/css/site.css im Projekt, liefern GET /about.html und GET /css/site.css diese Dateien mit einem Content-Type, der zur Dateiendung passt: text/html, text/css. Die Adresse entspricht dem Pfad innerhalb von wwwroot, jedoch ohne wwwroot selbst. Eine Anfrage nach einer Datei, die nicht existiert, wird an die Endpunkte weitergeleitet, sodass GET / weiterhin MapGet("/") erreicht.
Aufgabe
EinfachDie API erhält eine Startseite. wwwroot/index.html ist neu in deinem Projekt.
- Füge in
Program.csin der Zeile nachvar app = builder.Build();app.UseStaticFiles();hinzu. - Füge in
wwwroot/index.htmlunter dem ersten Absatz<p><a href="/api/recipes">All recipes</a></p>hinzu.
Probiere es aus: Drücke auf „Ausführen“. Die erste Anfrage ist GET /index.html: Status 200, Content-Type: text/html, und die Seite wird mit der Überschrift Recipe Box angezeigt. Im Tab „Source“ wird das HTML angezeigt. Klicke auf All recipes, um GET /api/recipes zu senden. Sende GET /: weiterhin Recipe API is running.
Probier es selbst
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();
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden