Menu
CoddyTech

Aggiornamenti parziali con PATCH

Fa parte della sezione API REST del percorso ASP.NET Core di Coddy. Lezione 4 di 20.

PATCH modifica solo i campi inviati nel corpo. Per distinguere un campo omesso da uno impostato, rendi nullable ogni proprietà del record patch: un campo mancante viene associato a null.

record ProfilePatch(string? Name, string? City);

profiles[index] = profile with
{
    Name = patch.Name ?? profile.Name,
    City = patch.City ?? profile.City,
};

with copia un record e modifica le proprietà che elenchi. ?? mantiene il valore precedente quando la patch contiene null. bool? funziona allo stesso modo: false è un valore inviato dal client, mentre null significa che non ha inviato nulla. Quindi { "city": "Lyon" } sposta il profilo e ne mantiene il nome.

challenge icon

Sfida

Facile

Consenti ai client di modificare un singolo campo di un'attività, ad esempio spuntandola come completata, senza inviare di nuovo il titolo.

  1. In fondo a Program.cs, dichiara record TaskPatch(string? Title, bool? Done);
  2. Mappa PATCH /api/tasks/{id:int} con un int id e un TaskPatch patch. Restituisci Results.NotFound() se nessuna attività ha quell'id.
  3. Altrimenti salva una copia dell'attività creata con with, in cui ogni proprietà assume il valore della patch oppure mantiene quello dell'attività se la patch ha null. Restituisci l'attività modificata con Results.Ok.

PATCH /api/tasks/1 con { "done": true } restituisce 200 e:

{ "id": 1, "title": "Write the project brief", "done": true }

Prova: premi Esegui, scegli PATCH, percorso /api/tasks/1, corpo { "done": true } e Invia: riceverai la risposta qui sopra, con il titolo invariato. Invia PATCH /api/tasks/2 con { "title": "Book the big room" }: il nuovo titolo, mentre "done": true rimane invariato. PATCH /api/tasks/99 restituisce 404.

Provalo tu

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var tasks = new List<TaskItem>
{
    new(1, "Write the project brief", false),
    new(2, "Book the meeting room", true),
    new(3, "Send the invoice", false),
};
var nextId = 4;

app.MapGet("/api/tasks", () => tasks);

app.MapGet("/api/tasks/{id:int}", (int id) =>
{
    var task = tasks.Find(t => t.Id == id);
    return task is null ? Results.NotFound() : Results.Ok(task);
});

app.MapPost("/api/tasks", (TaskInput input) =>
{
    var task = new TaskItem(nextId++, input.Title, input.Done);
    tasks.Add(task);
    return Results.Created($"/api/tasks/{task.Id}", task);
});

app.MapPut("/api/tasks/{id:int}", (int id, TaskInput input) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
quiz iconMettiti alla prova

Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.

Tutte le lezioni di API REST