Sıralama
Coddy'nin ASP.NET Core Journey'sinin REST API'leri bölümünün bir parçası. Ders 12 / 20.
Bir sort parametresi, istemcinin sıralamayı seçmesine olanak tanır: GET /api/products?sort=price. Yalnızca desteklediğiniz sıralamaları kabul edin ve diğer her şey için 400 yanıtı verin; böylece sort=prise gibi bir yazım hatası yok sayılmak yerine bildirilir.
var errors = new Dictionary<string, string[]>();
if (sort is not null && sort != "name" && sort != "price")
errors["sort"] = ["Sort by name or price."];
if (errors.Count > 0) return Results.ValidationProblem(errors);
if (sort == "price") result = result.OrderBy(p => p.Price);OrderBy, yeni ve sıralanmış bir dizi döndürür ve listeyi olduğu gibi bırakır. products.Sort(...) ise saklanan listenin sırasını değiştirir; bu nedenle sonraki tüm yanıtlar da yeni sırayla gelir. Hataları tek bir sözlükte toplamak, birden fazla hatası olan bir istekte hepsinin aynı anda bildirilmesini sağlar.
Görev
Kolayİstemcilerin görevleri başlığa göre sıralamasını sağlayın.
GET /api/taskslambda'sına üçüncü bir parametre,string? sort, ekleyin.- Lambda'nın başında hataları bir sözlükte toplayın.
sort,null,idveyatitledeğilseSort by id or title.ifadesinisortanahtarı altında ekleyin ve sözlükte herhangi bir hata varsaResults.ValidationProblem(errors)yanıtını döndürün. - Filtrelerden sonra,
sortdeğerititleolduğunda sonucuOrderByile başlığa göre sıralayın.sortbelirtilmediğinde veyasort=idolduğunda görevler id sırasını korur.
GET /api/tasks?sort=title şu görevleri bu sırayla döndürür: 2, 3 ve 1: Book, Send, Write.
Deneyin: Çalıştır'a basın ve GET /api/tasks?sort=title isteğini gönderin: yukarıdaki sıralama. GET /api/tasks isteğini gönderin: id sırasına geri döner. GET /api/tasks?sort=size isteğini gönderin: "errors": { "sort": ["Sort by id or title."] } ile 400. GET /api/tasks?done=false&sort=title isteğini gönderin: 3 ve 1 numaralı görevler.
Kendin dene
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) =>
{
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));
return Results.Ok(result);
});
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);