1
0
mirror of https://github.com/astaxie/beego.git synced 2024-11-16 05:40:54 +00:00
Beego/cache/cache.go

65 lines
1.8 KiB
Go
Raw Normal View History

2013-04-22 10:56:30 +00:00
package cache
import (
"fmt"
)
2013-12-22 05:35:02 +00:00
// 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 := 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)
2013-04-22 10:56:30 +00:00
type Cache interface {
2013-12-22 05:35:02 +00:00
// get cached value by key.
2013-04-22 10:56:30 +00:00
Get(key string) interface{}
2013-12-22 05:35:02 +00:00
// set cached value with key and expire time.
Put(key string, val interface{}, timeout int64) error
2013-12-22 05:35:02 +00:00
// delete cached value by key.
2013-04-22 10:56:30 +00:00
Delete(key string) error
2013-12-22 05:35:02 +00:00
// increase cached int value by key, as a counter.
2013-07-16 11:05:44 +00:00
Incr(key string) error
2013-12-22 05:35:02 +00:00
// decrease cached int value by key, as a counter.
2013-07-16 11:05:44 +00:00
Decr(key string) error
2013-12-22 05:35:02 +00:00
// check cached value is existed or not.
2013-04-22 10:56:30 +00:00
IsExist(key string) bool
2013-12-22 05:35:02 +00:00
// clear all cache.
2013-04-22 10:56:30 +00:00
ClearAll() error
2013-12-22 05:35:02 +00:00
// start gc routine via config string setting.
2013-04-22 10:56:30 +00:00
StartAndGC(config string) error
}
var adapters = make(map[string]Cache)
// Register makes a cache adapter available by the adapter name.
// If Register is called twice with the same name or if driver is nil,
// it panics.
func Register(name string, adapter Cache) {
if adapter == nil {
panic("cache: Register adapter is nil")
}
if _, dup := adapters[name]; dup {
panic("cache: Register called twice for adapter " + name)
}
adapters[name] = adapter
}
2013-12-22 05:35:02 +00:00
// Create a new cache driver by adapter and config string.
// config need to be correct JSON as string: {"interval":360}.
// it will start gc automatically.
2013-04-22 10:56:30 +00:00
func NewCache(adapterName, config string) (Cache, error) {
adapter, ok := adapters[adapterName]
if !ok {
return nil, fmt.Errorf("cache: unknown adaptername %q (forgotten import?)", adapterName)
}
err := adapter.StartAndGC(config)
if err != nil {
return nil, err
}
2013-04-22 10:56:30 +00:00
return adapter, nil
}