前言
数据库里面有一堆数据,你可以指定查询条件,筛选出你想要的数据。
那么在ObjectBox里,怎么描述这个条件呢?
Query
ObjectBox用Query
来封装此次查询的相关信息,以及获取查询结果的一些便捷方法。
我们可以通过QueryBuilder<T>
,来构造Query。
使用
QueryBuilder
,你可以愉快的构建你的查询条件。
使用query的提供方法
你可以便捷的获取到你想要的对象
-
你可以得到常用的聚合函数处理后的信息
几个常用查询的例子
假设你定义了一个User
类,ObjectBox为你生成了User_
这个类(主要包含了属性相关的信息)。
- 现在我们来进行一个简单的查询:查找首个名字为Joe的所有用户
List<User> joes = userBox.query().equal(User_.firstName, "Joe").build().find();
- 再来个复杂一点的查询:查找首个名字为Joe,并且其出生日期大于1970年,并且其最后一个名字的第一个字母为O的所有用户
QueryBuilder<User> builder = userBox.query();
builder.equal(User_.firstName, "Joe")
.greater(User_.yearOfBirth, 1970)
.startsWith(User_.lastName, "O");
List<User> youngJoes = builder.build().find();
复用Query和查询参数Parameters
为了得到我们要的信息,我们用Query来描述我们筛选的条件。
通常情况下,我们需要多个查询,也就是如下的情况:
- 我需要 查找首个名字为Joe的所有用户---> query1
- 我需要 查找首个名字为Nick的所有用户---> query2
- 我需要 查找首个名字为Dell的所有用户---> query3
这时候,我们得构造 3个query啦!额,这个是不是有点繁琐啦?
这三个query结构都是一样的,只是名字不一样。
为了解决这样的繁琐工作,我们可以复用第一个query,通过设置query的参数值,来描述第二个,第三个查询。
话不多说,直接上代码:
Query<User> query = userBox.query().equal(User_.firstName, "").build();
List<User> joes = query.setParameter(User_.firstName, "Joe").find();
List<User> jakes = query.setParameter(User_.firstName, "Jake").find();
每个条件都有一个key,后面的参数设置,主要来设置这个key的数值。
画个图,详细描述下
分页查询:Limit,Offset,Pagination
按我们的查询条件,我们可以得到一堆结果,但是考虑到内存,性能等原因。
我们往往需要设置结果的大小,位置等等(分页)。
你只需要为Query的方法find设置几个参数就行啦
Query<User> query = userBox.query().equal(UserProperties.FirstName, "Joe").build();
List<User> joes = query.find(/** offset by */ 10, /** limit to */ 5 /** results */);
着重标识一下:
懒加载
什么事懒加载?
我指定了查询条件,可以获得大量的数据。但是这些大量的数据获取到,是需要大量的时间。考虑到性能和用户体验,我们通常采取的做法是:这些大量的数据我们先不去全部获取,而是你使用到了具体的某个数据的时候,再去到数据库中获取。
Query提供了findLazy()
和 findLazyCached()
来达到懒加载的目的,这些方法返回了一个加强版的list:LazyList(当你去获取其中摸个元素的时候,它才会主动到数据库中加载数据)
再说下findLazyCached()
,如其名,它在内存里面缓存了你从数据库中获取的数据。下次你再起获得它的时候,它直接从缓存里面获取数据,加快数据的命中速度。
聚合函数
跟数据库中的聚合函数是一个概念,Query支持如下几个聚合函数。
- min / minDouble
- max / maxDouble
- sum / sumDouble
- avg
删除对象
去移除你筛选出的对象,你只需要调用query.remove()