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.
Sfida
FacileConsenti ai client di modificare un singolo campo di un'attività, ad esempio spuntandola come completata, senza inviare di nuovo il titolo.
- In fondo a
Program.cs, dichiararecord TaskPatch(string? Title, bool? Done); - Mappa
PATCH /api/tasks/{id:int}con unint ide unTaskPatch patch. RestituisciResults.NotFound()se nessuna attività ha quell'id. - 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 hanull. Restituisci l'attività modificata conResults.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);
Questa lezione include un breve quiz. Inizia la lezione per rispondere e tenere traccia dei tuoi progressi.
Tutte le lezioni di API REST
1Risorse e verbi
Risorse e URLCreare con POST2Validazione ed errori
Rifiutare input non validi