작업 우선순위
Coddy ASP.NET Core 여정의 REST API 섹션에 포함된 레슨. 20개 중 14번째.
이 장은 프로젝트입니다. 지금까지 배운 내용을 바탕으로 API 전체에 기능을 추가합니다. 일부 작업은 긴급하므로 각 작업에는 우선순위가 지정됩니다. 1은 높음, 2는 보통, 3은 낮음입니다.
record Seat(int Row, [property: Range(1, 40)] int Number = 1);[Range(1, 40)]은 1부터 40까지의 범위를 벗어나는 숫자를 거부하며, 이때 The field Number must be between 1 and 40.라는 메시지를 표시합니다. 위치 지정 레코드의 기본값(= 1)은 필드를 생략한 JSON 본문에 적용됩니다. nullable 속성에서는 Range가 null을 허용하므로 PATCH에 적합합니다.
챌린지
중급모든 작업에 1(높음)부터 3(낮음)까지의 우선순위를 지정하세요. 지금까지 만든 모든 것을 유지하세요. 모든 엔드포인트가 이전처럼 계속 작동해야 합니다.
TaskItem의 마지막 속성으로int Priority = 2를 추가하세요. 작업 1의 우선순위는 1, 작업 2의 우선순위는 3으로 지정하고, 작업 3은 기본값인 2를 유지하세요.TaskInput의 마지막 속성으로[property: Range(1, 3)] int Priority = 2를 추가하고, POST와 PUT에서 새TaskItem에input.Priority를 전달하세요.TaskPatch에[property: Range(1, 3)] int? Priority를 추가하세요. PATCH 시작 부분에서Validation.Errors(patch)로 패치를 검사하고, 오류가 있으면Results.ValidationProblem을 반환하세요. 다른 필드와 마찬가지로with에서 우선순위를 복사하세요.
이제 모든 작업에 우선순위가 포함됩니다. 예를 들면 다음과 같습니다. { "id": 1, "title": "Write the project brief", "done": false, "priority": 1 }. 우선순위가 5이면 "errors": { "priority": ["The field Priority must be between 1 and 3."] }와 함께 400을 반환합니다.
직접 해보기: ‘실행’을 누르세요. 목록의 모든 작업에 우선순위가 표시됩니다. POST { "title": "Order new chairs" }를 보내면 우선순위는 2입니다. POST { "title": "Fix the printer", "priority": 5 }를 보내면 400을 반환합니다. /api/tasks/3에 { "priority": 1 }을 사용해 PATCH를 보내면 작업 3의 우선순위가 긴급 수준으로 바뀌고 제목은 그대로 유지됩니다.
직접 해보기
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;
bool TitleTaken(string title, int exceptId) =>
tasks.Any(t => t.Id != exceptId && string.Equals(t.Title, title, StringComparison.OrdinalIgnoreCase));
app.MapGet("/api/tasks", (bool? done, string? search, string? sort, HttpResponse response, int page = 1, int pageSize = 10) =>
{
var errors = new Dictionary<string, string[]>();
if (sort is not null && sort != "id" && sort != "title")
errors["sort"] = ["Sort by id or title."];
if (page < 1)
errors["page"] = ["Page starts at 1."];
if (pageSize < 1 || pageSize > 50)
errors["pageSize"] = ["Page size is 1 to 50."];
if (errors.Count > 0) return Results.ValidationProblem(errors);
IEnumerable<TaskItem> result = tasks;
if (done is not null) result = result.Where(t => t.Done == done);
if (!string.IsNullOrWhiteSpace(search))
result = result.Where(t => t.Title.Contains(search, StringComparison.OrdinalIgnoreCase));
if (sort == "title") result = result.OrderBy(t => t.Title);
var matching = result.ToList();
response.Headers["X-Total-Count"] = matching.Count.ToString();
return Results.Ok(matching.Skip((page - 1) * pageSize).Take(pageSize));
});
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);
if (TitleTaken(input.Title, 0))
return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
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();
if (TitleTaken(input.Title, id))
return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
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();
if (patch.Title is not null && TitleTaken(patch.Title, id))
return Results.Problem(title: "A task with this title already exists.", statusCode: 409);
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);