Menu
CoddyTech

Priorités des tâches

Fait partie de la section APIs REST du Journey ASP.NET Core de Coddy. Leçon 14 sur 20.

Ce chapitre est un projet : tu ajoutes une fonctionnalité à l’ensemble de l’API avec ce que tu as appris. Certaines tâches sont urgentes, donc chaque tâche reçoit une priorité : 1 est élevée, 2 est normale, 3 est faible.

record Seat(int Row, [property: Range(1, 40)] int Number = 1);

[Range(1, 40)] refuse un nombre inférieur à 1 ou supérieur à 40 avec le message The field Number must be between 1 and 40. Une valeur par défaut dans un enregistrement positionnel (= 1) est la valeur attribuée lorsque le corps JSON omet le champ. Sur une propriété nullable, Range laisse passer null, ce qui convient à une requête PATCH.

challenge icon

Défi

Moyen

Attribue à chaque tâche une priorité de 1 (élevée) à 3 (faible). Conserve tout ce que tu as créé : chaque point de terminaison continue de fonctionner comme avant.

  1. Ajoute int Priority = 2 comme dernière propriété de TaskItem. Attribue la priorité 1 à la tâche 1 et la priorité 3 à la tâche 2 ; la tâche 3 conserve la valeur par défaut, 2.
  2. Ajoute [property: Range(1, 3)] int Priority = 2 comme dernière propriété de TaskInput, et passe input.Priority au nouveau TaskItem dans POST et PUT.
  3. Ajoute [property: Range(1, 3)] int? Priority à TaskPatch. Au début de PATCH, vérifie le patch avec Validation.Errors(patch) et renvoie Results.ValidationProblem lorsqu’il trouve des erreurs. Copie la priorité dans le with, comme pour les autres champs.

Chaque tâche contient désormais sa priorité : { "id": 1, "title": "Write the project brief", "done": false, "priority": 1 }. Une priorité de 5 renvoie 400 avec "errors": { "priority": ["The field Priority must be between 1 and 3."] }.

Essaie : appuie sur Exécuter : chaque tâche de la liste a une priorité. POST { "title": "Order new chairs" } : priorité 2. POST { "title": "Fix the printer", "priority": 5 } : 400. PATCH /api/tasks/3 avec { "priority": 1 } : la tâche 3 devient urgente et conserve son titre.

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, 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);

Toutes les leçons de APIs REST