cache

README

可切换使用的缓存驱动

开发原由

在开发项目经常使用到redis、memcache、memory 等缓存，如果新手则不得不花时间去看各类文档，然后再编写各种缓存类型相关的代码。 且每个类型的配置以及api 千差万别，很让人头疼，于是便有了编写一个统一可扩展的缓存驱动的念头。受益于golang的sql/databases数据库驱动 开发思路的启发，于是便有了该项目

特性

• 可配置
• 可扩展

目前支持的缓存

• redis
• memcache
• memory

扩展接口

Cache interface {
    Get(key string) ([]byte, error)
    Put(key string, val interface{}, timeout time.Duration) error
    Delete(key string) error
    Incr(key string) error
    Decr(key string) error
    IsExist(key string) bool
    ClearAll() error
    StartAndConfigure(ops ...CacheOption) error
    Close() error
}

如果您觉得提供的redis以及memcache缓存不能满足您的要求，可以根据以上接口编写自己的缓存驱动， 然后注册驱动到工厂就可以使用了

func init() {
	factory.Register("redis", NewRedisCache)
}

如何使用

首先当然是先下载代码了

go get -u gitee.com/aesoper/cache

第一种方式

	cache, err := factory.NewCache("memcache")
	if err != nil {
		return
	}

	cache.Put("test", "111", time.Minute*5)
	cache.Put("test2", "2222", time.Minute*5)

第二种方式

	c, err := cache.New(Cfg{
		Driver: "redis",
		Redis: redis.Options{
			Addr: "localhost:6379",
		},
	})
	if err != nil {
		return
	}

	c.Put("test", "111", time.Minute*5)

注意事项

1. 如果使用memory,在使用Get返回的[]byte进行解码时建议使用encoding/gob包，否则有可能出先乱码

开发依赖的第三方

1. redis类库
2. memcache类库
3. 测试类库
4. memory类库

参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

码云特技

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. 码云官方博客 blog.gitee.com
3. 你可以 https://gitee.com/explore 这个地址来了解码云上的优秀开源项目
4. GVP 全称是码云最有价值开源项目，是码云综合评定出的优秀开源项目
5. 码云官方提供的使用手册 https://gitee.com/help
6. 码云封面人物是一档用来展示码云会员风采的栏目 https://gitee.com/gitee-stars/

Documentation

Index

• func New(cfg Cfg) (c factory.Cache, err error)
• type Cfg

Functions

func New

func New(cfg Cfg) (c factory.Cache, err error)

Types

type Cfg

type Cfg struct {
	// 启用的缓存驱动 值为 redis|redis_cluster|memcache
	Driver       string               `mapstructure:"driver" json:"driver"`
	Redis        redis.Options        `mapstructure:"redis" json:"redis"`
	RedisCluster redis.ClusterOptions `mapstructure:"redisCluster" json:"redisCluster"`
	Memcache     memcache.Options     `mapstructure:"memcache" json:"memcache"`
	Memory       memory.Option        `mapstructure:"memory" json:"memory"`
}