Menu
CoddyTech

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.

challenge icon

Aufgabe

Einfach

Clients können ein Rezept ändern.

  1. Ordne in Program.cs PUT /api/recipes/{id:int} zu. Die Lambda-Funktion erhält int id und NewRecipe input.
  2. Finde die Position des Rezepts mit recipes.FindIndex(r => r.Id == id). Wenn sie -1 ist, gib Results.NotFound(new { error = $"Recipe {id} not found" }) zurück.
  3. Erstelle andernfalls new Recipe(id, input.Name, input.Category, input.Minutes), setze es an diese Position in recipes und gib Results.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