Niveaux de journalisation
Fait partie de la section Minimal APIs du Journey ASP.NET Core de Coddy. Leçon 16 sur 20.
Chaque ligne de journal possède un niveau. Du plus bas au plus élevé : Trace, Debug, Information, Warning, Error et Critical, écrits avec LogTrace jusqu’à LogCritical. Les paramètres définissent le niveau le plus bas conservé pour chaque catégorie. Le fichier appsettings.json d’un nouveau projet ASP.NET Core contient :
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}Ainsi, vos lignes LogDebug sont ignorées, tout comme les lignes Information propres à ASP.NET Core, tandis que ses avertissements sont conservés. Votre projet ne contient pas de fichier appsettings.json ; Exécuter applique ces mêmes niveaux. Warning sert à signaler quelque chose d’inhabituel qui n’a pas interrompu l’application, comme une demande concernant une recette inexistante.
Défi
FacileUne requête concernant une recette qui n’existe pas est enregistrée comme avertissement.
- Dans
Program.cs, ajoute le paramètreILogger<Program> loggerà la lambdaGET /api/recipes/{id:int}. - À l’intérieur de
if (recipe is null), avant lereturn, appellelogger.LogWarning("Recipe {Id} was not found", id);. Leifexécute maintenant deux instructions : ajoute donc des accolades.
Essaie : appuie sur « Exécuter ». La première requête, GET /api/recipes/99, renvoie toujours 404, et la Console affiche warn: Program[0] et Recipe 99 was not found. Envoie GET /api/recipes/2 : 200, et aucun avertissement.
Essayez vous-même
using Microsoft.AspNetCore.Http.HttpResults;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.Use(async (context, next) =>
{
context.Response.Headers["X-Api-Version"] = "1";
await next();
});
app.Use(async (context, next) =>
{
if (context.Request.Path.StartsWithSegments("/recipes"))
{
context.Response.Redirect("/api" + context.Request.Path + context.Request.QueryString, permanent: true);
return;
}
await next();
});
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, ILogger<Program> logger) =>
{
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);
logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);
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();
Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.
Toutes les leçons de Minimal APIs
1Premiers endpoints
Votre premier endpointRenvoyer du JSON4Middleware et journalisation
Votre premier middleware2Résultats et corps JSON
OK et introuvable