Menu
CoddyTech

PUT으로 교체하기

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

PUT은 항목을 교체합니다. 본문은 항목의 완전히 새로운 상태이며, 항목 자체의 URL로 전송됩니다. 본문에서 생략된 필드는 기본값을 갖습니다. 같은 PUT을 두 번 보내도 결과는 같으므로 PUT은 멱등성이 있습니다. 따라서 클라이언트는 시간 초과 후 요청을 다시 시도할 수 있습니다. POST는 두 번째 POST를 보내면 항목이 하나 더 추가되므로 그렇지 않습니다.

app.MapPut("/api/products/{id:int}", (int id, ProductInput input) =>
{
    var index = products.FindIndex(p => p.Id == id);
    if (index == -1) return Results.NotFound();
    products[index] = new Product(id, input.Name, input.Price);
    return Results.Ok(products[index]);
});

id는 본문이 아니라 경로에서 가져오므로 클라이언트는 제품을 다른 id로 옮길 수 없습니다. FindIndex는 목록에서 항목의 위치를 반환하며, 일치하는 항목이 없으면 -1을 반환합니다. products[index] = ...는 새 버전을 해당 위치에 저장합니다.

challenge icon

챌린지

쉬움

클라이언트가 작업을 바꿀 수 있도록 하세요.

  1. Program.cs에서 int id와 TaskInput input 매개변수를 받는 PUT /api/tasks/{id:int}를 매핑하세요. 본문은 POST 본문과 같은 형태입니다.
  2. tasks.FindIndex로 작업의 위치를 찾으세요. 값이 -1이면 Results.NotFound()로 응답하고 아무것도 추가하지 마세요.
  3. 그렇지 않으면 해당 위치에 new TaskItem(id, input.Title, input.Done)을 저장하고 Results.Ok로 응답하세요. PUT /api/tasks/1에 { "title": "Write the final brief", "done": true }를 보내면 200과 다음 응답을 받습니다:
    { "id": 1, "title": "Write the final brief", "done": true }

직접 해 보세요: ‘실행’을 누르고 PUT을 선택한 다음, 경로에 /api/tasks/1을 입력하고 위 본문을 넣은 후 ‘보내기’를 누르세요. 200과 위 작업이 표시됩니다. GET /api/tasks/1을 보내면 새 제목이 표시됩니다. { "title": "Book the big room" }을 본문으로 하여 /api/tasks/2에 PUT을 보내 보세요. 작업 2는 완료된 상태였지만 본문에서 done을 생략했으므로 "done": false로 응답합니다. /api/tasks/99에 PUT을 보내면 404로 응답합니다.

직접 해보기

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.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);

REST API의 모든 레슨