以下是 Spring Boot 集成 Redis 中 TypedTuple 和 DefaultTypedTuple 的詳細使用說明，包含代碼示例和場景說明：

---

1. 什么是 TypedTuple 和 DefaultTypedTuple？

• TypedTuple<T> 接口：
  定義了 Redis 中有序集合（ZSet）的元素結構，包含 元素值（value） 和 分數（score）。

  • T 表示元素的類型（如 String、自定義對象等）。

• DefaultTypedTuple<T> 類：
  TypedTuple 的實現類，用于創建包含元素和分數的元組對象，常用于 ZSet 的增刪改查操作。

---

2. 使用場景

TypedTuple 主要用于以下場景：

1. 存儲帶分數的元素（如排行榜、優先級隊列）。
2. 獲取元素時同時獲取分數（如查詢用戶積分及排名）。
3. 批量操作 ZSet（如添加多個元素并指定分數）。

---

3. Spring Boot 配置

3.1 添加依賴

在 pom.xml 中添加以下依賴：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency><groupId>io.lettuce</groupId><artifactId>lettuce-core</artifactId>
</dependency>

3.2 配置 RedisTemplate

@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(factory);// 設置鍵和值的序列化器template.setKeySerializer(new StringRedisSerializer());template.setValueSerializer(new GenericJackson2JsonRedisSerializer());return template;}
}

---

4. TypedTuple 的核心操作

4.1 創建 TypedTuple 對象

通過 DefaultTypedTuple 構造函數創建：

TypedTuple<String> tuple = new DefaultTypedTuple<>("Alice", 90.0); // 元素值為 "Alice"，分數為90.0

4.2 添加元素到 ZSet

// 添加單個元素
redisTemplate.opsForZSet().add("leaderboard", "Alice", 90.0);// 或使用 TypedTuple 批量添加
redisTemplate.opsForZSet().add("leaderboard", new DefaultTypedTuple<>("Alice", 90.0),new DefaultTypedTuple<>("Bob", 85.0));

4.3 獲取元素和分數

// 獲取所有元素及其分數（按分數升序）
Set<ZSetOperations.TypedTuple<String>> tuples = redisTemplate.opsForZSet().reverseRangeWithScores("leaderboard", 0, -1);for (TypedTuple<String> tuple : tuples) {String member = tuple.getValue(); // 元素值（如 "Alice"）Double score = tuple.getScore(); // 分數（如 90.0）System.out.println("Member: " + member + ", Score: " + score);
}

4.4 更新元素分數

// 更新元素的分數
redisTemplate.opsForZSet().add("leaderboard", "Alice", 95.0); // 若已存在，分數會被更新

4.5 刪除元素

// 刪除指定元素
redisTemplate.opsForZSet().remove("leaderboard", "Alice");

---

5. 完整代碼示例

5.1 服務類實現

@Service
public class RankService {@Autowiredprivate RedisTemplate<String, Object> redisTemplate;// 添加用戶到排行榜public void addUserToLeaderboard(String userId, double score) {redisTemplate.opsForZSet().add("leaderboard", userId, score);}// 獲取前10名用戶及其分數public List<ScoredUser> getTop10() {Set<ZSetOperations.TypedTuple<String>> tuples = redisTemplate.opsForZSet().reverseRangeWithScores("leaderboard", 0, 9);List<ScoredUser> result = new ArrayList<>();for (TypedTuple<String> tuple : tuples) {ScoredUser user = new ScoredUser();user.setId(tuple.getValue());user.setScore(tuple.getScore());result.add(user);}return result;}// 自定義返回對象@Dataprivate static class ScoredUser {private String id;private Double score;}
}

5.2 使用示例

@Autowired
private RankService rankService;// 添加用戶
rankService.addUserToLeaderboard("user1001", 90.0);
rankService.addUserToLeaderboard("user1002", 85.0);// 獲取前10名
List<ScoredUser> top10 = rankService.getTop10();
for (ScoredUser user : top10) {System.out.println("ID: " + user.getId() + ", Score: " + user.getScore());
}

---

6. 關鍵代碼說明

6.1 添加元素（帶分數）

// 直接添加元素和分數
redisTemplate.opsForZSet().add(key, member, score);// 使用 TypedTuple 批量添加
redisTemplate.opsForZSet().add(key, new DefaultTypedTuple<>("Alice", 90.0),new DefaultTypedTuple<>("Bob", 85.0));

6.2 獲取元素和分數

// 獲取帶分數的元素（按分數降序）
Set<ZSetOperations.TypedTuple<String>> tuples = redisTemplate.opsForZSet().reverseRangeWithScores(key, start, end);// 遍歷獲取每個元素和分數
for (TypedTuple<String> tuple : tuples) {String member = tuple.getValue();Double score = tuple.getScore();
}

6.3 更新元素分數

// 若元素已存在，會更新其分數
redisTemplate.opsForZSet().add(key, member, newScore);

---

7. 總結表格

操作	方法	描述
添加元素	opsForZSet().add(key, member, score)	添加元素并指定分數。
批量添加	opsForZSet().add(key, tuples)	使用 TypedTuple 列表批量添加元素。
獲取元素和分數	opsForZSet().reverseRangeWithScores(key, start, end)	獲取指定范圍的元素及其分數（按分數降序）。
更新分數	opsForZSet().add(key, member, newScore)	若元素已存在，更新其分數。
刪除元素	opsForZSet().remove(key, member)	刪除指定元素。

---

8. 注意事項

1. 泛型類型：

   • TypedTuple<T> 的類型 T 必須與 ZSet 中的元素類型一致（如 String、自定義對象等）。
   • 若存儲自定義對象，需確保序列化配置正確（如使用 GenericJackson2JsonRedisSerializer）。

2. 分數范圍查詢：

   • 使用 rangeByScoreWithScores(key, min, max) 可根據分數范圍獲取元素。

3. 性能優化：

   • 大量數據操作時，優先使用批量操作（如 add 接受 TypedTuple 列表）。

通過以上示例和說明，可以靈活使用 TypedTuple 和 DefaultTypedTuple 實現 Redis ZSet 的復雜操作。