Redis 插件实现

整理了一下 redis 的使用,做成了一个包。方便自己在其他项目中使用。其中分布式锁的实现,jedis 是用最被人诟病的坑爹实现(set 和 过期不是原子操作),lettuce 采用 lua 脚本。目前已经发布在 github 上,希望有熟悉 redis 锁以及限流实现方案的大佬们给出建议。感谢!

? 方便的使用 redis

HitCount GitHub issuesLicense Maven Central Download

特性

  • 简单易用
  • 支持集群
  • 自动配置
  • 多种实现可自由切换
  • 方便的 API
  • 分布式锁
  • 分布式限流

快速开始

1.引入依赖
<dependency>  
    <groupId>io.github.pleuvoir</groupId>  
    <artifactId>redis-plugin</artifactId>  
    <version>${latest.version}</version>  
</dependency>  
2. 配置文件

接着我们需要准备一份配置文件,它看起来是这样的,文件的名称我们先假定为 redis.properties

此处 redis.hostAndPort=127.0.0.1:6379 代表单机,如果是集群可以是 127.0.0.1:6379,127.0.0.1:6379,127.0.0.1:6379 这样的格式。

redis.hostAndPort=127.0.0.1:6379  
redis.database=1  
redis.password=  
redis.pool.maxIdle=4  
redis.pool.maxTotal=6  
redis.pool.maxWait=5000  
redis.cacheManager.prefix=redis-plugin:  
3. 使用 spring 进行管理

对于使用 xml 进行配置的项目,只需要如下声明,即可获得缓存能力。

<bean class="io.github.pleuvoir.JedisRedisConfiguration">  
    <property name="location" value="redis.properties"/>  
</bean>  

显然,这种实现是基于 Jedis 的,同时我们也支持 Lettuce,就像这样:

<bean class="io.github.pleuvoir.LettuceRedisConfiguration">  
    <property name="location" value="redis.properties"/>  
</bean>  

提示:使用 xml 注册的方式,可以不指定扫描包。

如果是使用注解的项目,建议使用自动配置。

只需在配置类中声明 @EnableRedisPlugin 即可,当然这是使用默认的配置。 EnableRedisPlugin 注解有几个重要的属性,分别是 location 以及 Type,其中 location 表示需要加载的配置文件位置,location 可以不声明,默认为 classpath 下的 redis.properties 文件。 Type 则表示可以选择内部的第三方 redis 实现,默认是 Lettuce ,目前支持 JedisLettuce

4. API

配置完成后,缓存服务 CacheService 提供了一些操作数据的方法,详情请查看具体 API:

/**  
 * 添加缓存,使用默认失效时间  
 * @param key  
 * @param value  
 */  
public void set(String key, Object value);  
  
/**  
 * 取缓存  
 * @param key  
 * @return Object  
 */  
public Object get(String key);  
  
/**  
 * 当缓存中没有时存入,缓存中存在时不存入  
 * @param key  
 * @param value  
 * @return 缓存中没有时返回true,缓存中有时返回false  
 */  
boolean putIfExist(String key, Object value);  
  
...  
5. 分布式锁

锁的使用方法如下所指:

String key = "88250";  
  
if (lock.isLocked(key)) {  
    System.out.println(":sob:  this resource is locked .. ");  
    return;  
}  
  
try {  
    if (!lock.lock(key)) {  
        System.out.println("I got a lock fail ...");  
        return;  
    }  
    // do your bussiness  
    unpark();  
} finally {  
    lock.unlock(key);  
}  
6. 限流
limitExecutor.tryAccess("limit", "X-Y", 10, 3);  

流控正常时返回 true,被限流时返回 false,其中 limit 为资源的名称, X-Y 为限流 key , 10 和 3 代表 该资源 10 秒内可以访问 3 次

特别说明

如果项目使用 Profiles 来管理 spring 的环境,例如 Environment().setActiveProfiles("dev") ,自动配置会尝试将当前环境修饰符追加到文件名称后,即如果您使用了 @EnableRedisPlugin(location = "redis.properties") 进行自动配置,插件会去寻找名为 redis-dev.properties 的配置文件,确保文件存在即可。

使用 xml 注册的方式,不受此特性的影响。

TODO LIST

  • 基于 jedis 的限流实现以及 aop 支持
  • 消息中间件
  • More API

开源协议

[Apache License](LICENSE)

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值