Tri
Fait partie de la section APIs REST du Journey ASP.NET Core de Coddy. Leçon 12 sur 20.
Un paramètre sort permet au client de choisir l’ordre : GET /api/products?sort=price. Accepte uniquement les ordres que tu prends en charge et réponds 400 pour toute autre valeur, afin qu’une faute de frappe comme sort=prise soit signalée au lieu d’être ignorée.
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 renvoie une nouvelle séquence triée et laisse la liste intacte. products.Sort(...) réordonnerait la liste stockée elle-même, si bien que toutes les réponses suivantes seraient également renvoyées dans le nouvel ordre. Regrouper les erreurs dans un seul dictionnaire permet d’indiquer en une seule fois toutes les erreurs d’une requête qui en contient plusieurs.
Défi
FacileLaisse les clients trier les tâches par titre.
- Ajoute un troisième paramètre à la lambda
GET /api/tasks:string? sort. - Au début de la lambda, collecte les erreurs dans un dictionnaire. Lorsque
sortn’est ninull, niid, nititle, ajouteSort by id or title.soussort, et renvoieResults.ValidationProblem(errors)si le dictionnaire contient des erreurs. - Après les filtres, lorsque
sortvauttitle, trie le résultat par titre avecOrderBy. Sanssort, ou avecsort=id, les tâches restent dans l’ordre des identifiants.
GET /api/tasks?sort=title renvoie les tâches 2, 3 et 1 : Book, Send, Write.
Essaie : appuie sur « Exécuter » et envoie GET /api/tasks?sort=title : l’ordre ci-dessus. Envoie GET /api/tasks : retour à l’ordre des identifiants. Envoie GET /api/tasks?sort=size : 400 avec "errors": { "sort": ["Sort by id or title."] }. Envoie GET /api/tasks?done=false&sort=title : les tâches 3 et 1.
Essayez vous-même
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);