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 Redis
    Mac安装Redis(图文解说详细版)
    Mac安装Redis(图文解说详细版)
    Mac安装Redis(图文解说详细版)
    |
    监控 NoSQL 数据可视化
    Redis 官方可视化工具,功能真心强大
    一、RedisInsight 简介 RedisInsight 是一个直观高效的 Redis GUI 管理工具,它可以对 Redis 的内存、连接数、命中率以及正常运行时间进行监控,并且可以在界面上使用 CLI 和连接的 Redis 进行交互(RedisInsight 内置对 Redis 模块支持): https://docs.redis.com/latest/ri/ RedisInsight 提供的功能: 唯一支持 Redis Cluster 的 GUI 工具; 可以基于 Browser 的界面来进行搜索键、查看和编辑数据; 支持基于 SSL/TLS 的连接,同时还可以在界面上进行内存分
    |
    1月前
    |
    NoSQL Redis 数据安全/隐私保护
    Redis 最流行的图形化界面下载及使用超详细教程(带安装包)! redis windows客户端下载
    文章提供了Redis最流行的图形化界面工具Another Redis Desktop Manager的下载及使用教程,包括如何下载、解压、连接Redis服务器以及使用控制台和查看数据类型详细信息。
    126 6
    Redis 最流行的图形化界面下载及使用超详细教程(带安装包)! redis windows客户端下载
    |
    4月前
    |
    缓存 NoSQL Linux
    入职必会-开发环境搭建26-Redis下载和安装
    Redis是一个开源的、内存中的数据结构存储系统,用作数据库、缓存、消息中间件。它提供了丰富的数据结构,包括字符串、哈希、列表、集合、有序集合、位图、HyperLogLog、地理空间索引和流。以下是 Redis 的一些主要特点和用途。
    |
    5月前
    |
    NoSQL Ubuntu 安全
    Ubuntu 20.04下载安装redis一条龙
    Ubuntu 20.04下载安装redis一条龙
    |
    6月前
    |
    Kubernetes Nacos 开发者
    Nacos 官网重大升级,提供官方发行版下载包,3.0 里程碑版本新特性预告
    Nacos 官网重大升级,提供官方发行版下载包,3.0 里程碑版本新特性预告
    1278 13
    |
    6月前
    redis7.0源码阅读(一):源码安装(如何去高效阅读源码)
    redis7.0源码阅读(一):源码安装(如何去高效阅读源码)
    120 0
    |
    NoSQL Ubuntu Redis
    百度搜索:蓝易云【Ubuntu 20.04系统编译安装Redis教程。】
    请注意,以上是一个基本的编译安装Redis的示例,您可能需要根据您的特定需求进行进一步配置和调整。
    198 0
    |
    NoSQL Redis 数据安全/隐私保护
    百度搜索:蓝易云【Debian11系统编译安装Redis教程。】
    以上是在Debian 11系统上编译安装Redis的基本步骤。请根据实际情况进行相应的调整和配置。
    98 0
    |
    存储 NoSQL 测试技术
    Redis主要数据类型—官方原版
    Redis主要数据类型—官方原版
    119 0