Sortieren
Teil des Abschnitts REST-APIs der ASP.NET Core-Journey von Coddy. Lektion 12 von 20.
Ein Parameter sort ermöglicht es dem Client, die Reihenfolge auszuwählen: GET /api/products?sort=price. Akzeptiere nur die von dir unterstützten Sortierungen und antworte bei allen anderen mit 400, damit ein Tippfehler wie sort=prise gemeldet und nicht ignoriert wird.
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 gibt eine neue, sortierte Sequenz zurück und lässt die Liste unverändert. products.Sort(...) würde die gespeicherte Liste selbst umsortieren, sodass auch alle späteren Antworten in der neuen Reihenfolge zurückkämen. Wenn du Fehler in einem Wörterbuch sammelst, erhält eine Anfrage mit mehreren Fehlern alle Meldungen auf einmal.
Aufgabe
EinfachLass Clients die Aufgaben nach Titel sortieren.
- Gib dem Lambda-Ausdruck
GET /api/taskseinen dritten Parameter:string? sort. - Sammle am Anfang des Lambda-Ausdrucks Fehler in einem Dictionary. Wenn
sortwedernullnochidodertitleist, füge untersortSort by id or title.hinzu und gibResults.ValidationProblem(errors)zurück, wenn das Dictionary Einträge enthält. - Ordne das Ergebnis nach den Filtern mit
OrderBynach Titel, wennsortden Werttitlehat. Ohnesortoder mitsort=idbleiben die Aufgaben nach ID sortiert.
GET /api/tasks?sort=title liefert die Aufgaben 2, 3 und 1: Book, Send, Write.
Probiere es aus: Klicke auf „Ausführen“ und sende GET /api/tasks?sort=title: Die Reihenfolge ist wie oben. Sende GET /api/tasks: wieder nach ID sortiert. Sende GET /api/tasks?sort=size: 400 mit "errors": { "sort": ["Sort by id or title."] }. Sende GET /api/tasks?done=false&sort=title: die Aufgaben 3 und 1.
Probier es selbst
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);