Menu
CoddyTech

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.

challenge icon

Desafio

Fácil

Permita que os clientes alterem um campo de uma tarefa, como marcá-la como concluída, sem enviar o título novamente.

  1. No final de Program.cs, declare record TaskPatch(string? Title, bool? Done);
  2. Mapeie PATCH /api/tasks/{id:int} com um int id e um TaskPatch patch. Retorne Results.NotFound() quando nenhuma tarefa tiver esse id.
  3. 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 tiver null. Retorne a tarefa alterada com Results.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);
quiz iconTeste seus conhecimentos

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