Conflits
Fait partie de la section APIs REST du Journey ASP.NET Core de Coddy. Leçon 9 sur 20.
Un deuxième utilisateur nommé "Ada" rend les connexions ambiguës, alors que le corps de la requête est valide. C’est un 409 Conflict : la requête entre en conflit avec ce qui est déjà enregistré. Un 400 signifie que le corps lui-même est incorrect ; un 409 signifie qu’il est valide, mais ne peut pas être appliqué maintenant.
bool NameTaken(string name, int exceptId) =>
users.Any(u => u.Id != exceptId &&
string.Equals(u.Name, name, StringComparison.OrdinalIgnoreCase));
if (NameTaken(input.Name, id))
return Results.Problem(title: "That name is taken.", statusCode: 409);Les gens considèrent « Ada » et « ada » comme le même nom ; compare donc avec StringComparison.OrdinalIgnoreCase. Lorsqu’une requête renomme un utilisateur, exclue cet utilisateur de la recherche : sinon, enregistrer un formulaire sans modifier le nom crée un conflit avec lui-même. Results.Problem répond au format des détails du problème, avec ton titre et ton statut.
Défi
MoyenDeux tâches appelées "Send the invoice" rendent la liste confuse. Refuse un titre qu’une autre tâche possède déjà.
- Dans
Program.cs, sousnextId, écris une fonction localebool TitleTaken(string title, int exceptId): vrai lorsqu’une tâche autre queexceptIdpossède ce titre, sans tenir compte de la casse. - Dans POST, après la vérification de validation, renvoie
Results.Problem(title: "A task with this title already exists.", statusCode: 409)si le titre est déjà pris, et n’ajoute rien. POST n’a aucune tâche à exclure, alors passe0. - Fais de même dans PUT, en passant l’
idde la tâche, afin qu’une tâche puisse conserver son propre titre ou en changer la casse. - Dans PATCH, vérifie uniquement lorsque le corps de la requête envoie un titre (
patch.Titlen’est pasnull).
Une requête refusée ne change rien. Le corps de la réponse 409 est :
{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10", "title": "A task with this title already exists.", "status": 409, "traceId": "..." }Essaie : appuie sur « Exécuter » et envoie POST { "title": "book the MEETING room" } à /api/tasks : 409, car la tâche 2 a ce titre. Envoie PUT { "title": "Book the Meeting Room", "done": false } à /api/tasks/2 : 200, c’est son propre titre. Envoie PATCH /api/tasks/3 avec { "title": "Write the project brief" } : 409. Envoie POST { "title": "Order new chairs" } : 201 avec l’id 4.
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;
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 errors = Validation.Errors(input);
if (errors is not null) return Results.ValidationProblem(errors);
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();
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();
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
2Validation et erreurs
Rejeter les entrées incorrectes