Halaman ini diterjemahkan oleh Cloud Translation API.

Class Cache

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;
}

Anda masih harus menunggu 20 detik jika item tidak ada dalam cache, tetapi panggilan berikutnya akan berjalan sangat cepat hingga item kedaluwarsa dari cache dalam 25 menit.

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

get(key)

`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

put(key, value)

`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

put(key, value)

`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