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