RedisTemplate 及相關操作接口對比與方法說明

---

1. RedisTemplate 核心接口與實現類

RedisTemplate 是 Spring Data Redis 的核心模板類，通過 opsFor... 方法返回不同數據類型的操作接口，每個接口對應 Redis 的一種數據結構。以下是主要接口及其實現類：

---

2. 各操作接口及方法說明

(1) RedisValueOperations<K, V>

• 對應數據類型：字符串（String）
• 實現類：DefaultRedisScriptingOperations（內部實現）
• 主要方法：
  • set(K key, V value)：設置鍵值對。
  • set(K key, V value, long offset)：設置指定偏移量的值（如追加字符串）。
  • getExpire(K key)：獲取鍵的剩余過期時間（毫秒）。
  • multiSet(Map<K, V> map)：批量設置鍵值對。
  • increment(K key, long delta)：對數值鍵執行遞增操作。
  • append(K key, String value)：追加字符串到現有值末尾。

---

(2) RedisHashOperations<K, HK, HV>

• 對應數據類型：哈希（Hash）
• 實現類：DefaultHashOperations（內部實現）
• 主要方法：
  • put(K key, HK hashKey, HV hashValue)：在哈希中設置字段值。
  • get(K key, HK hashKey)：獲取哈希中的字段值。
  • entries(K key)：獲取哈希中所有字段和值。
  • hasKey(K key, HK hashKey)：判斷哈希中是否存在字段。
  • increment(K key, HK hashKey, long delta)：遞增哈希中的數值字段。

---

(3) RedisListOperations<K, V>

• 對應數據類型：列表（List）
• 實現類：DefaultListOperations（內部實現）
• 主要方法：
  • leftPush(K key, V value)：從左側（頭）插入元素。
  • rightPush(K key, V value)：從右側（尾）插入元素。
  • leftPop(K key)：彈出并返回左側元素。
  • range(K key, long start, long end)：獲取列表切片。
  • trim(K key, long start, long end)：截取列表到指定范圍。

---

(4) RedisSetOperations<K, V>

• 對應數據類型：集合（Set）
• 實現類：DefaultSetOperations（內部實現）
• 主要方法：
  • add(K key, V... values)：添加元素到集合。
  • remove(K key, V... values)：從集合中移除元素。
  • members(K key)：獲取集合中所有元素。
  • isMember(K key, V value)：判斷元素是否存在于集合中。
  • randomMember(K key)：隨機獲取一個元素。

---

(5) RedisZSetOperations<K, V>

• 對應數據類型：有序集合（Sorted Set）
• 實現類：DefaultZSetOperations（內部實現）
• 主要方法：
  • add(K key, V value, double score)：添加元素及分數。
  • rangeByScore(K key, double min, double max)：按分數范圍獲取元素。
  • score(K key, V value)：獲取元素的分數。
  • removeRangeByScore(K key, double start, double end)：按分數范圍刪除元素。
  • rank(K key, V value)：獲取元素的排名（從小到大）。

---

(6) RedisGeoOperations<K, V>

• 對應數據類型：地理位置（Geo）
• 實現類：DefaultGeoOperations（內部實現）
• 主要方法：
  • add(K key, V member, double longitude, double latitude)：添加地理位置。
  • distance(K key, V member1, V member2)：計算兩點距離。
  • radius(K key, double longitude, double latitude, double radius, RedisGeoCommands.DistanceUnit unit)：獲取指定半徑內的元素。
  • position(K key, V member)：獲取元素的經緯度坐標。

---

(7) RedisStreamOperations<K, V>

• 對應數據類型：流（Stream，Redis 5+）
• 實現類：DefaultStreamOperations（內部實現）
• 主要方法：
  • add(K key, StreamEntryID id, Map<Field, V> values)：向流中添加條目。
  • read(K key, StreamOffset<K> streamOffset)：讀取流數據。
  • acknowledge(K key, Consumer consumer, StreamEntryID... ids)：確認已處理的條目。
  • trim(K key, long maxEntries)：按最大條目數截斷流。

---

對比表格

接口	對應數據類型	核心方法	典型場景
RedisValueOperations	字符串（String）	set, get, increment, append	簡單鍵值存儲（如計數器、緩存）
RedisHashOperations	哈希（Hash）	put, get, entries, increment	對象屬性存儲（如用戶資料）
RedisListOperations	列表（List）	leftPush, rightPush, leftPop, range	隊列/棧操作（如消息隊列）
RedisSetOperations	集合（Set）	add, remove, members, isMember	去重存儲（如標簽、唯一用戶列表）
RedisZSetOperations	有序集合（ZSet）	add, rangeByScore, score, rank	排名/優先級隊列（如排行榜）
RedisGeoOperations	地理位置（Geo）	add, distance, radius, position	地理信息查詢（如附近商家）
RedisStreamOperations	流（Stream）	add, read, acknowledge, trim	流式數據處理（如日志、事件隊列）

---

總結與建議

1. 選擇接口：根據 Redis 數據類型選擇對應操作接口（如列表用 RedisListOperations）。
2. 原子性操作：復雜操作可通過 RedisTemplate.execute(SessionCallback) 實現事務性。
3. 性能優化：
   • 批量操作（如 multiSet）減少網絡開銷。
   • 使用 RedisTemplate.setEnableTransactionSupport(true) 開啟事務支持。
4. 高級功能：如地理位置查詢（RedisGeoOperations）或流處理（RedisStreamOperations）需結合具體業務場景。

---

示例代碼

@Service
public class RedisService {@Autowiredprivate RedisTemplate<String, Object> redisTemplate;public void demoOperations() {// 字符串操作redisTemplate.opsForValue().set("counter", 0);redisTemplate.opsForValue().increment("counter", 1); // 原子遞增// 哈希操作redisTemplate.opsForHash().put("user:1001", "name", "張三");redisTemplate.opsForHash().increment("user:1001", "age", 1);// 列表操作redisTemplate.opsForList().rightPush("queue", "message1");redisTemplate.opsForList().leftPop("queue");// 地理位置redisTemplate.opsForGeo().add("locations", "星巴克", 116.397428, 39.90923;);redisTemplate.opsForGeo().radius("locations", 116.3, 39.9, 1000, KILOMETERS);}
}

根據業務需求選擇合適的數據類型和接口，靈活使用 Redis 的強大功能！