deerlet-redis-client添加集群支持,邀请各路大神和菜鸟加入。

时间:2021-07-26 04:20:26

引言

  

  经过几周的修改,deerlet已经添加了对于redis集群的支持,策略与memcached客户端一样,采用一致性Hash。不过目前Hash的算法取自Java自带的String类型的HashCode算法,因此还有待优化,后续会选取一个相对更加优秀的Hash算法。

  目前deerlet的基本框架搭建以及小部分命令的支持已经完成,并附带完整的单元测试。接下来主要要做的工作是补上剩下的命令的支持。这需要一定的工作量,LZ希望有猿友能够一起完成。

  

更新后的deerlet文档

-----------------------------------------以下为文档--------------------------------------

  

deerlet-redis-client

deerlet是一个简单易用的redis for java客户端,支持与spring无缝集成。

特性

1,轻量级,jar包只有25kb。
2,简单易用,无侵入性。
3,可以与当前流行的ioc容器spring无缝集成。
4,API完全与redis命令保持一致,减少学习成本。
5,支持集群,采用一致性hash策略。

使用示例(直接使用)

1.在classpath(比如eclipse中src下)路径下添加以下文件,名为deerlet.properties

#该属性为redis服务器ip和端口,支持集群,以逗号隔开
address=localhost:6379

2.使用以下编程式的方式即可使用deerlet

Configuration configuration = ConfigurationFactory.create().loadConfiguration();
ConnectionFactory connectionFactory = new ConnectionFactoryImpl(configuration);
DeerletRedisClient deerletRedisClient = new DeerletRedisClientImpl(connectionFactory);//获取client对象 deerletRedisClient.set("testKey","testValue");//存储一个键为testKey,值为testValue的键值对
System.out.println(deerletRedisClient.get("testKey"));//获取
System.out.println(deerletRedisClient.dbSize());//查看大小
deerletRedisClient.flushAll();//刷新
System.out.println(deerletRedisClient.dbSize());//查看大小

使用示例(与spring集成)

1.在spring的配置文件中加入如下bean定义

<bean id="deerletRedisClient" class="cn.zxl.deerlet.redis.client.spring.DeerletRedisClientFactoryBean">
</bean>

2.在classpath(比如eclipse中src下)路径下添加以下文件,名为deerlet.properties

#该属性为redis服务器ip和端口,支持集群,以逗号隔开
address=localhost:6379

3.使用以下编程式的方式即可使用deerlet

ApplicationContext applicationContext = new FileSystemXmlApplicationContext("
classpath:applicationContext.xml");//初始化spring容器
DeerletRedisClient deerletRedisClient = applicationContext.getBean(DeerletRedisClient.class);//获取client对象 deerletRedisClient.set("testKey","testValue");//存储一个键为testKey,值为testValue的键值对
System.out.println(deerletRedisClient.get("testKey"));//获取
System.out.println(deerletRedisClient.dbSize());//查看大小
deerletRedisClient.flushAll();//刷新
System.out.println(deerletRedisClient.dbSize());//查看大小

deerlet.properties文件属性说明

address:必选,格式为 host1:port1,host2:port2....
initSize:可选,指定连接池初始连接数,默认为10
maxSize:可选,指定连接池最大连接数,默认为100
minIdleSize:可选,指定连接池最小空闲连接数,默认为10
maxIdleSize:可选,指定连接池最大空闲连接数,默认为20

目前支持的命令

del,dump,exists,expire,expireat,keys,migrate,move,object,persist,pexpire
,pexpireat,pttl,randomkey,rename,renamenx,restore,sort,ttl,type,scan
,append,bitcount,bitop,decr,decrby,get,getbit,getrange,getset,incr,incrby
,incrbyfloat,mget,mset,msetnx,psetex,set,setbit,setex,setnx,setrange,strlen
,lindex,linsert,llen,lpop,lpush,lpushx,lrange,lrem,lset,ltrim
,select,bgrewriteaof,bgsave,dbsize,flushall,flushdb
正在陆续添加中...欢迎您来一起加入

-----------------------------------------文档结束--------------------------------------

  

未来的规划

  

  之前LZ一直在master上面做修改,为了接下来和大家更好的协作,LZ已经建立了一个1.x分支。建议大家在这个分支上进行push操作。在1.x分支上所有命令添加完毕,并且单元测试通过以后,将会发布deerlet-redis-client-1.0版本。之后关于1.0版本的bug修复和优化,也在1.x分支上进行。

  此外,根据可靠消息,redis未来可能会在服务器端做集群,届时deerlet会根据redis的变化,进行相应的改动。只有deerlet有重大变革时,才会更改主版本号,因此大家基本上会在很长一段时间内在1.x分支上开发。

  接下来的一小段时间内,deerlet主要要做的是以下两件事。

  1,添加目前未支持的命令。

  2,完善单元测试,确保稳定性。

  

如何加入

  

  deerlet在github上面的地址为:https://github.com/xiaolongzuo/deerlet-redis-client

  1,首先安装一下git,并将代码clone到本地,可以选择clone到时LZ创建的1.X分支。

    git clone git@github.com:xiaolongzuo/deerlet-redis-client.git   //下载源码

    git -c core.quotepath=false checkout -b branch-1.x    //切换到1.x分支

  2,在本地电脑上下载并安装maven,或使用eclipse的maven插件都可以,因为deerlet的构建工具是maven。

  3,在本地电脑上安装redis,并启动三个redis实例,端口分别为6379,6479,6666。

  4,redis启动以后,运行mvn test命令看是否能够通过单元测试。

  完成以上几步以后,deerlet已经可以在你本地运行。这时你就可以修复相应的bug,或者添加你所希望它具有的特性。记得,完事以后不要忘了push哦。