Spring Cloud Datastore 按约定查询方法

public interface TradeRepository extends DatastoreRepository<Trade, String[]> {
  List<Trader> findByAction(String action);

  int countByAction(String action);

  boolean existsByAction(String action);

  List<Trade> findTop3ByActionAndSymbolAndPriceGreaterThanAndPriceLessThanOrEqualOrderBySymbolDesc(
  			String action, String symbol, double priceFloor, double priceCeiling);

  Page<TestEntity> findByAction(String action, Pageable pageable);

  Slice<TestEntity> findBySymbol(String symbol, Pageable pageable);

  List<TestEntity> findBySymbol(String symbol, Sort sort);
}

在上面的示例中，TradeRepository中的查询方法是使用https://docs.spring.io/spring-data/data-commons/docs/current/reference/html#repositories基于方法名称生成的。 query-methods.query-creation [Spring Data查询创建命名约定]。

Cloud Datastore仅支持通过AND连接的过滤器组件以及以下操作：

在编写仅指定这些方法签名的自定义存储库接口之后，将为您生成实现，并且可以将其与存储库的自动关联实例一起使用。由于Cloud Datastore要求明确选择的字段必须全部一起出现在组合索引中，因此find基于名称的查询方法将以SELECT *的身份运行。

还支持删除查询。例如，诸如deleteByAction或removeByAction之类的查询方法会删除findByAction找到的实体。删除查询是作为单独的读取和删除操作而不是作为单个事务执行的，因为除非指定了查询的祖先，否则Cloud Datastore无法在事务中查询。 结果，removeBy和deleteBy名称约定查询方法不能通过performInTransaction或@Transactional批注在事务内部使用。

删除查询可以具有以下返回类型：

方法可以具有org.springframework.data.domain.Pageable参数来控制分页和排序，或者具有org.springframework.data.domain.Sort参数来仅控制排序。有关详细信息， 请参见Spring Data文档。

要在存储库方法中返回多个项目，我们支持Java集合以及org.springframework.data.domain.Page和org.springframework.data.domain.Slice。如果方法的返回类型为org.springframework.data.domain.Page，则返回的对象将包括当前页面，结果总数和页面总数。

返回Page的方法执行附加查询以计算总页数。另一方面，返回Slice的方法不会执行任何其他查询，因此效率更高。