[TOC]
Redis Java API使用(一):单机版本Redis API使用
Redis的Java API通过Jedis来进行操作,因此首先需要Jedis的第三方库,因为使用的是Maven工程,所以先给出Jedis的依赖:
redis.clients
jedis
基本代码示例
Redis能提供的命令,Jedis也都提供了,而且使用起来非常类似,所以下面只是给出了部分操作的代码。
package com.uplooking.bigdata;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import redis.clients.jedis.Jedis;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
* Redis操作之java API
* jedis 是我们操作Redis的java api的入口
* 一个Jedis对象,就代表了一个Redis的连接
* CRUD
*/
public class RedisTest {
private Jedis jedis;
private String host;
private int port;
@Before
public void setUp() {
host = "uplooking01";
port = 6379;
jedis = new Jedis(host, port);
}
@Test
public void testCRUD() {
//后去所有的key的集合
Set keys = jedis.keys("*");
// jedis.select(index); 指定要执行操作的数据库,默认操作的是0号数据
System.out.println(keys);
//string
System.out.println("**************String**************");
//删除redis中的key nam1
Long del = jedis.del("nam1");
System.out.println(del == 1L ? "删除成功~" : "删除失败~");
List mget = jedis.mget("name", "age");
System.out.println(mget);
//hash
System.out.println("**************Hash**************");
Map person = jedis.hgetAll("person");
//keyset
//entryset
for (Map.Entry me : person.entrySet()) {
String field = me.getKey();
String value = me.getValue();
System.out.println(field + "---" + value);
}
//list
System.out.println("**************List**************");
List seasons = jedis.lrange("season", 0, -1);
for (String season : seasons) {
System.out.println(season);
}
//set
System.out.println("**************Set**************");
Set nosql = jedis.smembers("nosql");
for (String db : nosql) {
System.out.println(db);
}
//zset
System.out.println("**************Zset**************");
Set website = jedis.zrange("website", 0, -1);
for (String ws : website) {
System.out.println(ws);
}
}
@After
public void cleanUp() {
jedis.close();
}
}
JedisPool工具类开发
前面的代码是每次都建立一个Jedis的连接,这样比较消耗资源,可以使用JedisPool来解决这个问题,同时为了提高后面的开发效率,可以基于JedisPool来开发一个工具类。
JedisUtil.java
package com.uplooking.bigdata.common.util.redis;
import com.uplooking.bigdata.constants.redis.JedisConstants;
import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;
import redis.clients.jedis.JedisPoolConfig;
import java.io.IOException;
import java.util.Properties;
/**
* Redis Java API 操作的工具类
* 主要为我们提供 Java操作Redis的对象Jedis 模仿类似的数据库连接池
*
* JedisPool
*/
public class JedisUtil {
private JedisUtil() {}
private static JedisPool jedisPool;
static {
Properties prop = new Properties();
try {
prop.load(JedisUtil.class.getClassLoader().getResourceAsStream("redis/redis.properties"));
JedisPoolConfig poolConfig = new JedisPoolConfig();
//jedis连接池中最大的连接个数
poolConfig.setMaxTotal(Integer.valueOf(prop.getProperty(JedisConstants.JEDIS_MAX_TOTAL)));
//jedis连接池中最大的空闲连接个数
poolConfig.setMaxIdle(Integer.valueOf(prop.getProperty(JedisConstants.JEDIS_MAX_IDLE)));
//jedis连接池中最小的空闲连接个数
poolConfig.setMinIdle(Integer.valueOf(prop.getProperty(JedisConstants.JEDIS_MIN_IDLE)));
//jedis连接池最大的等待连接时间 ms值
poolConfig.setMaxWaitMillis(Long.valueOf(prop.getProperty(JedisConstants.JEDIS_MAX_WAIT_MILLIS)));
//表示jedis的服务器主机名
String host = prop.getProperty(JedisConstants.JEDIS_HOST);
String JEDIS_PORT = "jedis.port";
int port = Integer.valueOf(prop.getProperty(JedisConstants.JEDIS_PORT));
//表示jedis的服务密码
String password = prop.getProperty(JedisConstants.JEDIS_PASSWORD);
jedisPool = new JedisPool(poolConfig, host, port, 10000);
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 提供了Jedis的对象
* @return
*/
public static Jedis getJedis() {
return jedisPool.getResource();
}
/**
* 资源释放
* @param jedis
*/
public static void returnJedis(Jedis jedis) {
jedis.close();
}
}
JedisConstants.java
package com.uplooking.bigdata.constants.redis;
/**
* 专门用于存放Jedis的常量类
*/
public interface JedisConstants {
//表示jedis的服务器主机名
String JEDIS_HOST = "jedis.host";
//表示jedis的服务的端口
String JEDIS_PORT = "jedis.port";
//表示jedis的服务密码
String JEDIS_PASSWORD = "jedis.password";
//jedis连接池中最大的连接个数
String JEDIS_MAX_TOTAL = "jedis.max.total";
//jedis连接池中最大的空闲连接个数
String JEDIS_MAX_IDLE = "jedis.max.idle";
//jedis连接池中最小的空闲连接个数
String JEDIS_MIN_IDLE = "jedis.min.idle";
//jedis连接池最大的等待连接时间 ms值
String JEDIS_MAX_WAIT_MILLIS = "jedis.max.wait.millis";
}
redis.properties
##########################################
###
### redis的配置文件
###
##########################################
###表示jedis的服务器主机名
jedis.host=uplooking01
###表示jedis的服务的端口
jedis.port=6379
###表示jedis的服务密码
jedis.password=uplooking
###jedis连接池中最大的连接个数
jedis.max.total=60
###jedis连接池中最大的空闲连接个数
jedis.max.idle=30
###jedis连接池中最小的空闲连接个数
jedis.min.idle=5
###jedis连接池最大的等待连接时间 ms值
jedis.max.wait.millis=30000
后面就可以非常方便地使用这个工具类来进行Redis的操作:
// 获得Jedis连接对象
Jedis jedis = JedisUtil.getJedis();
// 释放Jedis对象资源
JedisUtil.returnJedis(jedis);
Redis分布式集群环境搭建
Redis集群理论知识
Redis集群是一个分布式Redis存储架构,可以在多个节点之间进行数据共享,解决Redis高可用、可扩展等问题。
Redis集群提供了以下两个好处
1.将数据自动切分(split)到多个节点
2.当集群中的某一个节点故障时,redis还可继续处理客户端的请求
一个Redis集群包含16384个哈希槽(hash slot),数据库中的每个数据都属于这16384个哈希槽中的一个。
集群使用公式CRC16(key)%16384来计算key属于哪一个槽。集群中的每一个节点负责处理一部分哈希槽。
集群中的主从复制
集群中的每个节点都有1个到N个复制品,其中一个为主节点,其余为从节点,如果主节点下线了,
集群就会把这个主节点的一个从节点设置为新的主节点,继续工作。这个集群就不会因为一个主节点的下线而无法正常工作。
如果某一个主节点和它所有的从节点都下线的话,redis集群就停止工作了。
Redis集群不保证数据的强一致性,在特定的情况下,redis集群会丢失已经执行过的命令。
使用异步复制(asynchronous replication)是Redis集群可能会丢失写命令的其中一个原因,
有时候由于网络原因,如果网络断开时间太长,redis集群就会启用新的主节点,之前发给主节点的数据聚会丢失。
上面的理论知识,在完成下面Reids主从复制环境和分布式环境的搭建后,相信会有非常直观的理解。
Redis主从复制集群安装
这里使用三台设备,环境说明如下:
uplooking01 master
uplooking02 slave
uplooking03 slave
即uplooking01为主节点,02和03为从节点,主节点主要负责写,从节点主要负责读,不能写。
另外在两台从服务器上还会配置使用密码,测试一下使用密码时的连接方式(注意主服务器没有设置密码)。
下面的配置会对这些需求有所体现。
uplooking01 redis.conf配置如下:
bind uplooking01
daemonize yes(后台运行)
logfile /opt/redis-3.2.0/logs/redis.log(日志文件,目录必须存在)
uplooking02 redis.conf配置如下:
bind uplooking02
daemonize yes(后台运行)
logfile /opt/redis-3.2.0/logs/redis.log(日志文件,目录必须存在)
slave-read-only yes
requirepass uplooking
slaveof uplooking01 6379
uplooking03 redis.conf配置如下:
bind uplooking03
daemonize yes(后台运行)
logfile /opt/redis-3.2.0/logs/redis.log(日志文件,目录必须存在)
slave-read-only yes
requirepass uplooking
slaveof uplooking01 6379
上面的配置完成后,在两台从服务器上分别启动redis即完成了主从复制集群的配置,需要注意如下问题:
1.认证的问题
如果需要连接uplooking02或者uplooking03,那么需要加上密码,否则无法完成认证。
有两种方式:
可以在连接时就指定密码:redis-cli -h uplooking03 -a uplooking
也可以先连接,到终端后再认证:auth uplooking
2.数据读写的问题
读:三台服务器上都能完成数据的读
写:只能在主节点上完成数据的写入
3.Java API的使用问题
在前面使用的代码中,如果连接的是从服务器,则还需要配置密码
以我们开发的JedisPool工具类为例,在创建JedisPool时需要指定密码:
jedisPool = new JedisPool(poolConfig, host, port, 10000, password);
Redis分布式集群安装部署
集群说明:
1.前面搭建的只是主从复制的集群,这意味着,数据在三台机器上都是一样的,其目的只是为了读写分离,提高读的效率
同时也可以起到冗余的作用,主节点一旦出现故障,从节点可以替换,但显然,这只是集群,而不是分布式。
2.但是可能会出现一个问题,就是当数据量过大时,所有的数据都保存在同一个节点上
(虽然两台做了备份,但因为保存的数据都是一样的,所以看做一个节点),
单台服务器的数据存储压力会很大,因此,可以考虑使用分布式的环境来保存,这就是Redis的分布式集群。
分布式:数据分成几份保存在不同的设备上
集群:对于相同的数据,都会有至少一个副本进行保存。
这可以类比hadoop中的hdfs或者是kafka中的partition(topic可以设置partition数量和副本因子)
3.在Redis中,搭建分布式集群环境至少需要6个节点,因此出于设备的考虑,这里会在同一台设备上操作
也就是说,这里搭建的是伪分布式环境,3个为主节点,另外3个分别为其从节点,用来保存其副本数据。
根据前面的理论知识,在分布式环境中,key值会进行如下的计算:
CRC16(16) % 16384
来计算key值属于哪一个槽,而对于我们的环境,每个主节点的槽位数量大概是16384 / 3 = 5461
1.解压安装包
[uplooking@uplooking01 ~]$ mkdir -p app/redis-cluster
[uplooking@uplooking01 ~]$ tar -zxvf soft/redis-3.2.0.tar.gz -C app/redis-cluster/
2.编译安装
[uplooking@uplooking01 ~]$ cd app/redis-cluster/redis-3.2.0/
[uplooking@uplooking01 redis-3.2.0]$ pwd
/home/uplooking/app/redis-cluster/redis-3.2.0
[uplooking@uplooking01 redis-3.2.0]$ make
[uplooking@uplooking01 redis-3.2.0]$ make install PREFIX=/home/uplooking/app/redis-cluster/redis-3.2.0
3.创建Redis节点
[uplooking@uplooking01 redis-cluster]$ mv redis-3.2.0/ 7000
[uplooking@uplooking01 redis-cluster]$ cp -r 7000 7001
[uplooking@uplooking01 redis-cluster]$ cp -r 7000 7002
[uplooking@uplooking01 redis-cluster]$ cp -r 7000 7003
[uplooking@uplooking01 redis-cluster]$ cp -r 7000 7004
[uplooking@uplooking01 redis-cluster]$ cp -r 7000 7005
4.修改各个节点的配置
以7000为例:
daemonize yes //配置redis后台运行
bind uplooking01 //绑定主机uplooking01
logfile "/home/uplooking/app/redis-cluster/7000/redis-7000.log" //注意目录要存在
pidfile /var/run/redis-7000.pid //pidfile文件对应7000,7002,7003
port 7000 //端口
cluster-enabled yes //开启集群 把注释#去掉
cluster-config-file nodes-7000.conf //集群的配置 配置文件首次启动自动生成
cluster-node-timeout 15000 //请求超时 设置15秒够了
appendonly yes //aof日志开启 有需要就开启,它会每次写操作都记录一条日志
在其它的节点上,只需要修改为7001,7002…即可。
技巧:配置完成7000后,可以直接复制到其它节点,cp redis.conf ../7001,然后再充分利用vim中的1,$s///g将7000替换为其它数字,如7001等。
5.启动各个节点
先创建一个批量启动的脚本:
[uplooking@uplooking01 redis-cluster]$ cat start-all.sh
#!/bin/bash
cd 7000
bin/redis-server ./redis.conf
cd ..
cd 7001
bin/redis-server ./redis.conf
cd ..
cd 7002
bin/redis-server ./redis.conf
cd ..
cd 7003
bin/redis-server ./redis.conf
cd ..
cd 7004
bin/redis-server ./redis.conf
cd ..
cd 7005
bin/redis-server ./redis.conf
cd ..
然后再执行脚本启动。
6.查看服务
[uplooking@uplooking01 redis-cluster]$ ps -ef | grep redis
500 1460 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7000 [cluster]
500 1464 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7001 [cluster]
500 1468 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7002 [cluster]
500 1472 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7003 [cluster]
500 1474 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7004 [cluster]
500 1480 1 0 01:17 ? 00:00:01 bin/redis-server uplooking01:7005 [cluster]
500 3233 1018 0 01:53 pts/0 00:00:00 grep redis
7.创建集群(核心)
现在就是要使用前面准备好的redis节点,将其串联起来搭建集群。官方提供了一个工具:redis-trib.rb($REDIS_HOME/src 使用ruby编写的一个程序,所以需要安装ruby):
$ sudo yum -y install ruby ruby-devel rubygems rpm-build
再用gem这个命令安装redis接口(gem是ruby的一个工具包):
gem install redis [ -v 3.2.0] #[]中为可选项制定具体的软件版本
# 在我安装时,提示ruby版本需要>=2.2.2,但是上面接上redis接口的版本后就没有问题了。
接下来运行一下redis-trib.rb:
[uplooking@uplooking01 7000]$ src/redis-trib.rb create --replicas 1 192.168.56.101:7000 192.168.56.101:7001 192.168.56.101:7002 192.168.56.101:7003 192.168.56.101:7004 192.168.56.101:7005
>>> Creating cluster
>>> Performing hash slots allocation on 6 nodes...
Using 3 masters:
192.168.56.101:7000
192.168.56.101:7001
192.168.56.101:7002
Adding replica 192.168.56.101:7003 to 192.168.56.101:7000
Adding replica 192.168.56.101:7004 to 192.168.56.101:7001
Adding replica 192.168.56.101:7005 to 192.168.56.101:7002
M: 497bce5118057198afb0511cc7b88479bb0c3938 192.168.56.101:7000
slots:0-5460 (5461 slots) master
M: f0568474acad5c707f25843add2d68455d2cbbb2 192.168.56.101:7001
slots:5461-10922 (5462 slots) master
M: ebe86ea74af5612e6393c8e5c5b3363928a4b7b2 192.168.56.101:7002
slots:10923-16383 (5461 slots) master
S: c99c55ab3fcea2d65ca3be5b4786390a6e463ea2 192.168.56.101:7003
replicates 497bce5118057198afb0511cc7b88479bb0c3938
S: 0a847801493a45d32487d701cd0fe37790d4b2f9 192.168.56.101:7004
replicates f0568474acad5c707f25843add2d68455d2cbbb2
S: 7f9e4bec579fda23a574a62d362a04463140bbc2 192.168.56.101:7005
replicates ebe86ea74af5612e6393c8e5c5b3363928a4b7b2
Can I set the above configuration? (type 'yes' to accept): yes
>>> Nodes configuration updated
>>> Assign a different config epoch to each node
>>> Sending CLUSTER MEET messages to join the cluster
Waiting for the cluster to join......
>>> Performing Cluster Check (using node 192.168.56.101:7000)
M: 497bce5118057198afb0511cc7b88479bb0c3938 192.168.56.101:7000
slots:0-5460 (5461 slots) master
M: f0568474acad5c707f25843add2d68455d2cbbb2 192.168.56.101:7001
slots:5461-10922 (5462 slots) master
M: ebe86ea74af5612e6393c8e5c5b3363928a4b7b2 192.168.56.101:7002
slots:10923-16383 (5461 slots) master
M: c99c55ab3fcea2d65ca3be5b4786390a6e463ea2 192.168.56.101:7003
slots: (0 slots) master
replicates 497bce5118057198afb0511cc7b88479bb0c3938
M: 0a847801493a45d32487d701cd0fe37790d4b2f9 192.168.56.101:7004
slots: (0 slots) master
replicates f0568474acad5c707f25843add2d68455d2cbbb2
M: 7f9e4bec579fda23a574a62d362a04463140bbc2 192.168.56.101:7005
slots: (0 slots) master
replicates ebe86ea74af5612e6393c8e5c5b3363928a4b7b2
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.
仔细查看其提示,会对Redis分布式集群有一个更加清晰的理解。另外需要注意的是,由于redis-trib.rb 对域名或主机名支持不好,故在创建集群的时候要使用ip:port的方式。
8.测试
[uplooking@uplooking01 7000]$ bin/redis-cli -h uplooking01 -p 7000 -c
uplooking01:7000> set name xpleaf
-> Redirected to slot [5798] located at 192.168.56.101:7001
OK
192.168.56.101:7001> get name
"xpleaf"
192.168.56.101:7001>
[uplooking@uplooking01 7000]$ bin/redis-cli -h uplooking01 -p 7004 -c
uplooking01:7004> get name
-> Redirected to slot [5798] located at 192.168.56.101:7001
"xpleaf"
192.168.56.101:7001>
[uplooking@uplooking01 7000]$ bin/redis-cli -h uplooking01 -p 7004 -c
uplooking01:7004> set name yyh
-> Redirected to slot [5798] located at 192.168.56.101:7001
OK
192.168.56.101:7001> get name
"yyh"
[uplooking@uplooking01 7000]$ bin/redis-cli -h uplooking01 -p 7002 -c
uplooking01:7002> keys *
(empty list or set)
uplooking01:7002> get name
-> Redirected to slot [5798] located at 192.168.56.101:7001
"yyh"
上面的测试可以充分说明下面几个问题:
1.分布式
数据是分布式存储的,根据key的不同会保存到不同的主节点上。
2.数据备份
从节点是作为备份节点的,跟前面的主从复制集群一样,只是用来读数据,当需要写或修改数据时,需要切换到主节点上。
Redis Java API使用(二):Cluster API使用
前面的代码只适合操作单机版本的Redis,如果使用的是分布式的Redis集群,那么就需要修改一下代码,这里,我们直接开发一个工具类JedisClusterUtil,如下:
package com.uplooking.bigdata.common.util.redis;
import redis.clients.jedis.*;
import java.io.IOException;
import java.util.HashSet;
import java.util.Properties;
import java.util.Set;
/**
* Redis Java API 操作的工具类
* 专门负责redis的cluster模式
*/
public class JedisClusterUtil {
private JedisClusterUtil() {}
private static JedisCluster jedisCluster;
static {
Set nodes = new HashSet();
nodes.add(new HostAndPort("uplooking01", 7000));
nodes.add(new HostAndPort("uplooking01", 7001));
nodes.add(new HostAndPort("uplooking01", 7002));
nodes.add(new HostAndPort("uplooking01", 7003));
nodes.add(new HostAndPort("uplooking01", 7004));
nodes.add(new HostAndPort("uplooking01", 7005));
jedisCluster = new JedisCluster(nodes);//得到的是redis的集群模式
}
/**
* 提供了Jedis的对象
* @return
*/
public static JedisCluster getJedis() {
return jedisCluster;
}
/**
* 资源释放
* @param jedis
*/
public static void returnJedis(JedisCluster jedis) {
try {
jedis.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
在使用时需要注意的是,JedisCluster在使用mget等API操作时,是不允许同时在多个节点上获取数据的,例如:List mget = jedis.mget("name", "age");,如果name和age分别在不同的节点上,则会报异常,所以不建议使用此种方式来获取数据。