jedis

杰迪斯

什么是杰迪斯？

Jedis 是 Redis 的 Java 客户端，旨在提高性能和易用性。

您是否正在寻找一个高级库来处理对象映射？请参阅 redis-om-spring！

我如何使用Redis？

在 Redis 大学免费学习

尝试 Redis 云

深入了解开发者教程

加入 Redis 社区

在 Redis 工作

支持的 Redis 版本

该库的最新版本支持 redis 版本 5.0、6.0、6.2、7.0、7.2 和 7.4。

下表突出显示了最新库版本和 Redis 版本的版本兼容性。兼容性指的是通信功能，以及Redis命令能力。

绝地武士版本	支持的 Redis 版本	JDK兼容性
3.9+	5.0 至 6.2 系列版本	8、11
>= 4.0	版本 5.0 至 7.2 系列版本	8、11、17
>= 5.0	版本 6.0 至今	8、11、17、21
>= 5.2	版本 7.2 至今	8、11、17、21

入门

要开始使用 Jedis，首先将其添加为 Java 项目中的依赖项。如果您使用 Maven，则看起来像这样：

< dependency >
    < groupId >redis.clients</ groupId >
    < artifactId >jedis</ artifactId >
    < version >5.2.0</ version >
</ dependency >

要使用最先进的 Jedis，请查看此处。

接下来，您需要连接到 Redis。考虑安装一个 redis-stack docker：

docker run -p 6379:6379 -it redis/redis-stack:latest

对于许多应用程序，最好使用连接池。您可以像这样实例化 Jedis 连接池：

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

对于JedisPool实例，您可以使用 try-with-resources 块来获取连接并运行 Redis 命令。

以下是如何在try-with-resources块中运行单个 SET 命令：

 try ( Jedis jedis = pool . getResource ()) {
  jedis . set ( "clientName" , "Jedis" );
}

Jedis实例实现了大部分Redis命令。有关受支持命令的完整列表，请参阅 Jedis Javadocs。

使用连接池的更简单方法

对每个命令使用try-with-resources块可能会很麻烦，因此您可以考虑使用 JedisPooled。

 JedisPooled jedis = new JedisPooled ( "localhost" , 6379 );

现在您可以像从 Jedis 发送一样发送命令。

 jedis . sadd ( "planets" , "Venus" );

连接到 Redis 集群

Jedis 允许您连接到 Redis 集群，支持 Redis 集群规范。为此，您需要使用JedisCluster进行连接。请参阅下面的示例：

 Set < HostAndPort > jedisClusterNodes = new HashSet < HostAndPort >();
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7379 ));
jedisClusterNodes . add ( new HostAndPort ( "127.0.0.1" , 7380 ));
JedisCluster jedis = new JedisCluster ( jedisClusterNodes );

现在您可以使用JedisCluster实例并发送命令，就像使用标准池连接一样：

 jedis . sadd ( "planets" , "Mars" );

使用 Redis 模块

Jedis 支持 Redis 模块，例如 RedisJSON 和 RediSearch。

有关详细信息，请参阅 RedisJSON Jedis 或 RediSearch Jedis。

故障转移

Jedis 支持 Redis 部署的重试和故障转移。这在以下情况下很有用：

1. 您有多个 Redis 部署。这可能包括两个独立的 Redis 服务器或跨多个主动-主动 Redis Enterprise 集群复制的两个或多个 Redis 数据库。
2. 您希望应用程序一次连接到一个部署，并在第一个部署不可用时故障转移到下一个可用部署。

有关完整的故障转移配置选项和示例，请参阅 Jedis 故障转移文档。

文档

Jedis wiki 包含几篇关于使用 Jedis 的有用文章。

您还可以查看最新的 Jedis Javadocs。

一些具体的用例示例可以在测试源代码的redis.clients.jedis.examples包中找到。

故障排除

如果您遇到麻烦或有任何疑问，我们随时为您提供帮助！

请在 Redis Discord Server 或 Jedis GitHub 讨论或 Jedis 邮件列表上联系我们。

贡献

我们很高兴您的贡献！

随时欢迎错误报告！您可以在 GitHub 上打开错误报告。

您还可以贡献文档或任何可以改进 Jedis 的内容。请参阅贡献指南了解更多详情。

执照

Jedis 已获得 MIT 许可。

赞助