Menu
CoddyTech

충돌

Coddy ASP.NET Core 여정의 REST API 섹션에 포함된 레슨. 20개 중 9번째.

두 번째 사용자의 이름이 "Ada"이면 로그인에 모호함이 생기지만, 본문 자체는 유효합니다. 이것이 409 충돌입니다. 요청이 이미 저장된 내용과 충돌하는 것입니다. 400은 본문 자체에 문제가 있다는 뜻이고, 409는 본문은 올바르지만 지금은 적용할 수 없다는 뜻입니다.

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);

사람들은 "Ada"와 "ada"를 같은 이름으로 읽으므로 StringComparison.OrdinalIgnoreCase로 비교하세요. 요청에서 사용자의 이름을 바꿀 때는 검색 대상에서 해당 사용자를 제외하세요. 그렇지 않으면 이름을 바꾸지 않고 양식을 저장해도 자기 자신과 충돌합니다. Results.Problem은 제목과 상태를 포함해 문제 세부 정보 형식으로 응답합니다.

challenge icon

챌린지

중급

"Send the invoice"라는 이름의 작업이 두 개 있으면 목록이 혼란스러워집니다. 다른 작업에 이미 있는 제목은 거부하세요.

  1. Program.cs에서 nextId 아래에 로컬 함수 bool TitleTaken(string title, int exceptId)를 작성하세요. 대소문자를 구분하지 않고, exceptId가 아닌 작업이 해당 제목을 가지고 있으면 true를 반환합니다.
  2. POST에서 유효성 검사 다음에, 제목이 이미 있으면 Results.Problem(title: "A task with this title already exists.", statusCode: 409)를 반환하고 아무것도 추가하지 마세요. POST에서는 제외할 작업이 없으므로 0을 전달하세요.
  3. PUT에서도 같은 작업을 하되 작업의 id를 전달하세요. 이렇게 하면 작업이 자기 자신의 제목을 유지하거나 대소문자 표기를 변경할 수 있습니다.
  4. PATCH에서는 본문에 제목이 전송된 경우에만 확인하세요(patch.Title이 null이 아닌 경우).

거부된 요청은 아무것도 변경하지 않습니다. 409 응답 본문은 다음과 같습니다.

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

직접 해보기: Run을 누르고 /api/tasks에 { "title": "book the MEETING room" }을 POST하세요. 작업 2에 해당 제목이 있으므로 409가 반환됩니다. { "title": "Book the Meeting Room", "done": false }를 /api/tasks/2에 PUT하세요. 자기 자신의 제목이므로 200이 반환됩니다. { "title": "Write the project brief" }를 사용해 /api/tasks/3에 PATCH하세요. 409가 반환됩니다. { "title": "Order new chairs" }를 POST하세요. id가 4인 작업과 함께 201이 반환됩니다.

직접 해보기

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);

REST API의 모든 레슨