Protokollierung mit ILogger
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 15 von 20.
Console.WriteLine gibt Text aus und nichts weiter. Ein Logger schreibt jede Zeile mit einer Ebene und einer Kategorie, und die Einstellungen der App bestimmen, welche Zeilen beibehalten werden. Ein Endpunkt erhält einen solchen, indem er ihn als Parameter benennt: ASP.NET Core übergibt Dienste wie ILogger<T> an jede Lambda-Funktion, die danach fragt.
app.MapPost("/orders", (NewOrder input, ILogger<Program> logger) =>
{
logger.LogInformation("Order of {Count} items for {Customer}", input.Count, input.Customer);
return Results.Ok();
});Die Nachricht ist eine Vorlage: Jedes {Name} wird der Reihe nach mit dem nächsten Argument ausgefüllt, und der Logger speichert die Werte als benannte Felder, nach denen Protokollierungstools suchen können. Die Konsole zeigt info: Program[0] und darunter die Nachricht: die Ebene, die Kategorie (Program, von ILogger<Program>) und eine Ereignis-ID.
Aufgabe
EinfachDie App protokolliert jedes Rezept, das sie hinzufügt.
- Füge in
Program.csdem Lambda-Ausdruck fürPOST /api/recipeseinen zweiten Parameter hinzu:ILogger<Program> logger. - Rufe direkt nach
recipes.Add(recipe);logger.LogInformation("Added recipe {Id}: {Name}", recipe.Id, recipe.Name);auf.
Probiere es aus: Klicke auf „Ausführen“ und sende per POST {"name":"Waffles","category":"breakfast","minutes":20} an /api/recipes. Die Konsole zeigt info: Program[0] und Added recipe 4: Waffles an. Sende per POST {"minutes":5}: Status 400, und es wird keine Zeile protokolliert.
Probier es selbst
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) =>
{
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