Redis客户端开发包:Jedis学习-入门
添加Jedis依赖
我们可以使用以下三种方式来添加Jedis依赖。
1、下载jar文件
从http://search.maven.org/下载最近的jedis包和Apache Commons Pool 2 2.0依赖包。
2、从源码中构建
以下方式会构建最新的Jedis版本。
首先、克隆GitHub项目
很简单,在命令行输入git clone git://github.com/xetorthio/jedis.git
命令即可。
然后、使用maven构建项目
在使用maven打包之前,需要先通过单元测试,我们可以运行make package命令完成单元测试和打包工作。
3、配置maven依赖
Jedis通过Sonatype,被发布为一个Maven依赖,我们可以在pom.xml文件中添加以下xml片段来配置Jedis依赖
<dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>2.8.0</version> <type>jar</type> <scope>compile</scope> </dependency>
添加完后,在工程的maven依赖库中可以看到以下两个jar文件:
基本使用示例
在多线程环境中使用Jedis
你不应该在不同的线程中使用同一个Jedis对象实例,否则会遇到各种奇怪的错误。
同样的,针对每个线程都创建一个Jedis实例也不是很合适,因为这意味着会有许多sockets和connections,也会造成奇怪的错误。
一个Jedis实例存在线程安全问题,为了避免这个问题,我们应该使用Jedis池(JedisPool),它是线程安全的。使用JedisPool,我们不仅可以避免那些奇怪的错误,还能取得良好的性能。
可以使用以下代码片段初始化一个JedisPool:
JedisPool pool = new JedisPool(new JedisPoolConfig(), "localhost");
JedisPoolConfig对象包含了一些默认的连接池配置,我们可以通过查看其构造方法了解其具体默认配置信息,如下代码:
public JedisPoolConfig() { // defaults to make your life with connection pool easier :) setTestWhileIdle(true); setMinEvictableIdleTimeMillis(60000); setTimeBetweenEvictionRunsMillis(30000); setNumTestsPerEvictionRun(-1); }
另外,JedisPool是基于Commons Pool 2的,所以我们也可以了解一下Commons Pool的配置,详见http://commons.apache.org/proper/commons-pool/apidocs/org/apache/commons/pool2/impl/GenericObjectPoolConfig.html。
下面给出一个完整的例子,注意要先启动redis服务端:
package cn.edu.hdu.jedisdemo; import java.util.Set; import redis.clients.jedis.Jedis; import redis.clients.jedis.JedisPool; import redis.clients.jedis.JedisPoolConfig; public class App { public static void main(String[] args) { JedisPool pool = new JedisPool(new JedisPoolConfig(), "localhost"); // / Jedis implements Closable. Hence, the jedis instance will be // auto-closed after the last statement. try (Jedis jedis = pool.getResource()) { // / ... do stuff here ... for example jedis.set("foo", "bar"); String foobar = jedis.get("foo"); jedis.zadd("sose", 0, "car"); jedis.zadd("sose", 0, "bike"); Set<String> sose = jedis.zrange("sose", 0, -1); System.out.println(foobar); System.out.println(sose); } // / ... when closing your application: pool.close(); } }
如果你的JAVA版本不支持try-with-resource语法,我们可以使用Jedis.close()
Jedis jedis = null; try { jedis = pool.getResource(); /// ... do stuff here ... for example jedis.set("foo", "bar"); String foobar = jedis.get("foo"); jedis.zadd("sose", 0, "car"); jedis.zadd("sose", 0, "bike"); Set<String> sose = jedis.zrange("sose", 0, -1); } finally { if (jedis != null) { jedis.close(); } } /// ... when closing your application: pool.destroy();
主从配置
主服务器负责接收写数据请求,并且将数据改变复制给从服务器,来保持数据一致性。
从服务器(不一定是必须的)负责接受读数据请求,来减轻主服务器的压力。
主从同步的过程
建立主从关系后,slave 会建立和 master 的连接,然后发送 sync 命令。master会启动一个后台进程,将数据库快照保存到文件中,同时master主进程开始收集写命令并缓存起来。当后台完成写文件后,master服务器会将快照文件发给slave服务器,slave服务器会将快照文件恢复到slave的内存数据库上。完成快照恢复后,master将缓存的写命令转发给slave,slave更新内存数据库。然后,后续master的写命令会通过开始建立的连接发送给slave来完成数据同步。
主从关系的特点
master服务器下面可以有多个slave服务器,slave服务器下面也可以有多个slave服务器,可以形成树状结构
主从复制不会阻塞master服务器,但会阻塞slave服务器
启用主从关系
我们可以通过以下两种方式启用主从关系:
1、通过各个redis服务器的配置文件来配置主从关系
slaveof 192.168.1.35 6379 # 指定master主服务器的ip和端口
优缺点:简单,但是配置文件是在服务器启动时加载的,所以服务器启动后就不能在线修改了。
2、通过调用slaveOf方法,传入ip地址和端口号,
jedis.slaveOf("localhost", 6379); // if the master is on the same PC which runs your code jedis.slaveOf("192.168.1.35", 6379);
优点:可以在线修改redis服务器的主从关系
关闭主从关系,提升一个从服务器为主服务器
当一个主服务器宕机的时候,我们希望能将一个从服务器升级为主服务器。
为此,我们需要先关闭原先的主从关系,然后(假定我们有多个从服务器),将其余从服务器配置到新的主服务器上。
slave1jedis.slaveofNoOne(); //取消主服务器关联,自己成为主服务器 slave2jedis.slaveof("192.168.1.36", 6379); //指定主服务器的ip和端口
参考资料:
https://github.com/xetorthio/jedis/wiki
http://www.tuicool.com/articles/Uruyemf