Çakışmalar
Coddy'nin ASP.NET Core Journey'sinin REST API'leri bölümünün bir parçası. Ders 9 / 20.
"Ada" adında ikinci bir kullanıcı girişleri belirsiz hâle getirir, ancak gövde geçerlidir. Bu, 409 Conflict durumudur: istek, zaten kayıtlı olanlarla çelişir. 400, gövdenin kendisinin hatalı olduğu anlamına gelir; 409 ise gövdenin doğru olduğu ancak şu anda uygulanamayacağı anlamına gelir.
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);İnsanlar "Ada" ile "ada" adlarını aynı kabul eder, bu nedenle StringComparison.OrdinalIgnoreCase ile karşılaştırın. Bir istek kullanıcı adını değiştirdiğinde, o kullanıcıyı aramanın dışında tutun: aksi takdirde, adı değiştirmeden formu kaydetmek kullanıcının kendisiyle çakışır. Results.Problem, başlığınızı ve durum kodunuzu içeren problem ayrıntıları biçiminde yanıt verir.
Görev
Orta"Send the invoice" adlı iki görev listeyi kafa karıştırıcı hâle getirir. Başka bir görevin zaten sahip olduğu bir başlığı reddet.
Program.csdosyasında,nextIdaltına yerel bir fonksiyon yaz:bool TitleTaken(string title, int exceptId).exceptIddışındaki bir görevde bu başlık varsa, büyük/küçük harf duyarlılığı olmadan true döndürsün.- POST işleminde, doğrulama kontrolünden sonra başlık zaten kullanılıyorsa
Results.Problem(title: "A task with this title already exists.", statusCode: 409)yanıtını ver ve hiçbir şey ekleme. POST işleminde hariç tutulacak bir görev olmadığından0değerini geçir. - Aynısını PUT işleminde de yap ve görevin
iddeğerini geçir; böylece bir görev kendi başlığını koruyabilir veya başlığındaki büyük/küçük harfleri değiştirebilir. - PATCH işleminde yalnızca istek gövdesi bir başlık gönderdiğinde kontrol et (
patch.Titledeğerinulldeğilse).
Reddedilen bir istek hiçbir şeyi değiştirmez. 409 yanıtının gövdesi şöyledir:
{ "type": "https://tools.ietf.org/html/rfc9110#section-15.5.10", "title": "A task with this title already exists.", "status": 409, "traceId": "..." }Dene: “Çalıştır” düğmesine bas ve { "title": "book the MEETING room" } değerini /api/tasks adresine POST et: görev 2 bu başlığa sahip olduğundan 409 döner. { "title": "Book the Meeting Room", "done": false } değerini /api/tasks/2 adresine PUT et: kendi başlığı olduğundan 200 döner. /api/tasks/3 adresine { "title": "Write the project brief" } ile PATCH et: 409 döner. { "title": "Order new chairs" } değerini POST et: id değeri 4 olan 201 yanıtı döner.
Kendin dene
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);