Atualizações parciais com PATCH
Parte da seção APIs REST do Journey de ASP.NET Core da Coddy. Lição 4 de 20.
PATCH altera apenas os campos enviados pelo corpo da requisição. Para distinguir um campo que foi omitido de um que recebeu um valor, torne nullable todas as propriedades do registro de patch: um campo ausente é associado a null.
record ProfilePatch(string? Name, string? City);
profiles[index] = profile with
{
Name = patch.Name ?? profile.Name,
City = patch.City ?? profile.City,
};with copia um registro e altera as propriedades que você listar. ?? mantém o valor antigo quando o patch contém null. Um bool? funciona da mesma forma: false é um valor enviado pelo cliente, e null significa que ele não enviou nada. Portanto, { "city": "Lyon" } muda a cidade do perfil e mantém o nome.
Desafio
FácilPermita que os clientes alterem um campo de uma tarefa, como marcá-la como concluída, sem enviar o título novamente.
- No final de
Program.cs, declarerecord TaskPatch(string? Title, bool? Done); - Mapeie
PATCH /api/tasks/{id:int}com umint ide umTaskPatch patch. RetorneResults.NotFound()quando nenhuma tarefa tiver esse id. - Caso contrário, armazene uma cópia da tarefa criada com
with, em que cada propriedade recebe o valor do patch ou mantém o valor da própria tarefa quando o patch tivernull. Retorne a tarefa alterada comResults.Ok.
PATCH /api/tasks/1 com { "done": true } retorna 200 e:
{ "id": 1, "title": "Write the project brief", "done": true }Experimente: pressione Executar, escolha PATCH, caminho /api/tasks/1, o corpo { "done": true } e Enviar: a resposta acima, com o título mantido. Envie PATCH /api/tasks/2 com { "title": "Book the big room" }: o novo título, e "done": true permanece. PATCH /api/tasks/99 retorna 404.
Experimente você mesmo
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);
Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.
Todas as lições de APIs REST
1Recursos e verbos
Recursos e URLsCriando com POST