Konflik
Termasuk bagian REST API dalam perjalanan ASP.NET Core di Coddy. Pelajaran 9 dari 20.
Pengguna kedua bernama "Ada" membuat login menjadi ambigu, meskipun isi permintaannya valid. Itulah 409 Conflict: permintaan bertentangan dengan data yang sudah tersimpan. Kode 400 berarti isi permintaan itu sendiri salah, sedangkan kode 409 berarti isinya benar, tetapi tidak dapat diterapkan sekarang.
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);Orang membaca "Ada" dan "ada" sebagai nama yang sama, jadi bandingkan dengan StringComparison.OrdinalIgnoreCase. Saat permintaan mengganti nama pengguna, jangan sertakan pengguna itu dalam pencarian: kalau tidak, menyimpan formulir tanpa mengubah nama akan bertentangan dengan dirinya sendiri. Results.Problem memberikan jawaban dalam format detail masalah, dengan judul dan status yang kamu tentukan.
Tantangan
SedangDua tugas bernama "Send the invoice" membuat list membingungkan. Tolak judul yang sudah dimiliki tugas lain.
- Di
Program.cs, di bawahnextId, tulis fungsi lokalbool TitleTaken(string title, int exceptId): bernilai true ketika tugas selainexceptIdmemiliki judul tersebut, tanpa membedakan huruf besar-kecil. - Di POST, setelah pemeriksaan validasi, berikan respons
Results.Problem(title: "A task with this title already exists.", statusCode: 409)jika judul tersebut sudah digunakan, dan jangan tambahkan apa pun. POST tidak memiliki tugas yang perlu dikecualikan, jadi berikan0. - Lakukan hal yang sama di PUT, dengan memberikan
idtugas, sehingga tugas dapat mempertahankan judulnya sendiri atau mengubah kapitalisasinya. - Di PATCH, lakukan pemeriksaan hanya ketika body mengirim judul (
patch.Titlebukannull).
Permintaan yang ditolak tidak mengubah apa pun. Body 409 adalah:
{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10", "title": "A task with this title already exists.", "status": 409, "traceId": "..." }Coba: tekan Jalankan dan lakukan POST { "title": "book the MEETING room" } ke /api/tasks: 409, karena tugas 2 memiliki judul tersebut. Lakukan PUT { "title": "Book the Meeting Room", "done": false } ke /api/tasks/2: 200, karena itu judulnya sendiri. Lakukan PATCH /api/tasks/3 dengan { "title": "Write the project brief" }: 409. Lakukan POST { "title": "Order new chairs" }: 201 dengan id 4.
Coba sendiri
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);