Menu
CoddyTech

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.

challenge icon

Tantangan

Sedang

Dua tugas bernama "Send the invoice" membuat list membingungkan. Tolak judul yang sudah dimiliki tugas lain.

  1. Di Program.cs, di bawah nextId, tulis fungsi lokal bool TitleTaken(string title, int exceptId): bernilai true ketika tugas selain exceptId memiliki judul tersebut, tanpa membedakan huruf besar-kecil.
  2. 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 berikan 0.
  3. Lakukan hal yang sama di PUT, dengan memberikan id tugas, sehingga tugas dapat mempertahankan judulnya sendiri atau mengubah kapitalisasinya.
  4. Di PATCH, lakukan pemeriksaan hanya ketika body mengirim judul (patch.Title bukan null).

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

Semua pelajaran di REST API