// Copyright 2014 beego Author. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package redis for cache provider // // depend on github.com/gomodule/redigo/redis // // go install github.com/gomodule/redigo/redis // // Usage: // import( // _ "github.com/astaxie/beego/cache/redis" // "github.com/astaxie/beego/cache" // ) // // bm, err := cache.NewCache("redis", `{"conn":"127.0.0.1:11211"}`) // // more docs http://beego.me/docs/module/cache.md package redis import ( "encoding/json" "errors" "fmt" "strconv" "strings" "time" "github.com/gomodule/redigo/redis" "github.com/astaxie/beego/pkg/cache" ) var ( // The collection name of redis for the cache adapter. DefaultKey = "beecacheRedis" ) // Cache is Redis cache adapter. type Cache struct { p *redis.Pool // redis connection pool conninfo string dbNum int key string password string maxIdle int // Timeout value (less than the redis server's timeout value) timeout time.Duration } // NewRedisCache creates a new redis cache with default collection name. func NewRedisCache() cache.Cache { return &Cache{key: DefaultKey} } // Execute the redis commands. args[0] must be the key name func (rc *Cache) do(commandName string, args ...interface{}) (reply interface{}, err error) { if len(args) < 1 { return nil, errors.New("missing required arguments") } args[0] = rc.associate(args[0]) c := rc.p.Get() defer c.Close() return c.Do(commandName, args...) } // associate with config key. func (rc *Cache) associate(originKey interface{}) string { return fmt.Sprintf("%s:%s", rc.key, originKey) } // Get cache from redis. func (rc *Cache) Get(key string) interface{} { if v, err := rc.do("GET", key); err == nil { return v } return nil } // GetMulti gets cache from redis. func (rc *Cache) GetMulti(keys []string) []interface{} { c := rc.p.Get() defer c.Close() var args []interface{} for _, key := range keys { args = append(args, rc.associate(key)) } values, err := redis.Values(c.Do("MGET", args...)) if err != nil { return nil } return values } // Put puts cache into redis. func (rc *Cache) Put(key string, val interface{}, timeout time.Duration) error { _, err := rc.do("SETEX", key, int64(timeout/time.Second), val) return err } // Delete deletes a key's cache in redis. func (rc *Cache) Delete(key string) error { _, err := rc.do("DEL", key) return err } // IsExist checks cache's existence in redis. func (rc *Cache) IsExist(key string) bool { v, err := redis.Bool(rc.do("EXISTS", key)) if err != nil { return false } return v } // Incr increases a key's counter in redis. func (rc *Cache) Incr(key string) error { _, err := redis.Bool(rc.do("INCRBY", key, 1)) return err } // Decr decreases a key's counter in redis. func (rc *Cache) Decr(key string) error { _, err := redis.Bool(rc.do("INCRBY", key, -1)) return err } // ClearAll deletes all cache in the redis collection func (rc *Cache) ClearAll() error { cachedKeys, err := rc.Scan(rc.key + ":*") if err != nil { return err } c := rc.p.Get() defer c.Close() for _, str := range cachedKeys { if _, err = c.Do("DEL", str); err != nil { return err } } return err } // Scan scans all keys matching a given pattern. func (rc *Cache) Scan(pattern string) (keys []string, err error) { c := rc.p.Get() defer c.Close() var ( cursor uint64 = 0 // start result []interface{} list []string ) for { result, err = redis.Values(c.Do("SCAN", cursor, "MATCH", pattern, "COUNT", 1024)) if err != nil { return } list, err = redis.Strings(result[1], nil) if err != nil { return } keys = append(keys, list...) cursor, err = redis.Uint64(result[0], nil) if err != nil { return } if cursor == 0 { // over return } } } // StartAndGC starts the redis cache adapter. // config: must be in this format {"key":"collection key","conn":"connection info","dbNum":"0"} // Cached items in redis are stored forever, no garbage collection happens func (rc *Cache) StartAndGC(config string) error { var cf map[string]string json.Unmarshal([]byte(config), &cf) if _, ok := cf["key"]; !ok { cf["key"] = DefaultKey } if _, ok := cf["conn"]; !ok { return errors.New("config has no conn key") } // Format redis://@: cf["conn"] = strings.Replace(cf["conn"], "redis://", "", 1) if i := strings.Index(cf["conn"], "@"); i > -1 { cf["password"] = cf["conn"][0:i] cf["conn"] = cf["conn"][i+1:] } if _, ok := cf["dbNum"]; !ok { cf["dbNum"] = "0" } if _, ok := cf["password"]; !ok { cf["password"] = "" } if _, ok := cf["maxIdle"]; !ok { cf["maxIdle"] = "3" } if _, ok := cf["timeout"]; !ok { cf["timeout"] = "180s" } rc.key = cf["key"] rc.conninfo = cf["conn"] rc.dbNum, _ = strconv.Atoi(cf["dbNum"]) rc.password = cf["password"] rc.maxIdle, _ = strconv.Atoi(cf["maxIdle"]) if v, err := time.ParseDuration(cf["timeout"]); err == nil { rc.timeout = v } else { rc.timeout = 180 * time.Second } rc.connectInit() c := rc.p.Get() defer c.Close() return c.Err() } // connect to redis. func (rc *Cache) connectInit() { dialFunc := func() (c redis.Conn, err error) { c, err = redis.Dial("tcp", rc.conninfo) if err != nil { return nil, err } if rc.password != "" { if _, err := c.Do("AUTH", rc.password); err != nil { c.Close() return nil, err } } _, selecterr := c.Do("SELECT", rc.dbNum) if selecterr != nil { c.Close() return nil, selecterr } return } // initialize a new pool rc.p = &redis.Pool{ MaxIdle: rc.maxIdle, IdleTimeout: rc.timeout, Dial: dialFunc, } } func init() { cache.Register("redis", NewRedisCache) }