123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412 |
- // Copyright 2020 gf Author(https://github.com/gogf/gf). All Rights Reserved.
- //
- // This Source Code Form is subject to the terms of the MIT License.
- // If a copy of the MIT was not distributed with this file,
- // You can obtain one at https://github.com/gogf/gf.
- package adapter
- import (
- "context"
- "github.com/gogf/gf/container/gvar"
- "github.com/gogf/gf/database/gredis"
- "github.com/gogf/gf/os/gcache"
- "time"
- )
- // Redis is the gcache adapter implements using Redis server.
- type Redis struct {
- redis *gredis.Redis
- }
- // newAdapterMemory creates and returns a new memory cache object.
- func NewRedis(redis *gredis.Redis) gcache.Adapter {
- return &Redis{
- redis: redis,
- }
- }
- // Set sets cache with <key>-<value> pair, which is expired after <duration>.
- // It does not expire if <duration> == 0.
- // It deletes the <key> if <duration> < 0 or given <value> is nil.
- func (c *Redis) Set(ctx context.Context, key interface{}, value interface{}, duration time.Duration) error {
- var err error
- if value == nil || duration < 0 {
- _, err = c.redis.Ctx(ctx).DoVar("DEL", key)
- } else {
- if duration == 0 {
- _, err = c.redis.Ctx(ctx).DoVar("SET", key, value)
- } else {
- _, err = c.redis.Ctx(ctx).DoVar("SETEX", key, uint64(duration.Seconds()), value)
- }
- }
- return err
- }
- // Update updates the value of <key> without changing its expiration and returns the old value.
- // The returned value <exist> is false if the <key> does not exist in the cache.
- //
- // It deletes the <key> if given <value> is nil.
- // It does nothing if <key> does not exist in the cache.
- func (c *Redis) Update(ctx context.Context, key interface{}, value interface{}) (oldValue interface{}, exist bool, err error) {
- var (
- v *gvar.Var
- oldDuration time.Duration
- )
- // TTL.
- v, err = c.redis.Ctx(ctx).DoVar("TTL", key)
- if err != nil {
- return
- }
- oldDuration = v.Duration()
- if oldDuration == -2 {
- // It does not exist.
- return
- }
- // Check existence.
- v, err = c.redis.Ctx(ctx).DoVar("GET", key)
- if err != nil {
- return
- }
- oldValue = v.Val()
- // DEL.
- if value == nil {
- _, err = c.redis.Ctx(ctx).DoVar("DEL", key)
- if err != nil {
- return
- }
- return
- }
- // Update the value.
- if oldDuration == -1 {
- _, err = c.redis.Ctx(ctx).DoVar("SET", key, value)
- } else {
- oldDuration *= time.Second
- _, err = c.redis.Ctx(ctx).DoVar("SETEX", key, uint64(oldDuration.Seconds()), value)
- }
- return oldValue, true, err
- }
- // UpdateExpire updates the expiration of <key> and returns the old expiration duration value.
- //
- // It returns -1 if the <key> does not exist in the cache.
- // It deletes the <key> if <duration> < 0.
- func (c *Redis) UpdateExpire(ctx context.Context, key interface{}, duration time.Duration) (oldDuration time.Duration, err error) {
- var (
- v *gvar.Var
- )
- // TTL.
- v, err = c.redis.Ctx(ctx).DoVar("TTL", key)
- if err != nil {
- return
- }
- oldDuration = v.Duration()
- if oldDuration == -2 {
- // It does not exist.
- oldDuration = -1
- return
- }
- oldDuration *= time.Second
- // DEL.
- if duration < 0 {
- _, err = c.redis.Ctx(ctx).Do("DEL", key)
- return
- }
- // Update the expire.
- if duration > 0 {
- _, err = c.redis.Ctx(ctx).Do("EXPIRE", key, uint64(duration.Seconds()))
- }
- // No expire.
- if duration == 0 {
- v, err = c.redis.Ctx(ctx).DoVar("GET", key)
- if err != nil {
- return
- }
- _, err = c.redis.Ctx(ctx).Do("SET", key, v.Val())
- }
- return
- }
- // GetExpire retrieves and returns the expiration of <key> in the cache.
- //
- // It returns 0 if the <key> does not expire.
- // It returns -1 if the <key> does not exist in the cache.
- func (c *Redis) GetExpire(ctx context.Context, key interface{}) (time.Duration, error) {
- v, err := c.redis.Ctx(ctx).DoVar("TTL", key)
- if err != nil {
- return 0, err
- }
- switch v.Int() {
- case -1:
- return 0, nil
- case -2:
- return -1, nil
- default:
- return v.Duration() * time.Second, nil
- }
- }
- // SetIfNotExist sets cache with <key>-<value> pair which is expired after <duration>
- // if <key> does not exist in the cache. It returns true the <key> dose not exist in the
- // cache and it sets <value> successfully to the cache, or else it returns false.
- //
- // The parameter <value> can be type of <func() interface{}>, but it dose nothing if its
- // result is nil.
- //
- // It does not expire if <duration> == 0.
- // It deletes the <key> if <duration> < 0 or given <value> is nil.
- func (c *Redis) SetIfNotExist(ctx context.Context, key interface{}, value interface{}, duration time.Duration) (bool, error) {
- var err error
- // Execute the function and retrieve the result.
- if f, ok := value.(func() (interface{}, error)); ok {
- value, err = f()
- if value == nil {
- return false, err
- }
- }
- // DEL.
- if duration < 0 || value == nil {
- v, err := c.redis.Ctx(ctx).DoVar("DEL", key, value)
- if err != nil {
- return false, err
- }
- if v.Int() == 1 {
- return true, err
- } else {
- return false, err
- }
- }
- v, err := c.redis.Ctx(ctx).DoVar("SETNX", key, value)
- if err != nil {
- return false, err
- }
- if v.Int() > 0 && duration > 0 {
- // Set the expire.
- _, err := c.redis.Ctx(ctx).Do("EXPIRE", key, uint64(duration.Seconds()))
- if err != nil {
- return false, err
- }
- return true, err
- }
- return false, err
- }
- // Sets batch sets cache with key-value pairs by <data>, which is expired after <duration>.
- //
- // It does not expire if <duration> == 0.
- // It deletes the keys of <data> if <duration> < 0 or given <value> is nil.
- func (c *Redis) Sets(ctx context.Context, data map[interface{}]interface{}, duration time.Duration) error {
- if len(data) == 0 {
- return nil
- }
- // DEL.
- if duration < 0 {
- var (
- index = 0
- keys = make([]interface{}, len(data))
- )
- for k, _ := range data {
- keys[index] = k
- index += 1
- }
- _, err := c.redis.Ctx(ctx).Do("DEL", keys...)
- if err != nil {
- return err
- }
- }
- if duration == 0 {
- var (
- index = 0
- keyValues = make([]interface{}, len(data)*2)
- )
- for k, v := range data {
- keyValues[index] = k
- keyValues[index+1] = v
- index += 2
- }
- _, err := c.redis.Ctx(ctx).Do("MSET", keyValues...)
- if err != nil {
- return err
- }
- }
- if duration > 0 {
- var err error
- for k, v := range data {
- if err = c.Set(ctx, k, v, duration); err != nil {
- return err
- }
- }
- }
- return nil
- }
- // Get retrieves and returns the associated value of given <key>.
- // It returns nil if it does not exist or its value is nil.
- func (c *Redis) Get(ctx context.Context, key interface{}) (interface{}, error) {
- v, err := c.redis.Ctx(ctx).DoVar("GET", key)
- if err != nil {
- return nil, err
- }
- return v.Val(), nil
- }
- // GetOrSet retrieves and returns the value of <key>, or sets <key>-<value> pair and
- // returns <value> if <key> does not exist in the cache. The key-value pair expires
- // after <duration>.
- //
- // It does not expire if <duration> == 0.
- // It deletes the <key> if <duration> < 0 or given <value> is nil, but it does nothing
- // if <value> is a function and the function result is nil.
- func (c *Redis) GetOrSet(ctx context.Context, key interface{}, value interface{}, duration time.Duration) (interface{}, error) {
- v, err := c.Get(ctx, key)
- if err != nil {
- return nil, err
- }
- if v == nil {
- return value, c.Set(ctx, key, value, duration)
- } else {
- return v, nil
- }
- }
- // GetOrSetFunc retrieves and returns the value of <key>, or sets <key> with result of
- // function <f> and returns its result if <key> does not exist in the cache. The key-value
- // pair expires after <duration>.
- //
- // It does not expire if <duration> == 0.
- // It deletes the <key> if <duration> < 0 or given <value> is nil, but it does nothing
- // if <value> is a function and the function result is nil.
- func (c *Redis) GetOrSetFunc(ctx context.Context, key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error) {
- v, err := c.Get(ctx, key)
- if err != nil {
- return nil, err
- }
- if v == nil {
- value, err := f()
- if err != nil {
- return nil, err
- }
- if value == nil {
- return nil, nil
- }
- return value, c.Set(ctx, key, value, duration)
- } else {
- return v, nil
- }
- }
- // GetOrSetFuncLock retrieves and returns the value of <key>, or sets <key> with result of
- // function <f> and returns its result if <key> does not exist in the cache. The key-value
- // pair expires after <duration>.
- //
- // It does not expire if <duration> == 0.
- // It does nothing if function <f> returns nil.
- //
- // Note that the function <f> should be executed within writing mutex lock for concurrent
- // safety purpose.
- func (c *Redis) GetOrSetFuncLock(ctx context.Context, key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error) {
- return c.GetOrSetFunc(ctx, key, f, duration)
- }
- // Contains returns true if <key> exists in the cache, or else returns false.
- func (c *Redis) Contains(ctx context.Context, key interface{}) (bool, error) {
- v, err := c.redis.Ctx(ctx).DoVar("EXISTS", key)
- if err != nil {
- return false, err
- }
- return v.Bool(), nil
- }
- // Remove deletes the one or more keys from cache, and returns its value.
- // If multiple keys are given, it returns the value of the deleted last item.
- func (c *Redis) Remove(ctx context.Context, keys ...interface{}) (value interface{}, err error) {
- if len(keys) == 0 {
- return nil, nil
- }
- // Retrieves the last key value.
- if v, err := c.redis.Ctx(ctx).DoVar("GET", keys[len(keys)-1]); err != nil {
- return nil, err
- } else {
- value = v.Val()
- }
- // Deletes all given keys.
- _, err = c.redis.Ctx(ctx).DoVar("DEL", keys...)
- return value, err
- }
- // Data returns a copy of all key-value pairs in the cache as map type.
- func (c *Redis) Data(ctx context.Context) (map[interface{}]interface{}, error) {
- // Keys.
- v, err := c.redis.Ctx(ctx).DoVar("KEYS", "*")
- if err != nil {
- return nil, err
- }
- keys := v.Slice()
- // Values.
- v, err = c.redis.Ctx(ctx).DoVar("MGET", keys...)
- if err != nil {
- return nil, err
- }
- values := v.Slice()
- // Compose keys and values.
- data := make(map[interface{}]interface{})
- for i := 0; i < len(keys); i++ {
- data[keys[i]] = values[i]
- }
- return data, nil
- }
- // Keys returns all keys in the cache as slice.
- func (c *Redis) Keys(ctx context.Context) ([]interface{}, error) {
- v, err := c.redis.Ctx(ctx).DoVar("KEYS", "*")
- if err != nil {
- return nil, err
- }
- return v.Slice(), nil
- }
- // Values returns all values in the cache as slice.
- func (c *Redis) Values(ctx context.Context) ([]interface{}, error) {
- // Keys.
- v, err := c.redis.Ctx(ctx).DoVar("KEYS", "*")
- if err != nil {
- return nil, err
- }
- keys := v.Slice()
- // Values.
- v, err = c.redis.Ctx(ctx).DoVar("MGET", keys...)
- if err != nil {
- return nil, err
- }
- return v.Slice(), nil
- }
- // Size returns the size of the cache.
- func (c *Redis) Size(ctx context.Context) (size int, err error) {
- v, err := c.redis.Ctx(ctx).DoVar("DBSIZE")
- if err != nil {
- return 0, err
- }
- return v.Int(), nil
- }
- // Clear clears all data of the cache.
- // Note that this function is sensitive and should be carefully used.
- func (c *Redis) Clear(ctx context.Context) error {
- // The "FLUSHDB" may not be available.
- if _, err := c.redis.Ctx(ctx).DoVar("FLUSHDB"); err != nil {
- keys, err := c.Keys(ctx)
- if err != nil {
- return err
- }
- _, err = c.Remove(ctx, keys...)
- return err
- }
- return nil
- }
- // Close closes the cache.
- func (c *Redis) Close(ctx context.Context) error {
- // It does nothing.
- return nil
- }
|