如何使用Objectify在Datastore中按字符串属性过滤获取实体？

我在Datastore中存储了若干YTLink实体，实体结构如下：

public class YTLink {
    @Id
    String videoId;
    @Index
    String videoTitle;
    @Index
    String videoLink;
    @Index
    String videoThumbnail;
}

当收到带有关键词的请求时，我需要筛选出videoTitle属性中包含该关键词的YTLink实体。目前我的实现是先查询所有实体再遍历过滤：

List<YTLink> ytLinkList = ObjectifyInitializer.ofy().load().type(YTLink.class).list();

ytLinkList.removeIf(video -> video.getVideoTitle() == null || !video.getVideoTitle().toLowerCase().contains(searchKeyword.trim().toLowerCase()));

我想知道能不能在查询阶段直接做过滤，类似这种写法：

ObjectifyInitializer.ofy().load().type(YTLink.class).filter("videoTitle",searchKeyword).list();

希望了解如何基于字符串属性的包含关系过滤实体，感谢！

可行的过滤方案 #

Datastore（及Objectify框架）不支持直接的任意子字符串包含匹配（类似SQL的LIKE '%keyword%'），但可以根据需求选择以下几种方案：

1. 前缀匹配（基础索引支持） #

如果只需匹配以关键词开头的标题，可以利用Datastore的字符串范围查询，结合Objectify的filter方法实现：

String lowerKeyword = searchKeyword.trim().toLowerCase();
// 构造前缀查询范围：大于等于目标关键词，小于等于关键词拼接一个高ASCII字符（覆盖所有前缀匹配的字符串）
List<YTLink> matches = ObjectifyInitializer.ofy()
    .load()
    .type(YTLink.class)
    .filter("videoTitle >=", lowerKeyword)
    .filter("videoTitle <=", lowerKeyword + "\ufffd")
    .list();

注意：这种方式要求videoTitle存储为小写，或者额外维护一个小写的索引字段（比如videoTitleLower），否则大小写不敏感的匹配会失效。

2. 全文搜索（支持任意位置的关键词匹配） #

如果需要真正的包含式匹配（关键词在标题任意位置），必须使用Datastore的全文索引：

步骤1：修改实体类配置全文索引

给videoTitle字段添加@FullTextIndex注解（Objectify原生支持）：

public class YTLink {
    @Id
    String videoId;
    @Index
    @FullTextIndex
    String videoTitle;
    @Index
    String videoLink;
    @Index
    String videoThumbnail;
}

步骤2：使用全文搜索API查询

String targetKeyword = searchKeyword.trim();
List<YTLink> matches = ObjectifyInitializer.ofy()
    .load()
    .type(YTLink.class)
    .filter(Filters.fullText("videoTitle", targetKeyword))
    .list();

全文索引会自动处理大小写不敏感和分词逻辑，适合自然语言搜索场景，但会产生一定的索引存储开销。

3. 自定义关键词拆分（轻量匹配方案） #

如果不想依赖全文索引，可以在存储实体时，把videoTitle拆分成单个关键词（比如按空格拆分单词），存储到一个带索引的列表字段中：

步骤1：扩展实体类

public class YTLink {
    @Id
    String videoId;
    @Index
    String videoTitle;
    @Index
    List<String> titleKeywords; // 存储拆分后的小写关键词
    @Index
    String videoLink;
    @Index
    String videoThumbnail;
}

步骤2：存储时生成关键词列表

// 示例：按空格拆分标题并转小写
String lowerTitle = ytLink.getVideoTitle().toLowerCase();
ytLink.setTitleKeywords(Arrays.asList(lowerTitle.split("\\s+")));
ObjectifyInitializer.ofy().save().entity(ytLink).now();

步骤3：查询时匹配关键词

String lowerKeyword = searchKeyword.trim().toLowerCase();
List<YTLink> matches = ObjectifyInitializer.ofy()
    .load()
    .type(YTLink.class)
    .filter("titleKeywords", lowerKeyword)
    .list();

这种方式适合简单的单词匹配，但无法处理部分单词的子串（比如搜索"vid"无法匹配"video"）。

4. 注意：避免全表扫描 #

你当前的先查所有实体再过滤的实现属于全表扫描，当实体数量增大时会严重影响性能并增加成本，建议尽快替换为上述方案。

内容的提问来源于stack exchange，提问作者Karthick