Menu
CoddyTech

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.

challenge icon

Görev

Kolay

İstemcilerin görevleri başlığa göre sıralamasını sağlayın.

  1. GET /api/tasks lambda'sına üçüncü bir parametre, string? sort, ekleyin.
  2. Lambda'nın başında hataları bir sözlükte toplayın. sort, null, id veya title değilse Sort by id or title. ifadesini sort anahtarı altında ekleyin ve sözlükte herhangi bir hata varsa Results.ValidationProblem(errors) yanıtını döndürün.
  3. Filtrelerden sonra, sort değeri title olduğunda sonucu OrderBy ile başlığa göre sıralayın. sort belirtilmediğinde veya sort=id olduğ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);

REST API'leri bölümündeki tüm dersler