Menu
CoddyTech

Conflictos

Parte de la sección API REST del Journey de ASP.NET Core de Coddy. Lección 9 de 20.

Un segundo usuario llamado "Ada" hace que los inicios de sesión sean ambiguos, pero el cuerpo es válido. Eso es un 409 Conflict: la solicitud entra en conflicto con lo que ya está almacenado. Un 400 significa que el cuerpo en sí está mal; un 409 significa que está bien, pero no se puede aplicar ahora.

bool NameTaken(string name, int exceptId) =>
    users.Any(u => u.Id != exceptId &&
        string.Equals(u.Name, name, StringComparison.OrdinalIgnoreCase));

if (NameTaken(input.Name, id))
    return Results.Problem(title: "That name is taken.", statusCode: 409);

La gente lee "Ada" y "ada" como el mismo nombre, así que compara con StringComparison.OrdinalIgnoreCase. Cuando una solicitud cambia el nombre de un usuario, excluye a ese usuario de la búsqueda; de lo contrario, guardar un formulario sin cambiar el nombre entra en conflicto consigo mismo. Results.Problem responde con la estructura de detalles del problema, con tu título y estado.

challenge icon

Desafío

Intermedio

Dos tareas llamadas "Send the invoice" hacen que la lista sea confusa. Rechaza un título que ya tenga otra tarea.

  1. En Program.cs, debajo de nextId, escribe una función local bool TitleTaken(string title, int exceptId): verdadero cuando una tarea distinta de exceptId tenga ese título, sin distinguir entre mayúsculas y minúsculas.
  2. En POST, después de la comprobación de validación, devuelve Results.Problem(title: "A task with this title already exists.", statusCode: 409) cuando el título ya esté en uso, y no agregues nada. POST no tiene ninguna tarea que excluir, así que pasa 0.
  3. Haz lo mismo en PUT, pasando el id de la tarea, para que una tarea pueda conservar su propio título o cambiar las mayúsculas.
  4. En PATCH, comprueba solo cuando el cuerpo envíe un título (patch.Title no sea null).

Una solicitud rechazada no cambia nada. El cuerpo de la respuesta 409 es:

{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10", "title": "A task with this title already exists.", "status": 409, "traceId": "..." }

Pruébalo: pulsa Ejecutar y envía por POST { "title": "book the MEETING room" } a /api/tasks: 409, porque la tarea 2 tiene ese título. Envía por PUT { "title": "Book the Meeting Room", "done": false } a /api/tasks/2: 200, es su propio título. Envía por PATCH /api/tasks/3 { "title": "Write the project brief" }: 409. Envía por POST { "title": "Order new chairs" }: 201 con id 4.

Pruébalo tú mismo

using System.ComponentModel.DataAnnotations;

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

app.UseExceptionHandler();
app.UseStatusCodePages();

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 errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    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 errors = Validation.Errors(input);
    if (errors is not null) return Results.ValidationProblem(errors);
    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.MapPatch("/api/tasks/{id:int}", (int id, TaskPatch patch) =>
{
    var index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    var task = tasks[index];
    tasks[index] = task with
    {
        Title = patch.Title ?? task.Title,
        Done = patch.Done ?? task.Done,
    };
    return Results.Ok(tasks[index]);
});

app.MapDelete("/api/tasks/{id:int}", (int id) =>
{
    var removed = tasks.RemoveAll(t => t.Id == id);
    return removed == 0 ? Results.NotFound() : Results.NoContent();
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(
    [property: Required(ErrorMessage = "Title is required."), StringLength(80)] string Title,
    bool Done);
record TaskPatch(string? Title, bool? Done);

Todas las lecciones de API REST