Menu
CoddyTech

PATCH ile Kısmi Güncellemeler

Coddy'nin ASP.NET Core Journey'sinin REST API'leri bölümünün bir parçası. Ders 4 / 20.

PATCH yalnızca gövdenin gönderdiği alanları değiştirir. Gönderilmeyen bir alanı değeri ayarlanmış bir alandan ayırt etmek için yama kaydının her özelliğini null atanabilir yapın: eksik bir alan null değerine bağlanır.

record ProfilePatch(string? Name, string? City);

profiles[index] = profile with
{
    Name = patch.Name ?? profile.Name,
    City = patch.City ?? profile.City,
};

with bir kaydı kopyalar ve listelediğiniz özellikleri değiştirir. ??, yama null içerdiğinde eski değeri korur. bool? da aynı şekilde çalışır: false, istemcinin gönderdiği bir değerdir ve null hiçbir şey göndermediği anlamına gelir. Yani { "city": "Lyon" } profili taşır ve adını korur.

challenge icon

Görev

Kolay

İstemcilerin, başlığı yeniden göndermeden bir görevin tamamlandığını işaretlemek gibi, görevin tek bir alanını değiştirmesine izin verin.

  1. Program.cs dosyasının en altına record TaskPatch(string? Title, bool? Done); bildirimini ekleyin.
  2. PATCH /api/tasks/{id:int} için int id ve TaskPatch patch parametreleriyle eşleme yapın. Bu kimliğe sahip bir görev yoksa Results.NotFound() yanıtını verin.
  3. Aksi takdirde, görevin with kullanılarak oluşturulmuş bir kopyasını kaydedin; her özellik yama değerini almalı, yama değeri null ise görevin kendi değerini korumalıdır. Değiştirilen görevi Results.Ok ile yanıtlayın.

{ "done": true } ile PATCH /api/tasks/1 isteği 200 yanıtını ve şunu verir:

{ "id": 1, "title": "Write the project brief", "done": true }

Deneyin: Çalıştır'a basın, PATCH'i seçin, yol olarak /api/tasks/1, gövde olarak { "done": true } girin ve Gönder'e basın: başlık korunarak yukarıdaki yanıtı alırsınız. { "title": "Book the big room" } ile /api/tasks/2 adresine PATCH isteği gönderin: yeni başlığı alırsınız ve "done": true aynı kalır. /api/tasks/99 adresine PATCH isteği 404 yanıtı verir.

Kendin dene

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

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 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 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.Run();

record TaskItem(int Id, string Title, bool Done);
record TaskInput(string Title, bool Done);
quiz iconKendini test et

Bu ders kısa bir quiz içerir. Soruları yanıtlamak ve ilerlemeni kaydetmek için derse başla.

REST API'leri bölümündeki tüm dersler