Actualizaciones parciales con PATCH
Parte de la sección API REST del Journey de ASP.NET Core de Coddy. Lección 4 de 20.
PATCH cambia solo los campos que envía el cuerpo. Para distinguir un campo que se omitió de uno al que se le asignó un valor, haz que todas las propiedades del registro de parche acepten valores nulos: un campo ausente se vincula 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 registro y cambia las propiedades que enumeras. ?? conserva el valor anterior cuando el parche contiene null. bool? funciona de la misma manera: false es un valor que envió el cliente, y null significa que no envió nada. Así, { "city": "Lyon" } cambia la ciudad del perfil y conserva su nombre.
Desafío
FácilPermite que los clientes cambien un campo de una tarea, como marcarla como completada, sin volver a enviar el título.
- Al final de
Program.cs, declararecord TaskPatch(string? Title, bool? Done); - Asocia
PATCH /api/tasks/{id:int}con unint idy unTaskPatch patch. Responde conResults.NotFound()cuando ninguna tarea tenga ese id. - En caso contrario, guarda una copia de la tarea creada con
with, donde cada propiedad toma el valor del parche o conserva el valor de la tarea cuando el parche tienenull. Responde con la tarea modificada usandoResults.Ok.
PATCH /api/tasks/1 con { "done": true } responde con 200 y:
{ "id": 1, "title": "Write the project brief", "done": true }Pruébalo: pulsa Ejecutar, elige PATCH, la ruta /api/tasks/1, el cuerpo { "done": true } y Enviar: obtendrás la respuesta anterior, con el título conservado. Envía PATCH a /api/tasks/2 con { "title": "Book the big room" }: aparecerá el título nuevo y "done": true se conservará. PATCH /api/tasks/99 responde con 404.
Pruébalo tú mismo
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 lección incluye un breve cuestionario. Empieza la lección para responderlo y registrar tu progreso.
Todas las lecciones de API REST
1Recursos y verbos
Recursos y URLCrear con POST2Validación y errores
Rechazar entradas no válidas5Navegadores y alojamiento
CORS