Menu
CoddyTech

התנגשויות

חלק מהיחידה REST APIs במסלול ה-ASP.NET Core של Coddy. שיעור 9 מתוך 20.

משתמש שני בשם "Ada" הופך את ההתחברות לעמומה, אך גוף הבקשה תקין. זהו 409 Conflict: הבקשה מתנגשת עם מה שכבר שמור. שגיאת 400 פירושה שגוף הבקשה עצמו שגוי; שגיאת 409 פירושה שהוא תקין, אך אי אפשר להחיל אותו כרגע.

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

אנשים קוראים את "Ada" ואת "ada" כשם זהה, לכן השוו באמצעות StringComparison.OrdinalIgnoreCase. כשבקשה משנה את שם המשתמש, השאירו את אותו משתמש מחוץ לחיפוש: אחרת, שמירת טופס בלי לשנות את השם תתנגש עם עצמה. Results.Problem משיב במבנה של פרטי הבעיה, עם הכותרת והסטטוס שלכם.

challenge icon

אתגר

בינוני

שתי משימות בשם "Send the invoice" מבלבלות את הרשימה. סרבו לקבל כותרת שכבר קיימת במשימה אחרת.

  1. ב-Program.cs, מתחת ל-nextId, כתבו פונקציה מקומית bool TitleTaken(string title, int exceptId): היא מחזירה true כשיש משימה מלבד exceptId שהכותרת שלה זהה, ללא תלות באותיות גדולות או קטנות.
  2. ב-POST, אחרי בדיקת האימות, החזירו Results.Problem(title: "A task with this title already exists.", statusCode: 409) כשהכותרת כבר קיימת, ואל תוסיפו דבר. ל-POST אין משימה שצריך להחריג, לכן העבירו 0.
  3. עשו אותו דבר ב-PUT, והעבירו את ה-id של המשימה, כך שמשימה תוכל לשמור על הכותרת שלה או לשנות את האותיות הגדולות והקטנות שבה.
  4. ב-PATCH, בדקו רק אם גוף הבקשה כולל כותרת (patch.Title אינו null).

בקשה שנדחית לא משנה דבר. גוף התשובה של 409 הוא:

{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10", "title": "A task with this title already exists.", "status": 409, "traceId": "..." }

נסו זאת: לחצו על הרצה ובצעו POST עם { "title": "book the MEETING room" } אל /api/tasks: מתקבלת תשובת 409, כי למשימה 2 יש את הכותרת הזאת. בצעו PUT עם { "title": "Book the Meeting Room", "done": false } אל /api/tasks/2: מתקבלת תשובת 200, כי זו הכותרת של המשימה עצמה. בצעו PATCH אל /api/tasks/3 עם { "title": "Write the project brief" }: מתקבלת תשובת 409. בצעו POST עם { "title": "Order new chairs" }: מתקבלת תשובת 201 עם מזהה 4.

נסו בעצמכם

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

כל השיעורים ביחידה REST APIs