Referensi ke cache tertentu.
Class ini memungkinkan Anda menyisipkan, mengambil, dan menghapus item dari cache. Dapat berupa sangat berguna ketika Anda menginginkan akses yang sering ke sumber daya yang mahal atau lambat. Misalnya, misalkan Anda memiliki feed RSS di example.com yang memerlukan waktu 20 detik untuk diambil, tetapi Anda ingin mempercepat akses berdasarkan rata-rata permintaan.
function getRssFeed() { var cache = CacheService.getScriptCache(); var cached = cache.get("rss-feed-contents"); if (cached != null) { return cached; } var result = UrlFetchApp.fetch("http://example.com/my-slow-rss-feed.xml"); // takes 20 seconds var contents = result.getContentText(); cache.put("rss-feed-contents", contents, 1500); // cache for 25 minutes return contents; }
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
get(key) | String | Mendapatkan nilai yang di-cache untuk kunci yang diberikan, atau null jika tidak ada yang ditemukan. |
getAll(keys) | Object | Mengembalikan Objek JavaScript yang berisi semua pasangan kunci/nilai yang ditemukan di cache untuk larik tombol. |
put(key, value) | void | Menambahkan key-value pair ke cache. |
put(key, value, expirationInSeconds) | void | Menambahkan key-value pair ke cache dengan waktu habis masa berlaku (dalam detik). |
putAll(values) | void | Menambahkan satu set key-value pair ke cache. |
putAll(values, expirationInSeconds) | void | Menambahkan kumpulan key-value pair ke cache dengan waktu habis masa berlaku (dalam detik). |
remove(key) | void | Menghapus entri dari cache menggunakan kunci yang diberikan. |
removeAll(keys) | void | Menghapus sekumpulan entri dari cache. |
Dokumentasi mendetail
get(key)
Mendapatkan nilai yang di-cache untuk kunci yang diberikan, atau null jika tidak ada yang ditemukan.
// Gets the value from the cache for the key 'foo'. var value = cache.get('foo');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | kunci yang dicari di cache |
Pulang pergi
String
— nilai yang di-cache, atau null jika tidak ada yang ditemukan
getAll(keys)
Mengembalikan Objek JavaScript yang berisi semua pasangan kunci/nilai yang ditemukan di cache untuk larik tombol.
// Gets a set of values from the cache var values = cache.getAll(['foo', 'x', 'missing']); // If there were values in the cache for 'foo' and 'x' but not 'missing', then 'values' would // be: {'foo': 'somevalue', 'x': 'othervalue'}
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
keys | String[] | tombol untuk mencari |
Pulang pergi
Object
— Objek JavaScript yang berisi key-value pair untuk semua kunci yang ditemukan dalam cache
Lihat juga
put(key, value)
Menambahkan key-value pair ke cache.
Panjang maksimum kunci adalah 250 karakter. Jumlah maksimum data yang dapat disimpan per kunci adalah 100 KB. Nilai akan kedaluwarsa dari cache setelah 600 detik (10 menit).
Batas untuk item yang di-cache adalah 1.000. Jika lebih dari 1.000 item ditulis, cache akan menyimpan 900 item yang terjauh dari masa kedaluwarsanya. Batas ini mungkin berubah.
// Puts the value 'bar' into the cache using the key 'foo' cache.put('foo', 'bar');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | kunci untuk menyimpan nilai di bawah |
value | String | nilai yang akan di-cache |
put(key, value, expirationInSeconds)
Menambahkan key-value pair ke cache dengan waktu habis masa berlaku (dalam detik).
Panjang maksimum kunci adalah 250 karakter. Jumlah maksimum data yang dapat disimpan per kunci adalah 100 KB. Waktu habis masa berlaku yang ditentukan hanyalah saran; data yang di-cache dapat jika banyak data di {i>cache<i} disimpan sebelum waktu tersebut.
Batas untuk item yang di-cache adalah 1.000. Jika lebih dari 1.000 item ditulis, cache akan menyimpan 900 item yang terjauh dari masa kedaluwarsanya. Batas ini mungkin berubah.
// Puts the value 'bar' into the cache using the key 'foo', but only for the next 20 seconds. cache.put('foo', 'bar', 20);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | kunci untuk menyimpan nilai di bawah |
value | String | nilai yang akan di-cache |
expirationInSeconds | Integer | waktu maksimum nilai tetap berada di {i>cache<i}, dalam detik. Tujuan durasi minimum adalah 1 detik dan maksimumnya adalah 21600 detik (6 jam). |
putAll(values)
Menambahkan satu set key-value pair ke cache.
Mirip dengan panggilan berulang untuk "put", tetapi lebih efisien karena hanya melakukan satu panggilan ke server memcache untuk mengatur semua nilai. Panjang maksimum kunci adalah 250 karakter. Maksimum jumlah data yang dapat disimpan per kunci adalah 100 KB. Nilai akan kedaluwarsa dari cache setelah 600 detik (10 menit).
Batas untuk item yang di-cache adalah 1.000. Jika lebih dari 1.000 item ditulis, cache akan menyimpan 900 item yang terjauh dari masa kedaluwarsanya. Batas ini mungkin berubah.
// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'. var values = { 'foo': 'bar', 'x':'y', 'key': 'value' }; cache.putAll(values);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
values | Object | Objek JavaScript yang berisi kunci dan nilai string |
Lihat juga
putAll(values, expirationInSeconds)
Menambahkan kumpulan key-value pair ke cache dengan waktu habis masa berlaku (dalam detik).
Mirip dengan panggilan berulang untuk "put", tetapi lebih efisien karena hanya melakukan satu panggilan ke server memcache untuk mengatur semua nilai. Panjang maksimum kunci adalah 250 karakter. Maksimum jumlah data yang dapat disimpan per kunci adalah 100 KB. Waktu kedaluwarsa yang ditentukan hanya saran; data yang di-{i>cache<i} dapat dihapus sebelum waktu tersebut jika banyak data yang di-cache.
Batas untuk item yang di-cache adalah 1.000. Jika lebih dari 1.000 item ditulis, cache akan menyimpan 900 item yang terjauh dari masa kedaluwarsanya. Batas ini mungkin berubah.
// Puts a set of values into the cache with the keys 'foo', 'x', and 'key'. var values = { 'foo': 'bar', 'x':'y', 'key': 'value' }; cache.putAll(values, 20);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
values | Object | Objek JavaScript yang berisi kunci dan nilai string |
expirationInSeconds | Integer | Waktu maksimum nilai tetap berada dalam cache, dalam detik masa berlaku minimum yang diizinkan adalah 1 detik, dan masa berlaku maksimum yang diizinkan adalah 21.600 detik (6 jam). Masa berlaku default adalah 600 detik (10 menit). |
Lihat juga
remove(key)
Menghapus entri dari cache menggunakan kunci yang diberikan.
// Removes any cache entries for 'foo' cache.remove('foo');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | kunci untuk dihapus dari cache |
removeAll(keys)
Menghapus sekumpulan entri dari cache.
// Removes entries from the cache with keys 'foo' and 'x' cache.removeAll(['foo', 'x']);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
keys | String[] | array kunci yang akan dihapus |