此版本仍在开发中,尚未被视为稳定版本。如需最新的稳定版本,请使用 Spring Data Redis 3.4.0spring-doc.cn

Redis 存储库剖析

Redis 作为存储本身提供了一个非常狭窄的低级 API,将更高级别的功能(例如二级索引和查询操作)留给用户。spring-doc.cn

本节提供了存储库抽象发出的命令的更详细视图,以便更好地了解潜在的性能影响。spring-doc.cn

将以下实体类视为所有操作的起点:spring-doc.cn

示例 1.示例实体
@RedisHash("people")
public class Person {

  @Id String id;
  @Indexed String firstname;
  String lastname;
  Address hometown;
}

public class Address {

  @GeoIndexed Point location;
}

插入新

repository.save(new Person("rand", "al'thor"));
HMSET "people:19315449-cda2-4f5c-b696-9cb8018fa1f9" "_class" "Person" "id" "19315449-cda2-4f5c-b696-9cb8018fa1f9" "firstname" "rand" "lastname" "al'thor" (1)
SADD  "people" "19315449-cda2-4f5c-b696-9cb8018fa1f9"                           (2)
SADD  "people:firstname:rand" "19315449-cda2-4f5c-b696-9cb8018fa1f9"            (3)
SADD  "people:19315449-cda2-4f5c-b696-9cb8018fa1f9:idx" "people:firstname:rand" (4)
1 将平展的条目保存为 hash。
2 将 <1> 中写入的哈希的键添加到同一键空间中实体的帮助程序索引中。
3 将 <2> 中写入的哈希的键添加到 properties 值为 firstnames 的二级索引中。
4 将索引 <3> 添加到 entry 的帮助程序结构集中,以跟踪在删除/更新时要清理的索引。

替换现有

repository.save(new Person("e82908cf-e7d3-47c2-9eec-b4e0967ad0c9", "Dragon Reborn", "al'thor"));
DEL       "people:e82908cf-e7d3-47c2-9eec-b4e0967ad0c9"                           (1)
HMSET     "people:e82908cf-e7d3-47c2-9eec-b4e0967ad0c9" "_class" "Person" "id" "e82908cf-e7d3-47c2-9eec-b4e0967ad0c9" "firstname" "Dragon Reborn" "lastname" "al'thor" (2)
SADD      "people" "e82908cf-e7d3-47c2-9eec-b4e0967ad0c9"                         (3)
SMEMBERS  "people:e82908cf-e7d3-47c2-9eec-b4e0967ad0c9:idx"                       (4)
TYPE      "people:firstname:rand"                                                 (5)
SREM      "people:firstname:rand" "e82908cf-e7d3-47c2-9eec-b4e0967ad0c9"          (6)
DEL       "people:e82908cf-e7d3-47c2-9eec-b4e0967ad0c9:idx"                       (7)
SADD      "people:firstname:Dragon Reborn" "e82908cf-e7d3-47c2-9eec-b4e0967ad0c9" (8)
SADD      "people:e82908cf-e7d3-47c2-9eec-b4e0967ad0c9:idx" "people:firstname:Dragon Reborn" (9)
1 删除现有哈希值,以避免哈希键的剩余部分可能不再存在。
2 将平展的条目保存为 hash。
3 将 <1> 中写入的哈希的键添加到同一键空间中实体的帮助程序索引中。
4 获取可能需要更新的现有索引结构。
5 检查索引是否存在以及它是什么类型(text、geo 等)。
6 从索引中删除可能存在的键。
7 删除保存索引信息的帮助程序。
8 将 <2> 中添加的哈希键添加到 properties 值为 firstnames 的二级索引中。
9 将索引 <6> 添加到 entry 的帮助程序结构集中,以跟踪在删除/更新时要清理的索引。

保存地理数据

地理索引遵循与基于普通文本的索引相同的规则,但使用 geo 结构来存储值。 保存使用 Geo-indexed (地理索引) 属性的实体会导致以下命令:spring-doc.cn

GEOADD "people:hometown:location" "13.361389" "38.115556" "76900e94-b057-44bc-abcf-8126d51a621b"  (1)
SADD   "people:76900e94-b057-44bc-abcf-8126d51a621b:idx" "people:hometown:location"               (2)
1 将已保存条目的键添加到 geo 索引中。
2 跟踪索引结构。

使用简单索引查找

repository.findByFirstname("egwene");
SINTER  "people:firstname:egwene"                     (1)
HGETALL "people:d70091b5-0b9a-4c0a-9551-519e61bc9ef3" (2)
HGETALL ...
1 获取二级索引中包含的键。
2 分别获取 <1> 返回的每个 key。

使用 Geo Index 查找

repository.findByHometownLocationNear(new Point(15, 37), new Distance(200, KILOMETERS));
GEORADIUS "people:hometown:location" "15.0" "37.0" "200.0" "km" (1)
HGETALL   "people:76900e94-b057-44bc-abcf-8126d51a621b"         (2)
HGETALL   ...
1 获取二级索引中包含的键。
2 分别获取 <1> 返回的每个 key。