如何用Java API实现Google Cloud Datastore列表包含过滤查询

我来帮你搞定这个Datastore查询的需求！你要实现的是查询实体的companies列表属性中至少包含传入列表里任意一个元素的逻辑，这个用Datastore Java SDK的IN过滤条件就能轻松实现，不用手动拼接复杂的OR条件。

核心思路 #

Datastore的IN操作符对于列表类型的属性，作用是：只要实体的该属性列表中包含指定值列表里的任意一个元素，就会被匹配到，完全符合你的需求。比如你示例里的查询列表{KCHOL,GARAN}，所有companies里有KCHOL或者GARAN的实体都会被返回。

修改后的完整代码 #

下面是更新后的getExchangeNews方法，重点看relatedCompanySymbols非空时的过滤逻辑：

public List<MAExchangeNews> getExchangeNews(IExchangeController controller,int count, String offsetVal, List<String> relatedCompanySymbols) {
    List<MAExchangeNews> result = null;
    if (controller != null) {
        EntityQuery.Builder builder = Query.newEntityQueryBuilder();
        builder.setKind(KIND_NAME);
        builder.setLimit(count);
        builder.setOrderBy(OrderBy.desc(FIELD_NEWS_TIME));
        if (offsetVal != null) {
            builder.setStartCursor(Cursor.fromUrlSafe(offsetVal));
        }
        if (relatedCompanySymbols != null && !relatedCompanySymbols.isEmpty()) {
            // 添加IN过滤条件：匹配companies属性包含列表中任意一个元素的实体
            Filter companyFilter = PropertyFilter.in("companies", relatedCompanySymbols);
            builder.setFilter(companyFilter);
        }
        Query<Entity> query = builder.build();
        QueryResults<Entity> resultList = datastore.run(query);
        result = entitiesToNews(controller,resultList);
        if (result != null && resultList.hasNext()) {
            this.nextOffset = resultList.getCursorAfter().toUrlSafe();
        }
    }
    return result;
}

关键细节说明 #

• 我加了!relatedCompanySymbols.isEmpty()的判断，避免传入空列表时生成无效的过滤条件（Datastore不允许IN的参数为空）。
• PropertyFilter.in("companies", relatedCompanySymbols)中的第一个参数是你Datastore实体里companies属性的字段名，确保和你实际存储的字段名一致。
• 这个逻辑完全符合你的示例需求：查询{KCHOL,GARAN}时，会返回所有companies包含KCHOL或GARAN的实体，也就是你期望的前3条结果。

注意事项 #

• Datastore的IN操作符有一个限制：传入的值列表最多不能超过30个元素。如果你的relatedCompanySymbols可能超过30个，需要把列表拆分成多个30个以内的子列表，分别执行查询，最后合并结果。
• 如果你需要更复杂的OR逻辑（比如同时匹配多个属性的IN条件），可以用CompositeFilter.or()来组合多个过滤条件，但这个场景下单个IN就足够了。

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