Cache API memungkinkan Anda menyimpan data dalam cache pada edge node untuk mempercepat respons terhadap permintaan berikutnya. Anda dapat mengonfigurasi durasi dan ukuran cache guna mengatur kebijakan caching.
Cara kerja
Cache API bawaan Edge Routines (ER) menyimpan data yang diproses oleh ER atau diambil dari origin server ke ESA agar dapat digunakan kembali oleh permintaan lain pada node yang sama. Hal ini mengurangi komputasi berulang dan permintaan jaringan. Gambar berikut menunjukkan hubungan antara ER dan cache ESA:
Standar API
Cache API sebisa mungkin mematuhi antarmuka Cache standar. Namun, karena Edge Routines menggunakan kembali mesin cache yang ada di ESA, semantiknya tidak sepenuhnya konsisten.
Definisi API
cache.put(request/string, response)
-
Menyimpan objek Response ke dalam Cache.
-
Jika operasi put berhasil, fungsi akan mengembalikan undefined.
-
Jika mesin Cache gagal, operasi akan ditolak dengan pengecualian error.
-
Jika kuota mesin Cache terlampaui, operasi akan ditolak dengan pengecualian error.
-
-
Kunci cache diatur berdasarkan URL dari objek request atau string URL. Gunakan URL HTTP karena mesin Cache ESA saat ini tidak mendukung URL HTTPS.
-
Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi put selesai.
-
Anda dapat mengatur header cache-control pada objek Response untuk mengonfigurasi TTL cache (header cache-control mengikuti standar cache).
cache.get(request/string)
-
Mengambil objek Response menggunakan request/string yang ditentukan sebagai kunci. Jika objek tidak ada, fungsi akan mengembalikan undefined.
-
Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi get selesai.
-
Fungsi get mungkin tidak mengembalikan objek yang baru saja disimpan melalui put karena cache menggunakan algoritma LRU dan tidak menjamin bahwa objek yang di-cache selalu dapat diambil.
cache.delete(request/string)
-
Menghapus objek Response dengan kunci yang ditentukan.
-
Jika penghapusan berhasil, fungsi akan mengembalikan true.
-
Jika penghapusan gagal, fungsi akan mengembalikan false.
-
-
Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi delete selesai.
Batas penggunaan
-
Semua operasi Cache API merupakan subrequest yang berbagi batas subrequest ER. Secara default, satu permintaan ER mendukung maksimal 32 subrequest fetch (angka ini dapat berubah saat ER dikomersialkan). Operasi Cache API berbagi batas ini dengan fetch, sehingga jumlah total operasi cache.put, cache.get, cache.delete, dan fetch dalam satu konteks permintaan tidak boleh melebihi 32.
-
Operasi cache.put, cache.get, dan cache.delete memiliki kontrol konkurensi. Untuk URL yang sama, jika satu permintaan sedang melakukan get sementara permintaan lain melakukan delete, operasi tersebut mungkin mengembalikan status pending karena beberapa permintaan konkuren sedang memodifikasi kunci yang sama. Tunggu dan coba lagi jika hal ini terjadi.
CatatanJika cache.put, cache.get, atau cache.delete menolak ke true, hal ini menandakan bahwa operasi tersebut tunduk pada kontrol konkurensi.
Refresh cache
Cache API saat ini tidak mendukung refresh cache aktif. Tentukan durasi cache yang sesuai dengan menggunakan parameter TTL saat memanggil Cache.put().