Protokollstufen
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 16 von 20.
Jede Protokollzeile hat eine Stufe. Von der niedrigsten zur höchsten: Trace, Debug, Information, Warning, Error und Critical, geschrieben mit LogTrace bis hin zu LogCritical. Die Einstellungen legen für jede Kategorie die niedrigste beibehaltene Stufe fest. Die Datei appsettings.json eines neuen ASP.NET Core-Projekts enthält:
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}Deine LogDebug-Zeilen werden also verworfen, ebenso die Information-Zeilen von ASP.NET Core selbst, während dessen Warnungen erhalten bleiben. Dein Projekt hat keine appsettings.json; „Ausführen“ wendet dieselben Stufen an. Warning ist für etwas Ungewöhnliches gedacht, das die App nicht beeinträchtigt hat, zum Beispiel eine Anfrage nach einem Rezept, das nicht existiert.
Aufgabe
EinfachEine Anfrage für ein nicht vorhandenes Rezept wird als Warnung protokolliert.
- Gib in
Program.csdem Lambda-Ausdruck fürGET /api/recipes/{id:int}einen zweiten Parameter:ILogger<Program> logger. - Rufe innerhalb von
if (recipe is null)vor demreturnlogger.LogWarning("Recipe {Id} was not found", id);auf. Dasifführt nun zwei Anweisungen aus, gib ihm daher geschweifte Klammern.
Probiere es aus: Drücke auf „Ausführen“. Die erste Anfrage, GET /api/recipes/99, antwortet wie zuvor mit 404, und die Konsole zeigt warn: Program[0] und Recipe 99 was not found. Sende GET /api/recipes/2: 200 und keine Warnung.
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, 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();
Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.
Alle Lektionen in Minimal APIs
1Erste Endpoints
Dein erster EndpointJSON zurückgeben4Middleware und Protokollierung
Deine erste Middleware2Ergebnisse und JSON-Bodies
OK und Nicht gefunden