ObjectBox简明教程：查询

前言

数据库里面有一堆数据，你可以指定查询条件，筛选出你想要的数据。
那么在ObjectBox里，怎么描述这个条件呢？

Query

ObjectBox用Query来封装此次查询的相关信息，以及获取查询结果的一些便捷方法。

我们可以通过QueryBuilder，来构造Query。

使用QueryBuilder,你可以愉快的构建你的查询条件。

使用query的提供方法

1. 你可以便捷的获取到你想要的对象

   
   
   

2. 你可以得到常用的聚合函数处理后的信息

   
   
   

几个常用查询的例子

假设你定义了一个User类，ObjectBox为你生成了User_这个类（主要包含了属性相关的信息）。

1. 现在我们来进行一个简单的查询：查找首个名字为Joe的所有用户

List joes = userBox.query().equal(User_.firstName, "Joe").build().find();

2. 再来个复杂一点的查询：查找首个名字为Joe，并且其出生日期大于1970年，并且其最后一个名字的第一个字母为O的所有用户

QueryBuilder builder = userBox.query();
builder.equal(User_.firstName, "Joe")
        .greater(User_.yearOfBirth, 1970)
        .startsWith(User_.lastName, "O");
List youngJoes = builder.build().find();

复用Query和查询参数Parameters

为了得到我们要的信息，我们用Query来描述我们筛选的条件。

通常情况下，我们需要多个查询，也就是如下的情况：

1. 我需要 查找首个名字为Joe的所有用户---> query1
2. 我需要 查找首个名字为Nick的所有用户---> query2
3. 我需要 查找首个名字为Dell的所有用户---> query3

这时候，我们得构造 3个query啦！额，这个是不是有点繁琐啦？
这三个query结构都是一样的，只是名字不一样。
为了解决这样的繁琐工作，我们可以复用第一个query，通过设置query的参数值，来描述第二个，第三个查询。

话不多说，直接上代码：

Query query = userBox.query().equal(User_.firstName, "").build();
List joes = query.setParameter(User_.firstName, "Joe").find();
List jakes = query.setParameter(User_.firstName, "Jake").find();

每个条件都有一个key，后面的参数设置，主要来设置这个key的数值。
画个图，详细描述下

分页查询：Limit,Offset,Pagination

按我们的查询条件，我们可以得到一堆结果，但是考虑到内存，性能等原因。
我们往往需要设置结果的大小，位置等等（分页）。

你只需要为Query的方法find设置几个参数就行啦

Query query = userBox.query().equal(UserProperties.FirstName, "Joe").build();
List joes = query.find(/** offset by */ 10, /** limit to */ 5 /** results */);

着重标识一下：

懒加载

什么事懒加载？

我指定了查询条件，可以获得大量的数据。但是这些大量的数据获取到，是需要大量的时间。考虑到性能和用户体验，我们通常采取的做法是：这些大量的数据我们先不去全部获取，而是你使用到了具体的某个数据的时候，再去到数据库中获取。

Query提供了findLazy() 和 findLazyCached() 来达到懒加载的目的，这些方法返回了一个加强版的list：LazyList（当你去获取其中摸个元素的时候，它才会主动到数据库中加载数据）

再说下findLazyCached()，如其名，它在内存里面缓存了你从数据库中获取的数据。下次你再起获得它的时候，它直接从缓存里面获取数据，加快数据的命中速度。

聚合函数

跟数据库中的聚合函数是一个概念，Query支持如下几个聚合函数。

1. min / minDouble
2. max / maxDouble
3. sum / sumDouble
4. avg

删除对象

去移除你筛选出的对象，你只需要调用query.remove()