Class Cache

מטמון

הפניה למטמון מסוים.

הכיתה הזו מאפשרת להוסיף, לאחזר ולהסיר פריטים מהמטמון. סוג הפריט יכול להיות שימושי במיוחד כשרוצים לגשת בתדירות גבוהה למשאב יקר או איטי. לדוגמה, נניח שיש לכם פיד RSS ב-example.com שהאחזור שלו נמשך 20 שניות, אבל אתם רוצים להאיץ גישה לפי בקשה ממוצעת.

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

עדיין צריך להמתין 20 שניות אם הפריט לא נמצא במטמון, אבל מבצעים שיחות נוספות יהיה מהיר מאוד עד שהפריט יפוג מהמטמון תוך 25 דקות.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
get(key)	String	הפונקציה מקבלת את הערך שנשמר במטמון של מפתח מסוים, או את הערך null אם לא נמצא אף מפתח.
getAll(keys)	Object	מחזירה אובייקט JavaScript שמכיל את כל צמדי המפתח/ערך שנמצאים במטמון עבור מערך של מקשי קיצור.
put(key, value)	void	הפונקציה מוסיפה צמד מפתח/ערך למטמון.
put(key, value, expirationInSeconds)	void	מוסיף צמד מפתח/ערך למטמון, עם זמן תפוגה (בשניות).
putAll(values)	void	הפונקציה מוסיפה למטמון קבוצה של צמדי מפתח/ערך.
putAll(values, expirationInSeconds)	void	הפונקציה מוסיפה למטמון קבוצה של צמדי מפתח/ערך עם זמן תפוגה (בשניות).
remove(key)	void	מסירה רשומה מהמטמון באמצעות המפתח הנתון.
removeAll(keys)	void	מסיר קבוצה של רשומות מהמטמון.

מסמכי תיעוד מפורטים

get(key)

הפונקציה מקבלת את הערך שנשמר במטמון של מפתח מסוים, או את הערך null אם לא נמצא אף מפתח.

// Gets the value from the cache for the key 'foo'.
var value = cache.get('foo');

פרמטרים

שם	סוג	תיאור
key	String	המפתח לחיפוש במטמון

חזרה

String – הערך שנשמר במטמון, או null אם לא נמצא אף ערך.

---

getAll(keys)

מחזירה אובייקט JavaScript שמכיל את כל צמדי המפתח/ערך שנמצאים במטמון עבור מערך של מקשי קיצור.

// 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'}

פרמטרים

שם	סוג	תיאור
keys	String[]	המפתחות לחיפוש

חזרה

Object – אובייקט JavaScript שמכיל את צמדי המפתח/ערך של כל המפתחות שנמצאים במטמון

ראה גם

• get(key)

---

put(key, value)

הפונקציה מוסיפה צמד מפתח/ערך למטמון.

האורך המקסימלי של מפתח הוא 250 תווים. כמות הנתונים המקסימלית שאפשר לאחסן לכל מפתח הוא 100KB. הערך יפוג מהמטמון אחרי 600 שניות (10 דקות).

המגבלה לפריטים שנשמרו במטמון היא 1,000. אם נכתבים יותר מ-1,000 פריטים, המטמון נשמר את 900 הפריטים הכי רחוקים מתאריך התפוגה. המגבלה הזו עשויה להשתנות.

// Puts the value 'bar' into the cache using the key 'foo'
cache.put('foo', 'bar');

פרמטרים

שם	סוג	תיאור
key	String	המפתח לשמירת הערך שמתחתיו
value	String	הערך שיישמר במטמון

---

put(key, value, expirationInSeconds)

מוסיף צמד מפתח/ערך למטמון, עם זמן תפוגה (בשניות).

האורך המקסימלי של מפתח הוא 250 תווים. כמות הנתונים המקסימלית שאפשר לאחסן לכל מפתח הוא 100KB. מועד התפוגה שצוין הוא הצעה בלבד. ייתכן שהנתונים שנשמרו במטמון יוסרו לפני פרק הזמן הזה, אם הרבה נתונים נשמרים במטמון.

המגבלה לפריטים שנשמרו במטמון היא 1,000. אם נכתבים יותר מ-1,000 פריטים, המטמון נשמר את 900 הפריטים הכי רחוקים מתאריך התפוגה. המגבלה הזו עשויה להשתנות.

// Puts the value 'bar' into the cache using the key 'foo', but only for the next 20 seconds.
cache.put('foo', 'bar', 20);

פרמטרים

שם	סוג	תיאור
key	String	המפתח לשמירת הערך שמתחתיו
value	String	הערך שיישמר במטמון
expirationInSeconds	Integer	הזמן המקסימלי שבו הערך יישאר במטמון, בשניות. המינימום הוא שנייה אחת והמקסימלי הוא 21,600 שניות (6 שעות).

---

putAll(values)

הפונקציה מוסיפה למטמון קבוצה של צמדי מפתח/ערך.

דומה לקריאות חוזרות ל-"put", אבל יעילה יותר כי היא מבצעת רק קריאה אחת שרת memcache להגדרת כל הערכים. האורך המקסימלי של מפתח הוא 250 תווים. הערך המקסימלי כמות הנתונים שאפשר לאחסן לכל מפתח היא 100KB. תוקף הערכים יפוג מהמטמון אחרי 600 שניות (10 דקות).

המגבלה לפריטים שנשמרו במטמון היא 1,000. אם נכתבים יותר מ-1,000 פריטים, המטמון נשמר את 900 הפריטים הכי רחוקים מתאריך התפוגה. המגבלה הזו עשויה להשתנות.

// 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);

פרמטרים

שם	סוג	תיאור
values	Object	אובייקט JavaScript שמכיל מפתחות וערכים של מחרוזות

ראה גם

• put(key, value)

---

putAll(values, expirationInSeconds)

הפונקציה מוסיפה למטמון קבוצה של צמדי מפתח/ערך עם זמן תפוגה (בשניות).

דומה לקריאות חוזרות ל-"put", אבל יעילה יותר כי היא מבצעת רק קריאה אחת שרת memcache להגדרת כל הערכים. האורך המקסימלי של מפתח הוא 250 תווים. הערך המקסימלי כמות הנתונים שאפשר לאחסן לכל מפתח היא 100KB. זמן התפוגה שצוין הוא רק הצעה; ייתכן שהנתונים שנשמרו במטמון יוסרו לפני המועד הזה, אם הרבה נתונים יישמרו במטמון.

המגבלה לפריטים שנשמרו במטמון היא 1,000. אם נכתבים יותר מ-1,000 פריטים, המטמון נשמר את 900 הפריטים הכי רחוקים מתאריך התפוגה. המגבלה הזו עשויה להשתנות.

// 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);

פרמטרים

שם	סוג	תיאור
values	Object	אובייקט JavaScript שמכיל מפתחות וערכים של מחרוזות
expirationInSeconds	Integer	הזמן המקסימלי שבו הערך יישאר במטמון, בשניות. זמן התפוגה המינימלי המותר הוא שנייה אחת, והתפוגה המקסימלית המותרת היא 21,600 שניות (6 שעות). תפוגת ברירת המחדל היא 600 שניות (10 דקות).

ראה גם

• put(key, value)

---

remove(key)

מסירה רשומה מהמטמון באמצעות המפתח הנתון.

// Removes any cache entries for 'foo'
cache.remove('foo');

פרמטרים

שם	סוג	תיאור
key	String	את המפתח שצריך להסיר מהמטמון

---

removeAll(keys)

מסיר קבוצה של רשומות מהמטמון.

// Removes entries from the cache with keys 'foo' and 'x'
cache.removeAll(['foo', 'x']);

פרמטרים

שם	סוג	תיאור
keys	String[]	מערך המפתחות להסרה