Mengapa metode PATCH tidak idempoten?

Saya bertanya-tanya tentang ini.

Misalkan saya memiliki usersumber daya iddan namebidang. Jika saya ingin memperbarui bidang, saya bisa melakukan permintaan PATCH ke sumber daya seperti ini

PATCH /users/42
{"name": "john doe"} 

Dan kemudian aplikasi akan memperbarui nama pengguna 42.

Tetapi mengapa jika saya mengulangi permintaan ini hasilnya akan berbeda?

Menurut RFC 5789

PATCH tidak aman atau idempoten

Permintaan PATCH bisa saja idempoten, tetapi tidak harus begitu. Itulah alasan mengapa ini dicirikan sebagai non-idempoten.

Apakah PATCH dapat menjadi idempoten atau tidak sangat bergantung pada bagaimana perubahan yang diperlukan dikomunikasikan.
Misalnya, jika format tambalan dalam bentuk {change: 'Name' from: 'benjamin franklin' to: 'john doe'}, maka setiap permintaan PATCH setelah yang pertama akan memiliki efek yang berbeda (respons kegagalan) dari permintaan pertama.
Alasan lain untuk non-idempotensi adalah penerapan modifikasi pada hal lain selain sumber daya asli dapat menjadikan sumber daya tidak valid. Ini juga akan menjadi masalah jika Anda menerapkan perubahan beberapa kali.

Saya pikir jawaban yang jelas ketika PATCH dalam tidak idempoten adalah paragraf ini dari RFC 5789:

Ada juga kasus di mana format tambalan tidak perlu beroperasi dari titik dasar yang diketahui (misalnya, menambahkan baris teks ke file log, atau baris yang tidak bertabrakan ke tabel database), dalam hal ini tidak diperlukan perawatan yang sama dalam permintaan klien. .

Karena RFC menentukan bahwa tambalan berisi beberapa "perubahan umum" pada sumber daya, kita harus melihat lebih dari sekadar penggantian bidang biasa. Jika sumber daya untuk penghitung, maka tambalan dapat meminta peningkatannya, yang jelas bukan idempotet.

PATCHpermintaan menguraikan serangkaian operasi untuk diterapkan pada sumber daya, jika Anda menerapkan rangkaian operasi yang sama dua kali pada sumber daya yang sama, hasilnya mungkin tidak sama. Ini karena mendefinisikan operasi terserah Anda. Dengan kata lain Anda harus mendefinisikan aturan penggabungan .

Ingatlah bahwa PATCHpermintaan dapat digunakan untuk menambal sumber daya dalam berbagai format, bukan hanya JSON.

Jadi PATCHpermintaan bisa menjadi idempoten jika Anda mendefinisikan aturan penggabungan menjadi idempoten .

Contoh idempoten:

// Original resource
{
  name: 'Tito',
  age: 32
}

// PATCH request
{
  age: 33
}

// New resource
{
  name: 'Tito',
  age: 33
}

Contoh non-idempoten:

// Original resource
{
  name: 'Tito',
  age: 32
}

// PATCH request
{
  $increment: 'age'
}

// New resource
{
  name: 'Tito',
  age: 33
}

Dalam contoh kedua saya menggunakan sintaksis "Mongo like" yang saya buat untuk menambah atribut. Jelas ini bukan idempoten, karena mengirimkan permintaan yang sama beberapa kali akan menghasilkan hasil yang berbeda setiap kali.

Sekarang Anda mungkin bertanya-tanya apakah menggunakan sintaks yang dibuat seperti itu valid. Menurut standar , itu adalah:

Perbedaan antara permintaan PUT dan PATCH tercermin dalam cara server memproses entitas terlampir untuk memodifikasi sumber daya yang diidentifikasi oleh Request-URI. Dalam permintaan PUT, entitas terlampir dianggap sebagai versi modifikasi dari sumber daya yang disimpan di server asal, dan klien meminta agar versi yang disimpan diganti. Dengan PATCH, bagaimanapun, entitas terlampir berisi serangkaian instruksi yang menggambarkan bagaimana sumber daya yang saat ini berada di server asal harus dimodifikasi untuk menghasilkan versi baru.

Dan Anda mungkin juga bertanya-tanya apakah itu tenang untuk menggunakan PATCHpermintaan dengan cara ini, dan banyak orang menganggapnya tidak, inilah jawaban yang baik dengan banyak komentar tentang masalah ini.