ObjectBox简明教程:查询

前言

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

Query

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

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

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

ObjectBox简明教程:查询_第1张图片

使用query的提供方法

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


    ObjectBox简明教程:查询_第2张图片
  1. 你可以得到常用的聚合函数处理后的信息


    ObjectBox简明教程:查询_第3张图片

几个常用查询的例子

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

  1. 现在我们来进行一个简单的查询:查找首个名字为Joe的所有用户
List joes = userBox.query().equal(User_.firstName, "Joe").build().find();
  1. 再来个复杂一点的查询:查找首个名字为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的数值。
画个图,详细描述下


ObjectBox简明教程:查询_第4张图片

分页查询: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()

你可能感兴趣的:(ObjectBox简明教程:查询)