Menu
CoddyTech

PATCH로 부분 업데이트하기

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

PATCH는 본문에 포함된 필드만 변경합니다. 생략된 필드와 값이 설정된 필드를 구분하려면 패치 레코드의 모든 속성을 nullable로 만드세요. 필드가 누락되면 null에 바인딩됩니다.

record ProfilePatch(string? Name, string? City);

profiles[index] = profile with
{
    Name = patch.Name ?? profile.Name,
    City = patch.City ?? profile.City,
};

with는 레코드를 복사하고 지정한 속성을 변경합니다. ??는 패치에 null이 있을 때 기존 값을 유지합니다. bool?도 같은 방식으로 작동합니다. false는 클라이언트가 보낸 값이고 null은 아무것도 보내지 않았다는 뜻입니다. 따라서 { "city": "Lyon" }은 프로필의 이름은 유지하면서 도시를 변경합니다.

challenge icon

챌린지

쉬움

클라이언트가 제목을 다시 보내지 않고도 완료 표시를 하는 것처럼 작업의 한 필드를 변경할 수 있게 하세요.

  1. Program.cs의 맨 아래에 record TaskPatch(string? Title, bool? Done);을 선언하세요.
  2. int id와 TaskPatch patch를 사용하는 PATCH /api/tasks/{id:int}를 매핑하세요. 해당 ID를 가진 작업이 없으면 Results.NotFound()를 반환하세요.
  3. 그렇지 않으면 with를 사용해 만든 작업의 복사본을 저장하세요. 각 속성에는 패치의 값이 들어가고, 패치 값이 null이면 작업의 기존 값이 유지됩니다. 변경된 작업을 Results.Ok로 반환하세요.

PATCH /api/tasks/1에 { "done": true }를 보내면 200과 다음 응답이 반환됩니다.

{ "id": 1, "title": "Write the project brief", "done": true }

직접 해 보세요: ‘실행’을 누르고 PATCH를 선택한 다음, 경로에 /api/tasks/1, 본문에 { "done": true }를 입력하고 ‘보내기’를 누르세요. 제목은 그대로 유지된 채 위 응답이 반환됩니다. /api/tasks/2에 { "title": "Book the big room" }을 사용해 PATCH를 보내면 새 제목이 적용되고 "done": true는 그대로 유지됩니다. /api/tasks/99에 PATCH를 보내면 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.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 icon실력 점검

이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.

REST API의 모든 레슨