使用DatastoreReader(v1.3.1)如何判断Google Datastore查询无更多结果？

针对你提到的几个问题，结合com.google.cloud.datastore.DatastoreReader的使用逻辑，我整理了以下说明：

1. 如何判断已无更多结果？ #

在使用DatastoreReader.executeQuery()执行查询后，会得到一个QueryResults<T>对象。判断是否还有更多结果的核心依据是**QueryResults.hasNext()方法的返回值**：

• 当hasNext()返回false时，意味着当前查询（包括基于Cursor的分页查询）已经没有更多实体可以返回，哪怕此时QueryResults.getCursor()仍能获取到Cursor值。
• 这里要注意：Cursor的存在不代表还有未返回的结果——比如当你查询最后一页数据时，即使返回的实体数量小于Limit，Datastore仍会生成Cursor，但后续基于这个Cursor的查询会返回空结果（hasNext()为false）。

示例代码片段：

QueryResults<Entity> results = datastoreReader.executeQuery(query);
while (results.hasNext()) {
    Entity entity = results.next();
    // 处理实体
}
// 当退出循环时，说明已无更多结果

2. 若查询仍有结果，是否能确保返回带值的迭代器？ #

是的。只要你的查询存在匹配的实体，QueryResults迭代器一定会返回有效的结果：

• 当查询有结果时，hasNext()会先返回true，此时调用next()就能获取到对应的Entity（或你查询的目标类型），不会抛出NoSuchElementException。
• 只有当hasNext()返回false时，调用next()才会触发异常，所以只要遵循“先判断再获取”的迭代逻辑，就能安全拿到所有存在的结果。

3. 若查询结果集中剩余元素足够，是否能确保返回查询中Limit指定数量的元素？ #

完全可以。当你通过Query.Builder.setLimit(int)设置了查询的返回数量限制时：

• 如果结果集中剩余未返回的实体数量大于等于你设置的Limit值，Datastore会精确返回Limit指定数量的实体。
• 只有当剩余实体数量小于Limit值时，才会返回剩余的所有实体（不会填充空值或占位符）。
• 这个行为是Datastore查询的默认逻辑，只要你的查询没有其他过滤/排序条件导致的特殊情况（比如查询过程中数据被删除），就能保证Limit的有效性。

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