Memcache API提供了一個基于類的接口,以便和其他Memcache API相兼容。這里Client類由 google.appengine.api.memcache包提供。
1)構造函數
class Client()產生與Memcache服務器租用通信的客戶端。
2)實例方法
構造的Client.實例主要有以下幾種方法?
(1)set(key,value,time=0,min_compress_len=0):該方法用來設置鍵的值,與先前緩存中的內容無關。其中參數key表示要設置的鍵,key可以是字符串或(哈希值,字符串)格式的元組;參數value表示要設置的值;參數time是指可選的過期時間,可以是相對當前時間的秒數(最多1個月),也可以是絕對Unix時間戳的時間;min_compress_len是為了兼容性而忽略的選項。
(2)get(key):該方法用來在Memcache中查找一個鍵。參數key指明要在Memcache中査找的鍵,key可以是字符串或(哈希值,字符串)格式的元組。如果在Memcache中找到鍵,則返回值為該鍵的值,否則返回None。
(3)delete(key,seconds=0):該方法用來從Memcache刪除鍵Q參數key是指要刪除的鍵,可以是字符串或(哈希值,字符串)格式的元組,參數seconds指定刪除的項目對[添加]操作[鎖定]的可選秒數,值可以是從當前時間開始的增量,也可以是絕對Unix時間戳時間,默認情況下值為0。
(4)add(key, value, time=0, min_compress_len=0):該方法用來設置值,但是只在項目沒有處于Memcache時設置。參數key指明要設置的鍵,它可以是字符串或(哈希值,字符串)格式的元組;參數value是指要設置的值;參數time指明可選的過期時間,可以是 相對當前時間的秒數,也可以是絕對Unix時間戳時間;參數min_compress_len是為了兼容性而忽略的選項。
(5)replace(key,value,time=0, min_compressjen=0):該方法用來替換鍵的值。參數key指要設置的鍵,key可以是字符串或(哈希值,字符串)格式的元組;參數value指明要設置的值;參數time是指可選的過期時間,可以是相對當前時間的秒數,也可以是絕對Unix時間戳時間;參數min_compress_len是為了兼容性而忽略的選項。
(6)incr(key,delta=l):該方法可以自動增加鍵的值。在內部,值是無符號64bit整數,同時Memcache不會檢査64bit溢出,如果值過大則會換行。這里的鍵必須已存在于緩存中才能增加值。初始化計數器時可以使用set()進行初始值的設置。參數key是指要增加的鍵,key可以是字符串或(哈希值,字符串)格式的元組;參數delta值作為鍵的增加量的非負整數值(int型或long型),默認值為1。 ^
(7)decr(key,delta=l):該方法可以自動減少鍵的值。內部而言,值是無符號的64bit數,并且Memcache不檢查64bit溢出,若值過大則會換行。初始化計數器時可以使用set()進行初始值設置。參數key指要減少的鍵,key可以是字符串或(哈希值,字符串)格式的元組;參數delta是鍵的減少量的非負整數值(int型或long型),默認值為1。
(8)flush_all():該方法用來刪除Memcache中的所有內容。若成功則返回True,若是RPC或服務器租用錯誤,則返回False。
(9)get_stats():該方法指獲取該應用程序的Memcache統計信息。函數的返回值是將統計信息名映射到相關值的參照表。