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 許可。

贊助