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.
Défi
FacilePermets aux clients de modifier un seul champ d’une tâche, par exemple de la marquer comme terminée, sans renvoyer le titre.
- En bas de
Program.cs, déclarerecord TaskPatch(string? Title, bool? Done); - Associe
PATCH /api/tasks/{id:int}à unint idet à unTaskPatch patch. RenvoieResults.NotFound()si aucune tâche ne possède cet identifiant. - 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 contientnull. Renvoie la tâche modifiée avecResults.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);
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
1Ressources et verbes
Ressources et URLCréer avec POST2Validation et erreurs
Rejeter les entrées incorrectes