Une page HTML statique
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 12 sur 20.
Une application web envoie souvent des fichiers qui ne changent jamais : des pages HTML, des fichiers CSS, des images. ASP.NET Core les sert depuis le dossier wwwroot du projet dès que le middleware des fichiers statiques est ajouté. Le middleware est du code que chaque requête traverse en chemin vers les points de terminaison ; le chapitre suivant en écrira un.
var app = builder.Build();
app.UseStaticFiles();Avec wwwroot/about.html et wwwroot/css/site.css dans le projet, GET /about.html et GET /css/site.css renvoient ces fichiers, avec un Content-Type correspondant à l’extension : text/html, text/css. L’adresse est le chemin à l’intérieur de wwwroot, sans wwwroot lui-même. Une requête pour un fichier inexistant est transmise aux points de terminaison ; ainsi, GET / atteint toujours MapGet("/").
Défi
FacileL’API a une page d’accueil. wwwroot/index.html est nouveau dans ton projet.
- Dans
Program.cs, à la ligne aprèsvar app = builder.Build();, ajouteapp.UseStaticFiles();. - Dans
wwwroot/index.html, sous le premier paragraphe, ajoute<p><a href="/api/recipes">All recipes</a></p>.
Essaie : appuie sur « Exécuter ». La première requête est GET /index.html : statut 200, Content-Type: text/html, et la page s’affiche avec le titre Recipe Box. L’onglet Source affiche son HTML. Clique sur All recipes pour envoyer GET /api/recipes. Envoie GET / : le résultat est toujours Recipe API is running.
Essayez vous-même
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();