Menu
CoddyTech

Mises à jour partielles avec PATCH

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

PATCH ne modifie que les champs envoyés dans le corps de la requête. Pour distinguer un champ omis d’un champ renseigné, rends nullable chaque propriété de l’enregistrement de patch : un champ manquant est associé à null.

record ProfilePatch(string? Name, string? City);

profiles[index] = profile with
{
    Name = patch.Name ?? profile.Name,
    City = patch.City ?? profile.City,
};

with copie un enregistrement et modifie les propriétés que tu indiques. ?? conserve l’ancienne valeur lorsque le patch contient null. Un bool? fonctionne de la même façon : false est une valeur envoyée par le client, et null signifie qu’il n’a rien envoyé. Ainsi, { "city": "Lyon" } déplace le profil tout en conservant son nom.

challenge icon

Défi

Facile

Permets aux clients de modifier un seul champ d’une tâche, par exemple de la marquer comme terminée, sans renvoyer le titre.

  1. En bas de Program.cs, déclare record TaskPatch(string? Title, bool? Done);
  2. Associe PATCH /api/tasks/{id:int} à un int id et à un TaskPatch patch. Renvoie Results.NotFound() si aucune tâche ne possède cet identifiant.
  3. Sinon, stocke une copie de la tâche créée avec with, où chaque propriété prend la valeur du patch ou conserve celle de la tâche si le patch contient null. Renvoie la tâche modifiée avec Results.Ok.

PATCH /api/tasks/1 avec { "done": true } renvoie 200 et :

{ "id": 1, "title": "Write the project brief", "done": true }

Essaie : appuie sur Exécuter, choisis PATCH, indique le chemin /api/tasks/1, le corps { "done": true }, puis appuie sur Envoyer : tu obtiens la réponse ci-dessus, avec le titre conservé. Envoie PATCH /api/tasks/2 avec { "title": "Book the big room" } : le nouveau titre est appliqué et "done": true reste inchangé. PATCH /api/tasks/99 renvoie 404.

Essayez vous-même

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

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;

app.MapGet("/api/tasks", () => tasks);

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 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 index = tasks.FindIndex(t => t.Id == id);
    if (index == -1) return Results.NotFound();
    tasks[index] = new TaskItem(id, input.Title, input.Done);
    return Results.Ok(tasks[index]);
});

app.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
quiz iconTestez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

Toutes les leçons de APIs REST