Documentation ¶
Overview ¶
Package gcache provides kinds of cache management for process. It default provides a concurrent-safe in-memory cache adapter for process.
Index ¶
- func Contains(key interface{}) (bool, error)
- func Data() (map[interface{}]interface{}, error)
- func Get(key interface{}) (interface{}, error)
- func GetExpire(key interface{}) (time.Duration, error)
- func GetOrSet(key interface{}, value interface{}, duration time.Duration) (interface{}, error)
- func GetOrSetFunc(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error)
- func GetOrSetFuncLock(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error)
- func GetVar(key interface{}) (*gvar.Var, error)
- func KeyStrings() ([]string, error)
- func Keys() ([]interface{}, error)
- func Remove(keys ...interface{}) (value interface{}, err error)
- func Removes(keys []interface{})
- func Set(key interface{}, value interface{}, duration time.Duration)
- func SetIfNotExist(key interface{}, value interface{}, duration time.Duration) (bool, error)
- func Sets(data map[interface{}]interface{}, duration time.Duration) error
- func Size() (int, error)
- func Update(key interface{}, value interface{}) (oldValue interface{}, exist bool, err error)
- func UpdateExpire(key interface{}, duration time.Duration) (oldDuration time.Duration, err error)
- func Values() ([]interface{}, error)
- type Adapter
- type Cache
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Data ¶
func Data() (map[interface{}]interface{}, error)
Data returns a copy of all key-value pairs in the cache as map type.
func Get ¶
func Get(key interface{}) (interface{}, error)
Get returns the value of <key>. It returns nil if it does not exist or its value is nil.
func GetExpire ¶ added in v1.13.4
GetExpire retrieves and returns the expiration of <key>. It returns -1 if the <key> does not exist in the cache.
func GetOrSet ¶
GetOrSet 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.
func GetOrSetFunc ¶
func GetOrSetFunc(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error)
GetOrSetFunc 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.
func GetOrSetFuncLock ¶
func GetOrSetFuncLock(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error)
GetOrSetFuncLock 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.
Note that the function <f> is executed within writing mutex lock.
func KeyStrings ¶
KeyStrings returns all keys in the cache as string slice.
func Remove ¶
func Remove(keys ...interface{}) (value interface{}, err error)
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 Removes ¶
func Removes(keys []interface{})
Removes deletes <keys> in the cache. Deprecated, use Remove instead.
func Set ¶
Set sets cache with <key>-<value> pair, which is expired after <duration>. It does not expire if <duration> == 0.
func SetIfNotExist ¶
SetIfNotExist sets cache with <key>-<value> pair if <key> does not exist in the cache, which is expired after <duration>. It does not expire if <duration> == 0.
func Sets ¶
Sets batch sets cache with key-value pairs by <data>, which is expired after <duration>.
It does not expire if <duration> == 0.
func Update ¶ added in v1.13.4
Update updates the value of <key> without changing its expiration and returns the old value. The returned <exist> value is false if the <key> does not exist in the cache.
func UpdateExpire ¶ added in v1.13.4
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.
Types ¶
type Adapter ¶ added in v1.14.0
type Adapter interface { // 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. Set(key interface{}, value interface{}, duration time.Duration) error // 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. Sets(data map[interface{}]interface{}, duration time.Duration) error // 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. SetIfNotExist(key interface{}, value interface{}, duration time.Duration) (bool, error) // Get retrieves and returns the associated value of given <key>. // It returns nil if it does not exist or its value is nil. Get(key interface{}) (interface{}, error) // 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. GetOrSet(key interface{}, value interface{}, duration time.Duration) (interface{}, error) // 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. GetOrSetFunc(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error) // 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. GetOrSetFuncLock(key interface{}, f func() (interface{}, error), duration time.Duration) (interface{}, error) // Contains returns true if <key> exists in the cache, or else returns false. Contains(key interface{}) (bool, error) // 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. GetExpire(key interface{}) (time.Duration, error) // Remove deletes one or more keys from cache, and returns its value. // If multiple keys are given, it returns the value of the last deleted item. Remove(keys ...interface{}) (value interface{}, err error) // 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. Update(key interface{}, value interface{}) (oldValue interface{}, exist bool, err error) // UpdateExpire updates the expiration of <key> and returns the old expiration duration value. // // It returns -1 and does nothing if the <key> does not exist in the cache. // It deletes the <key> if <duration> < 0. UpdateExpire(key interface{}, duration time.Duration) (oldDuration time.Duration, err error) // Size returns the number of items in the cache. Size() (size int, err error) // Data returns a copy of all key-value pairs in the cache as map type. // Note that this function may leads lots of memory usage, you can implement this function // if necessary. Data() (map[interface{}]interface{}, error) // Keys returns all keys in the cache as slice. Keys() ([]interface{}, error) // Values returns all values in the cache as slice. Values() ([]interface{}, error) // Clear clears all data of the cache. // Note that this function is sensitive and should be carefully used. Clear() error // Close closes the cache if necessary. Close() error }
Adapter is the adapter for cache features implements.
type Cache ¶
type Cache struct {
Adapter // Adapter for cache features.
}
Cache struct.
func New ¶
New creates and returns a new cache object using default memory adapter. Note that the LRU feature is only available using memory adapter.
func (*Cache) GetVar ¶ added in v1.13.0
GetVar retrieves and returns the value of <key> as gvar.Var.
func (*Cache) KeyStrings ¶
KeyStrings returns all keys in the cache as string slice.
func (*Cache) SetAdapter ¶ added in v1.14.0
SetAdapter changes the adapter for this cache. Be very note that, this setting function is not concurrent-safe, which means you should not call this setting function concurrently in multiple goroutines.