Jedis 使用详解(官方原版)

本文涉及的产品
云数据库 Tair(兼容Redis),内存型 2GB
Redis 开源版,标准版 2GB
推荐场景:
搭建游戏排行榜
简介: Jedis 使用详解(官方原版)

一、配置 Maven 依赖项

Jedis也通过Sonatype作为Maven Dependency 分发。要配置它,只需将以下 XML 代码段添加到您的 pom.xml 文件中。

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>2.9.0</version>
    <type>jar</type>
    <scope>compile</scope>
</dependency>

image.gif

二、基本用法示例

1、在多线程环境中使用 Jedis

您不应该使用来自不同线程的同一实例,因为会出现奇怪的错误。有时创建大量Jedis实例还不够好,因为这意味着大量的套接字和连接,这也会导致奇怪的错误。单个Jedis实例不是线程安全的!为了避免这些问题,您应该使用JedisPool,这是一个线程安全的网络连接池。如果完成后将Jedis实例返回到池中,则可以使用池可靠地创建多个Jedis示例。通过这种方式,您可以克服这些奇怪的错误并获得出色的性能。

要使用它,请初始化一个池:

JedisPool pool = new JedisPool(new JedisPoolConfig(), "localhost");

image.gif

您可以将池静态存储在某个位置,它是线程安全的。

JedisPoolConfig 包括许多有用的 Redis 特定连接池默认值。JedisPool基于Commons Pool 2,所以你可能想看看Commons Pool的配置

您可以通过以下方式使用它:

/// Jedis implements Closeable. 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);
}
/// ... when closing your application:
pool.close();

image.gif

如果您不能在资源中使用try,您仍然可以使用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 {
  // You have to close jedis object. If you don't close then
  // it doesn't release back to pool and you can't get a new
  // resource from pool.
  if (jedis != null) {
    jedis.close();
  }
}
/// ... when closing your application:
pool.close();

image.gif

如果 Jedis 是从池中借来的,它将以正确的方法返回到池中,因为它已经确定发生了 JedisConnectionException。 如果 Jedis 不是从池中借来的,它将被断开并关闭。

2、设置主/从分配

启用复制

Redis 主要用于主/从分发。这意味着写入请求必须显式发送到主服务器(redis 服务器),后者将更改复制到从服务器(也是 redis 服务器)。然后,读取请求可以(但不一定)发送给从站,从而减轻了主站的负担。

您可以使用主控形状,如上所示。为了启用复制,有两种方法可以告诉从站它将是给定主服务器的“slaveOf”:

    • 在 Redis 服务器的 Redis 配置文件的相应部分中指定它
    • 在给定的 jedis 实例上(见上文),调用 slaveOf 方法并将 IP(或“localhost”)和端口作为参数传递:
    jedis.slaveof("localhost", 6379);  //  if the master is on the same PC which runs your code
    jedis.slaveof("192.168.1.35", 6379);

    image.gif

    注意:由于 Redis 2.6 从站默认为只读,因此对它们的写入请求将导致错误。

    如果您更改该设置,它们的行为将像普通的 redis 服务器一样,并接受写入请求而不会出错,但更改不会被复制,因此,如果您混合使用 jedis 实例,这些更改有被静默覆盖的风险。

    禁用复制/主服务器出现故障时,升级从属服务器

    万一你的主人倒下了,你可能想提拔一个奴隶成为新的主人。您应该首先(尝试)首先禁用脱机主服务器的复制,然后,如果您有多个从站,请启用剩余从站到新主站的复制:

    slave1jedis.slaveofNoOne();
    slave2jedis.slaveof("192.168.1.36", 6379);

    image.gif

    三、高级用法

    1、事务

    要在Jedis中执行事务,必须将操作包装在事务块中,这与pipelining非常类似:

    jedis.watch (key1, key2, ...);
    Transaction t = jedis.multi();
    t.set("foo", "bar");
    t.exec();

    image.gif

    注意:当你有任何返回值的方法时,你必须这样做:

    Transaction t = jedis.multi();
    t.set("fool", "bar"); 
    Response<String> result1 = t.get("fool");
    t.zadd("foo", 1, "barowitch"); t.zadd("foo", 0, "barinsky"); t.zadd("foo", 0, "barikoviev");
    Response<Set<String>> sose = t.zrange("foo", 0, -1);   // get the entire sortedset
    t.exec();                                              // dont forget it
    String foolbar = result1.get();                       // use Response.get() to retrieve things from a Response
    int soseSize = sose.get().size();                      // on sose.get() you can directly call Set methods!
    // List<Object> allResults = t.exec();                 // you could still get all results at once, as before

    image.gif

    请注意,响应对象不包含调用 t.exec() 之前的结果(它是一种未来)。忘记执行会给你例外。在最后一行中,您将看到在版本 2 之前如何处理事务/管道。您仍然可以这样做,但随后您需要从列表中提取对象,该列表还包含 Redis 状态消息。

    注 2:Redis 不允许在同一事务中使用事务的中间结果。这不起作用:

    // this does not work! Intra-transaction dependencies are not supported by Redis!
    jedis.watch(...);
    Transaction t = jedis.multi();
    if(t.get("key1").equals("something"))
       t.set("key2", "value2");
    else 
       t.set("key", "value");

    image.gif

    但是,有一些命令(如setnx)包含此类条件执行。这些当然在事务中得到支持。您可以使用 eval/ LUA 脚本构建自己的自定义命令。

    2、Pipelining

    有时您需要发送一系列不同的命令。一种非常酷的方法是使用Pipelining,它比简单的方法具有更好的性能。这样,您就可以发送命令而无需等待响应,而且您实际上可以在最后读取响应,这会更快。

    Pipeline p = jedis.pipelined();
    p.set("fool", "bar"); 
    p.zadd("foo", 1, "barowitch");  p.zadd("foo", 0, "barinsky"); p.zadd("foo", 0, "barikoviev");
    Response<String> pipeString = p.get("fool");
    Response<Set<String>> sose = p.zrange("foo", 0, -1);
    p.sync(); 
    int soseSize = sose.get().size();
    Set<String> setBack = sose.get();

    image.gif

    3、发布/订阅

    要在 Redis 中订阅频道,请创建一个 JedisPubSub 实例并在 Jedis 实例上调用订阅:

    class MyListener extends JedisPubSub {
            public void onMessage(String channel, String message) {
            }
            public void onSubscribe(String channel, int subscribedChannels) {
            }
            public void onUnsubscribe(String channel, int subscribedChannels) {
            }
            public void onPSubscribe(String pattern, int subscribedChannels) {
            }
            public void onPUnsubscribe(String pattern, int subscribedChannels) {
            }
            public void onPMessage(String pattern, String channel, String message) {
            }
    }
    MyListener l = new MyListener();
    jedis.subscribe(l, "foo");

    image.gif

    请注意,订阅是一个阻塞操作,因为它将轮询 Redis 以获取调用订阅的线程上的响应。单个 JedisPubSub 实例可用于订阅多个频道。您可以在现有的 JedisPubSub 实例上调用订阅或订阅来更改您的订阅。



    Doker 做好产品,做暖心服务的数码品牌!!!

    文章下方有交流学习区!一起学习进步!也可以前往官网,加入官方微信交流群!!!

    你的支持和鼓励是我创作的动力❗❗❗

    官网:Doker 多克; 官方旗舰店首页-Doker 多克官方旗舰店 全品优惠

    相关实践学习
    基于Redis实现在线游戏积分排行榜
    本场景将介绍如何基于Redis数据库实现在线游戏中的游戏玩家积分排行榜功能。
    云数据库 Redis 版使用教程
    云数据库Redis版是兼容Redis协议标准的、提供持久化的内存数据库服务,基于高可靠双机热备架构及可无缝扩展的集群架构,满足高读写性能场景及容量需弹性变配的业务需求。 产品详情:https://www.aliyun.com/product/kvstore &nbsp; &nbsp; ------------------------------------------------------------------------- 阿里云数据库体验:数据库上云实战 开发者云会免费提供一台带自建MySQL的源数据库&nbsp;ECS 实例和一台目标数据库&nbsp;RDS实例。跟着指引,您可以一步步实现将ECS自建数据库迁移到目标数据库RDS。 点击下方链接,领取免费ECS&amp;RDS资源,30分钟完成数据库上云实战!https://developer.aliyun.com/adc/scenario/51eefbd1894e42f6bb9acacadd3f9121?spm=a2c6h.13788135.J_3257954370.9.4ba85f24utseFl
    目录
    相关文章
    |
    网络协议 NoSQL Java
    Jedis介绍及常见问题分析
    本文主要介绍Jedis的使用方法及常见问题的排查分析方法
    12997 1
    |
    XML NoSQL Java
    Redis - 一篇走心的 RedisUtil 工具类
    Redis - 一篇走心的 RedisUtil 工具类
    3659 0
    Redis - 一篇走心的 RedisUtil 工具类
    |
    5月前
    |
    消息中间件 存储 NoSQL
    java连接redis和基础操作命令
    通过以上内容,您可以掌握在Java中连接Redis以及进行基础操作的基本方法,进而在实际项目中灵活应用。
    257 30
    |
    9月前
    |
    存储 NoSQL Java
    Jedis客户端介绍
    【10月更文挑战第12天】
    |
    10月前
    |
    JSON NoSQL Java
    redis的java客户端的使用(Jedis、SpringDataRedis、SpringBoot整合redis、redisTemplate序列化及stringRedisTemplate序列化)
    这篇文章介绍了在Java中使用Redis客户端的几种方法,包括Jedis、SpringDataRedis和SpringBoot整合Redis的操作。文章详细解释了Jedis的基本使用步骤,Jedis连接池的创建和使用,以及在SpringBoot项目中如何配置和使用RedisTemplate和StringRedisTemplate。此外,还探讨了RedisTemplate序列化的两种实践方案,包括默认的JDK序列化和自定义的JSON序列化,以及StringRedisTemplate的使用,它要求键和值都必须是String类型。
    redis的java客户端的使用(Jedis、SpringDataRedis、SpringBoot整合redis、redisTemplate序列化及stringRedisTemplate序列化)
    |
    缓存 监控 Java
    如何在 Java 8 中创建和使用线程池?
    【7月更文挑战第8天】
    619 9
    如何在 Java 8 中创建和使用线程池?
    |
    Kubernetes Nacos 开发者
    Nacos 官网重大升级,提供官方发行版下载包,3.0 里程碑版本新特性预告
    Nacos 官网重大升级,提供官方发行版下载包,3.0 里程碑版本新特性预告
    1607 88
    |
    11月前
    |
    SQL Prometheus 监控
    实时计算 Flink版产品使用问题之作业频繁重启该如何处理
    实时计算Flink版作为一种强大的流处理和批处理统一的计算框架,广泛应用于各种需要实时数据处理和分析的场景。实时计算Flink版通常结合SQL接口、DataStream API、以及与上下游数据源和存储系统的丰富连接器,提供了一套全面的解决方案,以应对各种实时计算需求。其低延迟、高吞吐、容错性强的特点,使其成为众多企业和组织实时数据处理首选的技术平台。以下是实时计算Flink版的一些典型使用合集。
    |
    缓存 网络协议 Serverless
    阿里云CDN简介和使用流程
    本文档介绍了如何在阿里云上配置和使用CDN服务。首先,需要注册并实名认证阿里云账号,然后购买CDN服务。接着,添加要加速的域名,通过CDN控制台和阿里云云解析DNS进行配置,并验证CNAME设置是否生效。之后,配置源站信息,可以选择OSS域名、IP、源站域名或函数计算域名作为源站。最后,设置缓存规则,如缓存过期时间、状态码过期时间、自定义HTTP响应头等,以优化资源访问效率。
    阿里云CDN简介和使用流程
    |
    NoSQL Java Redis
    Redis 从入门到精通之Redis操作测试指定key是否存在
    在Redis中,可以使用`EXISTS`命令来测试指定的key是否存在。 `EXISTS`命令的基本语法如下: ``` EXISTS key ``` 其中,`key`是要测试的key的名称。如果指定的key存在,命令返回1;如果指定的key不存在,命令返回0。jedis.exists("foo");RedisTemplate的操作,包括测试指定key是否存在。使用该类可以方便地进行Redis操作,而无需关注底层细节。`exists`方法使用`hasKey`方法测试指定key是否存在,如果存在,则返回true;如果不存在,则返回false。
    1526 75
    登录插画

    登录以查看您的控制台资源

    管理云资源
    状态一览
    快捷访问