Documentation
¶
Overview ¶
Usage:
import(
"github.com/astaxie/beego/cache"
)
bm, err := cache.NewCache("memory", `{"interval":60}`)
Use it like this:
bm.Put("astaxie", 1, 10) bm.Get("astaxie") bm.IsExist("astaxie") bm.Delete("astaxie") more docs http://beego.me/docs/module/cache.md
Index ¶
- Variables
- func File_get_contents(filename string) (data []byte, e error)
- func File_put_contents(filename string, content []byte) error
- func GetBool(v interface{}) bool
- func GetFloat64(v interface{}) float64
- func GetInt(v interface{}) int
- func GetInt64(v interface{}) int64
- func GetString(v interface{}) string
- func Gob_decode(data []byte, to *FileCacheItem) error
- func Gob_encode(data interface{}) ([]byte, error)
- func Register(name string, adapter Cache)
- type Cache
- type FileCache
- func (fc *FileCache) ClearAll() error
- func (fc *FileCache) Decr(key string) error
- func (fc *FileCache) Delete(key string) error
- func (fc *FileCache) Get(key string) interface{}
- func (fc *FileCache) GetMulti(keys []string) []interface{}
- func (fc *FileCache) Incr(key string) error
- func (fc *FileCache) Init()
- func (fc *FileCache) IsExist(key string) bool
- func (fc *FileCache) Put(key string, val interface{}, timeout int64) error
- func (fc *FileCache) StartAndGC(config string) error
- type FileCacheItem
- type MemoryCache
- func (bc *MemoryCache) ClearAll() error
- func (bc *MemoryCache) Decr(key string) error
- func (bc *MemoryCache) Delete(name string) error
- func (bc *MemoryCache) Get(name string) interface{}
- func (bc *MemoryCache) GetMulti(names []string) []interface{}
- func (bc *MemoryCache) Incr(key string) error
- func (bc *MemoryCache) IsExist(name string) bool
- func (bc *MemoryCache) Put(name string, value interface{}, expired int64) error
- func (bc *MemoryCache) StartAndGC(config string) error
- type MemoryItem
Constants ¶
This section is empty.
Variables ¶
var ( FileCachePath string = "cache" // cache directory FileCacheFileSuffix string = ".bin" // cache file suffix FileCacheDirectoryLevel int = 2 // cache file deep level if auto generated cache files. FileCacheEmbedExpiry int64 = 0 // cache expire time, default is no expire forever. )
var ( // clock time of recycling the expired cache items in memory. DefaultEvery int = 60 // 1 minute )
Functions ¶
func File_get_contents ¶
Get bytes to file. if non-exist, create this file.
func File_put_contents ¶
Put bytes to file. if non-exist, create this file.
func Gob_decode ¶
func Gob_decode(data []byte, to *FileCacheItem) error
Gob decodes file cache item.
Types ¶
type Cache ¶
type Cache interface { // get cached value by key. Get(key string) interface{} // GetMulti is a batch version of Get. GetMulti(keys []string) []interface{} // set cached value with key and expire time. Put(key string, val interface{}, timeout int64) error // delete cached value by key. Delete(key string) error // increase cached int value by key, as a counter. Incr(key string) error // decrease cached int value by key, as a counter. Decr(key string) error // check if cached value exists or not. IsExist(key string) bool // clear all cache. ClearAll() error // start gc routine based on config string settings. StartAndGC(config string) error }
Cache interface contains all behaviors for cache adapter. usage:
cache.Register("file",cache.NewFileCache()) // this operation is run in init method of file.go. c,err := cache.NewCache("file","{....}") c.Put("key",value,3600) v := c.Get("key") c.Incr("counter") // now is 1 c.Incr("counter") // now is 2 count := c.Get("counter").(int)
type FileCache ¶
FileCache is cache adapter for file storage.
func NewFileCache ¶
func NewFileCache() *FileCache
Create new file cache with no config. the level and expiry need set in method StartAndGC as config string.
func (*FileCache) GetMulti ¶ added in v1.5.0
GetMulti gets values from file cache. if non-exist or expired, return empty string.
func (*FileCache) Init ¶
func (fc *FileCache) Init()
Init will make new dir for file cache if not exist.
func (*FileCache) Put ¶
Put value into file cache. timeout means how long to keep this file, unit of ms. if timeout equals FileCacheEmbedExpiry(default is 0), cache this item forever.
func (*FileCache) StartAndGC ¶
Start and begin gc for file cache. the config need to be like {CachePath:"/cache","FileSuffix":".bin","DirectoryLevel":2,"EmbedExpiry":0}
type FileCacheItem ¶
FileCacheItem is basic unit of file cache adapter. it contains data and expire time.
type MemoryCache ¶
type MemoryCache struct { Every int // run an expiration check Every clock time // contains filtered or unexported fields }
Memory cache adapter. it contains a RW locker for safe map storage.
func (*MemoryCache) Decr ¶
func (bc *MemoryCache) Decr(key string) error
Decrease counter in memory.
func (*MemoryCache) Delete ¶
func (bc *MemoryCache) Delete(name string) error
/ Delete cache in memory.
func (*MemoryCache) Get ¶
func (bc *MemoryCache) Get(name string) interface{}
Get cache from memory. if non-existed or expired, return nil.
func (*MemoryCache) GetMulti ¶ added in v1.5.0
func (bc *MemoryCache) GetMulti(names []string) []interface{}
GetMulti gets caches from memory. if non-existed or expired, return nil.
func (*MemoryCache) Incr ¶
func (bc *MemoryCache) Incr(key string) error
Increase cache counter in memory. it supports int,int64,int32,uint,uint64,uint32.
func (*MemoryCache) IsExist ¶
func (bc *MemoryCache) IsExist(name string) bool
check cache exist in memory.
func (*MemoryCache) Put ¶
func (bc *MemoryCache) Put(name string, value interface{}, expired int64) error
Put cache to memory. if expired is 0, it will be cleaned by next gc operation ( default gc clock is 1 minute).
func (*MemoryCache) StartAndGC ¶
func (bc *MemoryCache) StartAndGC(config string) error
start memory cache. it will check expiration in every clock time.
type MemoryItem ¶
Memory cache item.