Jedis使用教程完整版

最新推荐文章于 2023-06-06 14:17:37 发布
转载 最新推荐文章于 2023-06-06 14:17:37 发布 · 169 阅读 · 0 ·
CC 4.0 BY-SA版权
原文链接：https://my.oschina.net/dolphinboy/blog/1531403
文章标签：

#数据库 #python #java

本文详细介绍Jedis作为Redis官方推荐的Java客户端工具的使用方法，包括基本操作、连接池配置、高可用连接、客户端分片等内容。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

概述

Jedis是Redis官方推荐的Java连接开发工具。要在Java开发中使用好Redis中间件，必须对Jedis熟悉才能写成漂亮的代码。这篇文章不描述怎么安装Redis和Reids的命令，只对Jedis的使用进行对介绍。

1240

1. 基本使用

Jedis的基本使用非常简单，只需要创建Jedis对象的时候指定host，port, password即可。当然，Jedis对象又很多构造方法，都大同小异，只是对应和Redis连接的socket的参数不一样而已。

Jedis jedis = new Jedis("localhost", 6379);  //指定Redis服务Host和port
jedis.auth("xxxx"); //如果Redis服务连接需要密码，制定密码
String value = jedis.get("key"); //访问Redis服务
jedis.close(); //使用完关闭连接

Jedis基本使用十分简单，在每次使用时，构建Jedis对象即可。在Jedis对象构建好之后，Jedis底层会打开一条Socket通道和Redis服务进行连接。所以在使用完Jedis对象之后，需要调用Jedis.close()方法把连接关闭，不如会占用系统资源。当然，如果应用非常平凡的创建和销毁Jedis对象，对应用的性能是很大影响的，因为构建Socket的通道是很耗时的(类似数据库连接)。我们应该使用连接池来减少Socket对象的创建和销毁过程。

2. 连接池使用

Jedis连接池是基于apache-commons pool2实现的。在构建连接池对象的时候，需要提供池对象的配置对象，及JedisPoolConfig(继承自GenericObjectPoolConfig)。我们可以通过这个配置对象对连接池进行相关参数的配置(如最大连接数，最大空数等)。

JedisPoolConfig config = new JedisPoolConfig();
config.setMaxIdle(8);
config.setMaxTotal(18);
JedisPool pool = new JedisPool(config, "127.0.0.1", 6379, 2000, "password");
Jedis jedis = pool.getResource();
String value = jedis.get("key");
......
jedis.close();
pool.close();

使用Jedis连接池之后，在每次用完连接对象后一定要记得把连接归还给连接池。Jedis对close方法进行了改造，如果是连接池中的连接对象，调用Close方法将会是把连接对象返回到对象池，若不是则关闭连接。可以查看如下代码

@Override
public void close() { //Jedis的close方法
    if (dataSource != null) {
        if (client.isBroken()) {
            this.dataSource.returnBrokenResource(this);
        } else {
            this.dataSource.returnResource(this);
        }
    } else {
        client.close();
    }
}

//另外从对象池中获取Jedis链接时，将会对dataSource进行设置
// JedisPool.getResource()方法
public Jedis getResource() {
    Jedis jedis = super.getResource();   
    jedis.setDataSource(this);
    return jedis;
}

3. 高可用连接

我们知道，连接池可以大大提高应用访问Reids服务的性能，减去大量的Socket的创建和销毁过程。但是Redis为了保障高可用，服务一般都是Sentinel部署方式(可以查看我的文章详细了解)。当Redis服务中的主服务挂掉之后，会仲裁出另外一台Slaves服务充当Master。这个时候，我们的应用即使使用了Jedis连接池，Master服务挂了，我们的应用奖还是无法连接新的Master服务。为了解决这个问题，Jedis也提供了相应的Sentinel实现，能够在Redis Sentinel主从切换时候，通知我们的应用，把我们的应用连接到新的 Master服务。先看下怎么使用。

注意：Jedis版本必须2.4.2或更新版本

Set<String> sentinels = new HashSet<>();
sentinels.add("172.18.18.207:26379");
sentinels.add("172.18.18.208:26379");
JedisPoolConfig config = new JedisPoolConfig();
config.setMaxIdle(5);
config.setMaxTotal(20);
JedisSentinelPool pool = new JedisSentinelPool("mymaster", sentinels, config);
Jedis jedis = pool.getResource();
jedis.set("jedis", "jedis");
......
jedis.close();
pool.close();

Jedis Sentinel的使用也是十分简单的，只是在JedisPool中添加了Sentinel和MasterName参数。Jedis Sentinel底层基于Redis订阅实现Redis主从服务的切换通知。当Reids发生主从切换时，Sentinel会发送通知主动通知Jedis进行连接的切换。JedisSentinelPool在每次从连接池中获取链接对象的时候，都要对连接对象进行检测，如果此链接和Sentinel的Master服务连接参数不一致，则会关闭此连接，重新获取新的Jedis连接对象。

public Jedis getResource() {
    while (true) {
        Jedis jedis = super.getResource();
        jedis.setDataSource(this);

        // get a reference because it can change concurrently
        final HostAndPort master = currentHostMaster;
        final HostAndPort connection = new HostAndPort(jedis.getClient().getHost(), jedis.getClient().getPort());
        if (master.equals(connection)) {
            // connected to the correct master
            return jedis;
        } else {
            returnBrokenResource(jedis);
        }
    }
}

当然，JedisSentinelPool对象要时时监控RedisSentinel的主从切换。在其内部通过Reids的订阅实现。具体的实现看JedisSentinelPool的两个方法就很清晰

private HostAndPort initSentinels(Set<String> sentinels, final String masterName) {
    HostAndPort master = null;
    boolean sentinelAvailable = false;
    log.info("Trying to find master from available Sentinels...");
    for (String sentinel : sentinels) {
        final HostAndPort hap = HostAndPort.parseString(sentinel);
        log.fine("Connecting to Sentinel " + hap);
        Jedis jedis = null;
        try {
            jedis = new Jedis(hap.getHost(), hap.getPort());
            //从RedisSentinel中获取Master信息
            List<String> masterAddr = jedis.sentinelGetMasterAddrByName(masterName);
            sentinelAvailable = true; // connected to sentinel...
            if (masterAddr == null || masterAddr.size() != 2) {
                log.warning("Can not get master addr, master name: " + masterName + ". Sentinel: " + hap + ".");
                continue;
            }
            master = toHostAndPort(masterAddr);
            log.fine("Found Redis master at " + master);
            break;
        } catch (JedisException e) {
            // it should handle JedisException there's another chance of raising JedisDataException
            log.warning("Cannot get master address from sentinel running @ " + hap + ". Reason: " + e + ". Trying next one.");
        } finally {
            if (jedis != null) {
                jedis.close();
            }
        }
    }
    if (master == null) {
        if (sentinelAvailable) {
            // can connect to sentinel, but master name seems to not monitored
            throw new JedisException("Can connect to sentinel, but " + masterName + " seems to be not monitored...");
        } else {
            throw new JedisConnectionException("All sentinels down, cannot determine where is " + masterName + " master is running...");
        }
    }
    log.info("Redis master running at " + master + ", starting Sentinel listeners...");
    //启动后台线程监控RedisSentinal的主从切换通知
    for (String sentinel : sentinels) {
        final HostAndPort hap = HostAndPort.parseString(sentinel);
        MasterListener masterListener = new MasterListener(masterName, hap.getHost(), hap.getPort());
        // whether MasterListener threads are alive or not, process can be stopped
        masterListener.setDaemon(true);
        masterListeners.add(masterListener);
        masterListener.start();
    }
    return master;
}


private void initPool(HostAndPort master) {
    if (!master.equals(currentHostMaster)) {
        currentHostMaster = master;
        if (factory == null) {
            factory = new JedisFactory(master.getHost(), master.getPort(), connectionTimeout, soTimeout, password, database, clientName, false, null, null, null);
            initPool(poolConfig, factory);
        } else {
            factory.setHostAndPort(currentHostMaster);
            // although we clear the pool, we still have to check the returned object
            // in getResource, this call only clears idle instances, not
            // borrowed instances
            internalPool.clear();
        }
        log.info("Created JedisPool to master at " + master);
    }
}

可以看到，JedisSentinel的监控时使用MasterListener这个对象来实现的。看对应源码可以发现是基于Redis的订阅实现的，其订阅频道为"+switch-master"。当MasterListener接收到switch-master消息时候，会使用新的Host和port进行initPool。这样对连接池中的连接对象清除，重新创建新的连接指向新的Master服务。

4. 客户端分片

对于大应用来说，单台Redis服务器肯定满足不了应用的需求。在Redis3.0之前，是不支持集群的。如果要使用多台Reids服务器，必须采用其他方式。很多公司使用了代理方式来解决Redis集群。对于Jedis，也提供了客户端分片的模式来连接“Redis集群”。其内部是采用Key的一致性hash算法来区分key存储在哪个Redis实例上的。

JedisPoolConfig config = new JedisPoolConfig();
config.setMaxTotal(500);
config.setTestOnBorrow(true);
List<JedisShardInfo> jdsInfoList = new ArrayList<>(2);
jdsInfoList.add(new JedisShardInfo("192.168.2.128", 6379));
jdsInfoList.add(new JedisShardInfo("192.168.2.108", 6379));
pool = new ShardedJedisPool(config, jdsInfoList, Hashing.MURMUR_HASH, Sharded.DEFAULT_KEY_TAG_PATTERN);
jds.set(key, value);
......
jds.close();
pool.close();

当然，采用这种方式也存在两个问题

  1. 扩容问题：
    因为使用了一致性哈稀进行分片，那么不同的key分布到不同的Redis-Server上，当我们需要扩容时，需要增加机器到分片列表中，这时候会使得同样的key算出来落到跟原来不同的机器上，这样如果要取某一个值，会出现取不到的情况。
  2. 单点故障问题：
    当集群中的某一台服务挂掉之后，客户端在根据一致性hash无法从这台服务器取数据。

对于扩容问题，Redis的作者提出了一种名为Pre-Sharding的方式。即事先部署足够多的Redis服务。
对于单点故障问题，我们可以使用Redis的HA高可用来实现。利用Redis-Sentinal来通知主从服务的切换。当然，Jedis没有实现这块。我将会在下一篇文章进行介绍。

5. 小结

对于Jedis的基本使用还是很简单的。要根据不用的应用场景选择对于的使用方式。
另外，Spring也提供了Spring-data-redis包来整合Jedis的操作，另外Spring也单独分装了Jedis(我将会在另外一篇文章介绍)。



作者：曹金桂
链接：http://www.jianshu.com/p/a1038eed6d44
來源：简书

转载于:https://my.oschina.net/dolphinboy/blog/1531403

jedisLock—redis分布式锁实现，java基础教程第三版
m0_64384302的博客
12-13 292
SETNX key value 将 key 的值设为 value ，当且仅当 key 不存在。 若给定的 key 已经存在，则 SETNX 不做任何动作。 SETNX 是『SET if Not eXists』(如果不存在，则 SET)的简写 返回值： 设置成功，返回  1 。 设置失败，返回  0 。 例子： redis> EXISTS job
Redis实战-Jedis使用指南
热门推荐
Ricky
05-01 1万+
概述Redis是一个开源的、高效的key-value存储系统，也是nosql中的最常见的一种。redis非常适合用来做缓存系统，关于Redis的详细介绍可以查看Redis官方documentation。Redis支持多语言的调用，官方推荐的Java版客户端是Jedis，它非常强大和稳定，支持事务、管道及有Jedis自身实现。我们对Redis数据的操作，都可以通过Jedis来完成。使用教程 1、配置
jedis使用指南
07-13
Jedis使用总结 前段时间细节的了解了Jedis的使用，Jedis是redis的java版本的客户端实现。 本文做个总结，主要分享如下内容： 【pipeline】【分布式的id生成器】【分布式锁【watch】【multi】】【redis分布式】 好了，一个一个来。 一、 Pipeline 官方的说明是：starts a pipeline,which is a very efficient way to send lots of command and read all the responses when you finish sending them。简单点说pipeline适用于批处理。当有大量的操作需要一次性执行的时候，可以用管道。 示例： Jedis jedis = new Jedis(String, int); Pipeline p = jedis.pipelined(); p.set(key,value);//每个操作都发送请求给redis-server p.get(key,value); p.sync();//这段代码获取所有的response 这里我进行了20w次连续操作（10w读，10w写），不用pipeline耗时：187242ms，用pipeline耗时：1188ms，可见使用管道后的性能上了一个台阶。看了代码了解到，管道通过一次性写入请求，然后一次性读取响应。也就是说jedis是：request response，request response，...；pipeline则是：request request... response response的方式。这样无需每次请求都等待server端的响应。 二、 跨jvm的id生成器 谈到这个话题，首先要知道redis-server端是单线程来处理client端的请求的。 这样来实现一个id生成器就非常简单了，只要简单的调用jdeis.incr(key);就搞定了。 你或许会问，incr是原子操作吗，能保证不会出现并发问题吗，不是说了吗，server端是单线程处理请求的。 三、 【跨jvm的锁实现【watch】【multi】】 首先说下这个问题的使用场景，有些时候我们业务逻辑是在不同的jvm进程甚至是不同的物理机上的jvm处理的。这样如何来实现不同jvm上的同步问题呢，其实我们可以基于redis来实现一个锁。 具体事务和监听请参考文章：redis学习笔记之事务 暂时找到三种实现方式： 1. 通过jedis.setnx(key,value)实现 import java.util.Random; import org.apache.commons.pool.impl.GenericObjectPool.Config; import redis.clients.jedis.Jedis; import redis.clients.jedis.JedisPool; import redis.clients.jedis.Transaction; /** * @author Teaey */ public class RedisLock { //加锁标志 public static final String LOCKED = "TRUE"; public static final long ONE_MILLI_NANOS = 1000000L; //默认超时时间（毫秒） public static final long DEFAULT_TIME_OUT = 3000; public static JedisPool pool; public static final Random r = new Random(); //锁的超时时间（秒），过期删除 public static final int EXPIRE = 5 * 60; static { pool = new JedisPool(new Config(), "host", 6379); } private Jedis jedis; private String key; //锁状态标志 private boolean locked = false; public RedisLock(String key) { this.key = key; this.jedis = pool.getResource(); } public boolean lock(long timeout) { long nano = System.nanoTime(); timeout *= ONE_MILLI_NANOS; try { while ((System.nanoTime() - nano) < timeout) { if (jedis.setnx(key, LOCKED) == 1) { jedis.expire(key, EXPIRE); locked = true; return locked; } // 短暂休眠，nano避免出现活锁 Thread.sleep(3, r.nextInt(500)); } } catch (Exception e) { } return false; } public boolean lock() { return lock(DEFAULT_TIME_OUT); } // 无论是否加锁成功，必须调用 public void unlock() { try { if (locked) jedis.del(key); } finally { pool.returnResource(jedis); } } } 2. 通过事务(multi)实现 由于采纳第一张方法，第二种跟第三种实现只贴了关键代码，望谅解。^_^ public boolean lock_2(long timeout) { long nano = System.nanoTime(); timeout *= ONE_MILLI_NANOS; try { while ((System.nanoTime() - nano) < timeout) { Transaction t = jedis.multi(); // 开启事务，当server端收到multi指令 // 会将该client的命令放入一个队列，然后依次执行，知道收到exec指令 t.getSet(key, LOCKED); t.expire(key, EXPIRE); String ret = (String) t.exec().get(0); if (ret == null || ret.equals("UNLOCK")) { return true; } // 短暂休眠，nano避免出现活锁 Thread.sleep(3, r.nextInt(500)); } } catch (Exception e) { } return false; } 3. 通过事务+监听实现 public boolean lock_3(long timeout) { long nano = System.nanoTime(); timeout *= ONE_MILLI_NANOS; try { while ((System.nanoTime() - nano) < timeout) { jedis.watch(key); // 开启watch之后，如果key的值被修改，则事务失败，exec方法返回null String value = jedis.get(key); if (value == null || value.equals("UNLOCK")) { Transaction t = jedis.multi(); t.setex(key, EXPIRE, LOCKED); if (t.exec() != null) { return true; } } jedis.unwatch(); // 短暂休眠，nano避免出现活锁 Thread.sleep(3, r.nextInt(500)); } } catch (Exception e) { } return false; } 最终采用第一种实现，因为加锁只需发送一个请求，效率最高。 四、 【redis分布式】 最后一个话题，jedis的分布式。在jedis的源码里发现了两种hash算法（MD5，MURMUR Hash(默认）），也可以自己实现redis.clients.util.Hashing接口扩展。 List hosts = new ArrayList(); //server1 JedisShardInfo host1 = new JedisShardInfo("", 6380, 2000); //server2 JedisShardInfo host2 = new JedisShardInfo("", 6381, 2000); hosts.add(host1); hosts.add(host2); ShardedJedis jedis = new ShardedJedis(hosts); jedis.set("key", "");
Jedis使用指南
持之以恒！
07-14 6692
简介 Jedis Client是Redis官网推荐的一个面向java客户端，库文件实现了对各类API进行封装调用。 Jedis源码工程地址： https://github.com/xetorthio/jedis 使用 想要使用Jedis必须加载jar包或者添加maven依赖，jar包可以自己上网下载，我的是Maven项目，所以在pom.xml中增加如下语句： &lt;dependenc...
jedis使用
404 NOT FOUND
08-21 1432
jedis是官方首选的java客户端开发包 Github地址:https://github.com/xetorthio/jedis 下载 jedis-xxx.jar  (http://mvnrepository.com/artifact/redis.clients/jedis) 下载 commons-poolx.x.x.jar (http://mvnrepository.com/artifa
jedis使用教程
ITzhongzi的博客
02-12 737
前言： 在使用 jedis之前需要在项目中引入 commons-poolx-x.x.jar 和 jedis-x.x.x.jar 工具包 获取单一jedis的操作对象 @Test // 获得单一的jedis对象操作数据库 public void test1(){ // 1、获得连接对象 Jedis jedis = new Jedis("192...
Jedis的使用
Anntly的博客
08-31 431
参考地址: https://blog.youkuaiyun.com/qq_26525215/article/details/60466222 jedis的使用 由于使用的是Maven项目,首先要导入jedis和junit的依赖 &lt;dependency&gt; &lt;groupId&gt;redis.clients&lt;/groupId&gt; &lt;art...
Jedis 2.x 使用教程：关键特性与对象池配置
Jedis作为Redis的Java客户端，完全实现了Redis的所有命令接口。通过Jedis，你可以执行各种操作，如设置和获取键值、管理哈希表、列表、集合、有序集合等。例如，设置主从关系可以通过`jedis.slaveOf()`方法实现，如...
Redis Sentinel主从高可用方案与JedisSentinel教程
"Redis Sentinel主从高可用方案与JedisSentinel教程" Redis Sentinel是Redis提供的高可用性（HA）解决方案，旨在确保Redis服务在主节点出现故障时能够自动恢复，从而保持系统的不间断运行。Sentinel系统由一个或多...
单机中 Jedis 的使用
最新发布
06-18
首先，用户的问题是：“我想了解如何在单机环境下使用Jedis请问Jedis单机环境使用教程”。所以，我需要专注于Jedis在单机环境下的使用教程。根据系统级指令：-所有行内数学表达式使用$...$格式。-独立公式使用$$...$...
Jedis使用教程详解
怪咖@的博客
06-06 1万+
Jedis是Redis的一款Java语言的开源客户端连接工具，什么是客户端？就是真正使用者，像我们安装Redis的时候都会有一个redis-cli这其实就是Redis提供的一个基于操作系统（linux、windows）的客户端。也就是真正使用者是电脑，电脑通过这个客户端可以连接Redis并操作Redis。Jedis同理，他的真正使用者是Java，Java语言可以通过Jedis来连接Redis并操作Redis。，其中Jedis是最基础的客户端，他只是将Redis的所有命令封装成了Java可直接调用的方法。
jedis的基本使用
...
04-21 2465
jedis是使用java来操作redis的中间件。 首先创建maven项目，导入jedis依赖。 public static void main(String[] args) { // 1. 创建Jedis对象 Jedis jedis = new Jedis("127.0.0.1", 6379); // jedis所有方法就是redis的所有命令 // 测试链接 System.out.println(jedis.ping()); } jedis的部分API示例： //清空数据 jedis.flu
Jedis的基本操作方法
游王子og的博客
10-20 4949
一、Jedis介绍 jedis 是 redis推荐的java客户端。通过Jedis我们可以很方便地使用java代码的方式，对redis进行操作。jedis使用起来比较简单，它的操作方法与redis命令相类似。对于初次使用redis的人来说，上手更快，更能适应。本例子使用maven，需要添加如下依赖： <!-- https://mvnrepository.com/arti...
jedis的操作和使用
GeminiXin的博客
07-28 5510
jedis 是 Redis 官方推荐的Java连接开发工具；使用 Java 操作 redis 中间件；在企业中用的最多的就是Jedis。Jedis提供了完整Redis命令，而Redisson有更多分布式的容器实现。 如果使用jedis操作redis，那么需要对redis基本操作命令要十分熟悉； 对redis命令不熟悉的看这里：https://blog.youkuaiyun.com/weixin_44890938/article/details/118909055?spm=1001.2014.3001.5501 导入对
jedis的使用
weixin_38577781的博客
10-18 351
jedis 1.定义： jedis其实就是java所编写的Redis的一个客户端工具。（其实就是用java来编写代码从而实现redis的客户端） 2.如何使用： 1.导入jar包： commons-pool2-2.3.jar， jedis-2.7.0.jar    2.写程序： 例1：创建一个简单的连接 @Test public void testJedis(){
Jedis的使用说明
jonathan的专栏
07-08 2442
Jedis 是 Redis 官方首选的 Java 客户端开发包。使用Jedis提供的Java API对Redis进行操作，是Redis官方推崇的方式；并且，使用Jedis提供的对Redis的支持也最为灵活、全面；不足之处，就是编码复杂度较高。
Jedis使用
攀登Fox的博客
09-14 124
目录一、简单连接二、整合spring 一、简单连接 package com.example.demo.utils.jedis; import redis.clients.jedis.HostAndPort; import redis.clients.jedis.Jedis; import redis.clients.jedis.JedisCluster; import redis.clients.jedis.JedisPool; import java.util.HashSet; import java
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值