Mit PUT aktualisieren
Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 9 von 20.
Eine PUT-Anfrage ersetzt die Ressource unter einer Adresse durch den Inhalt, den sie sendet. Ihre Lambda-Funktion erhält gemeinsam einen Routenparameter und einen Inhalt:
app.MapPut("/notes/{id:int}", (int id, NewNote input) =>
{
var index = notes.FindIndex(n => n.Id == id);
if (index == -1)
return Results.NotFound();
notes[index] = new Note(id, input.Text);
return Results.Ok(notes[index]);
});FindIndex gibt die Position des ersten Treffers oder -1 zurück. Ein Datensatz kann nach seiner Erstellung nicht geändert werden. Daher erstellt der Endpunkt einen neuen Datensatz mit derselben ID und fügt ihn an dieser Position ein. Dasselbe PUT zweimal zu senden, ergibt dasselbe Ergebnis; dasselbe POST zweimal zu senden, fügt zwei Ressourcen hinzu.
Aufgabe
EinfachClients können ein Rezept ändern.
- Ordne in
Program.csPUT /api/recipes/{id:int}zu. Die Lambda-Funktion erhältint idundNewRecipe input. - Finde die Position des Rezepts mit
recipes.FindIndex(r => r.Id == id). Wenn sie-1ist, gibResults.NotFound(new { error = $"Recipe {id} not found" })zurück. - Erstelle andernfalls
new Recipe(id, input.Name, input.Category, input.Minutes), setze es an diese Position inrecipesund gibResults.Ok(recipe)zurück.
Probiere es aus: Klicke auf „Ausführen“, wähle PUT und den Pfad /api/recipes/2 sowie den Body {"name":"Banana Pancakes","category":"breakfast","minutes":20} und klicke auf „Senden“: Status 200 mit {"id":2,"name":"Banana Pancakes","category":"breakfast","minutes":20}. Sende GET /api/recipes: drei Rezepte, Banana Pancakes in der Mitte. Eine PUT-Anfrage an /api/recipes/99 liefert 404.
Probier es selbst
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;
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.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