查询

操作步骤

1.通过 tableID 实例化一个 TableObject 对象，操作该对象即相当于操作对应的数据表

let MyTableObject = new BaaS.TableObject(tableID)

参数说明

2.实例化一个 Query 对象，在该对象上添加查询条件

let query = new BaaS.Query()

查看下面的文档，了解目前支持的查询条件

3.支持查询条件并执行查找操作

MyTableObject.setQuery(query).find()

示例

请求示例

// 实例化查询对象
let query = new BaaS.Query()
// 设置查询条件（比较、字符串包含、组合等）
...
// 应用查询对象
let Product = new BaaS.TableObject(tableID)
Product.setQuery(query).find().then(res => {
  // success
}, err => {
  // err
})
// 不设置查询条件
Product.find().then()

返回示例 (res.statusCode === 200)

res.data:

{
  "meta": {
    "limit": 20,
    "next": null,
    "offset": 0,
    "previous": null,
    "total_count": 3
  },
  "objects": [
    {
      "_id": "59a3c2b5afb7766a5ec6e84e",
      "amount": 0,
      "created_at": 1503904437,
      "created_by": 36395395,
      "desc": ["good", 'great'],
      "id": "59a3c2b5afb7766a5ec6e84e",
      "name": "apple",
      "price": 1.0,
      "read_perm": ["user:*"],
      "updated_at": 1503904437,
      "write_perm": ["user:*"]
    },
    ...
  ]
}

比较查询

query.compare(key, operator, value)

operator 包含 =, !=, <, <=, >, >=

query.compare('amount', '>',  1)

多个查询条件

当存在多个查询条件时，它们之间默认为 AND 关系，查询返回满足所有条件的记录，如下示例，

// 查询满足 1 <= amount < 10 的记录
query.compare('amount', '>=', 1)
query.compare('amount', '<', 10)

多个查询条件之间需要更复杂的组合关系，可以查看以下 复杂组合查询 小节

字符串查询

query.contains('name', 'apple')

也支持正则匹配 ( * sdk version >= v1.1.1 )

query.matches('name', regExp)

构建一个 regExp 可通过以下两种方法之一:

• 使用正则表达式字面量

  const regExp = /^abc/i

• 调用 RegExp 对象的构造函数

  const regExp = new RegExp('^abc', 'i')

正则匹配示例

/* 以查找手机号码为例，phoneNumber 字段必须为 string 类型 */
let regExp
// 查找 以 188 开头的手机号码
regExp = /^188/
// 查找 以 708 结尾的手机号码
regx = /708$/
// 查找 以 188 开头的手机号码，以 708 结尾的手机号码
regx = /^188\d+708$/
query.matches('phoneNumber', regx)

数组查询

field 的类型不限制，field 的 value 含有 array 中的一个或多个

query.in(fieldName, array)

field 的类型不限制，field 的 value 不含有 array 中的任何一个

query.notIn(fieldName, array)

field 的类型必须为数组, field 的 value 包含 array 中的每一个 ( * sdk version >= v1.1.1 )

query.arrayContains(fieldName, array)

如果希望查找数组中只包含指定数组中所有的值的记录，可以使用比较查询

query.compare(fieldName, '=', array)

请求示例

/* color 是类型为字符串的字段，desc 是类型为数组的字段 */
// 查询 color 是 green 或 red 或 yellow 的记录
query.in('color', ['green', 'red', 'yellow'])
// 查询 desc 中包含 green 或 red 或 yellow 的记录
query.in('desc', ['green', 'red', 'yellow'])
// 查询 color 不是 green、red 和 yellow 的记录
query.notIn('color', ['green', 'red', 'yellow'])
// 查询 desc 中不包含 green、red 和 yellow 的记录
query.notIn('desc', ['green', 'red', 'yellow'])
// 查询 desc 中包含 green、red 和 yellow 的记录
query.arrayContains('desc', ['green', 'red', 'yellow'])
// 查询 desc 中只包含 green、red 和 yellow 的记录
query.compare('desc', '=', ['green', 'red', 'yellow'])

查询字段值为 null 或非 null 记录

query.isNull('name')
query.isNull(['name', 'price'])
query.isNotNull('name')
query.isNotNull(['name', 'price'])

查询字段值为空或非空记录

* sdk version >= v1.1.1

query.exists('name')
query.exists(['name', 'price'])
query.notExists('name')
query.notExists(['name', 'price'])

组合查询

let query1 = new BaaS.Query()
query1.isNull('name')
let query2 = new BaaS.Query()
query1.compare('price', '>', 10)
...
// and 查询
let andQuery = BaaS.Query.and(query1, query2, ...)
// or 查询
let orQuery =  BaaS.Query.or(query1, query2, ...)

复杂组合查询

let query1 = new BaaS.Query()
query1.isNull('name')
let query2 = new BaaS.Query()
query1.compare('price', '>', 10)
...
// and 查询
let andQuery = BaaS.Query.and(query1, query2)
// or 查询中包含 and 查询
let query3 = new BaaS.Query()
query3.compare('amount', '>', 3)
let orQuery = BaaS.Query.or(andQuery, query3)