查询

数据类型对应查询操作符表

数据类型 可使用的查询操作 说明
String =, in, notIn, !=, isNull, isNotNull, contains, matches, exists, notExists
Number =, >, >=, <, <=, !=, in, notIn, isNull, isNotNull, exists, notExists
array =, in, notIn, isNull, isNotNull, arrayContains, exists, notExists file、object、date 类型的 array 不支持查询操作。如果进行查询,会返回空数组
Boolean =, exists, notExists, isNull, isNotNull
Calendar =, >, >=, <, <=, exists, notExists, isNull, isNotNull
CloudFile isNull, isNotNull, exists, notExists
Object =, hasKey, isNull, isNotNull, exists, notExists
pointer =, in, notIn, !=, isNull, isNotNull, exists, notExists

file、object、date 类型的 array 不支持查询操作。如果进行查询,会返回空数组

操作步骤

1.通过 tableName 实例化一个 Table 对象,操作该对象即相当于操作对应的数据表

Table table = new Table("tableName");

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

Query query = new Query();

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

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

PagedList<Record> records = table.query(query);

注意:知晓云的 api URL 长度限定为 16386,超出则返回 502,请在构造查询条件时注意长度控制,如 in 操作符后边的数组长度、match 操作符后边的字符串长度等。

示例

请求示例

Table table = new Table("tableName");

Where where = new Where();
// 设置查询条件(比较、字符串包含、组合等)
// where.equalTo("key", "value")

Query query = new Query();
// 设置分页、排序等
// query.orderBy("create_at")
query.put(where);

// 同步版本
try {
    PagedList<Record> records = table.query(query);
    // 操作成功
} catch (Exception e) {
    // 操作失败
}

// 异步查询
table.queryInBackground(query, new Callback<PagedList<Record>>() {
    @Override
    public void onSuccess(@Nullable PagedList<Record> recordPagedList) {
        // 查询成功,拿到数据集
    }

    @Override
    public void onFailure(Exception e) {
        // 查询失败了
    }
});

异常请参考异常

常见的 HttpException.code :

code 可能的原因
400 1. 指定/过滤输出字段的字段名有误、2. GEO 查询参数有误、3. 查询语法错误
404 数据表不存在

比较查询

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

where.equalTo("key", "value");
where.lessThan("key", "value");
where.lessThanOrEqualTo("key", "value");
where.greaterThan("key", "value");
where.greaterThanOrEqualTo("key", "value");
where.notEqualTo("key", "value");

多个查询条件

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

// 查询满足 key >= 10 & key != 5 的记录
where.greaterThanOrEqualTo("key", 10);
where.notEqualTo("key", 5);

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

字符串查询

查询返回满足包含相应字符串的记录,如下示例:

// 例:{"name": "apple"}
where.contains("name", "apple")  // 查询name字段包含'apple'的记录,能正确匹配
where.contains("name", "app")  // 查询name字段包含'app'的记录,能正确匹配
where.contains("name", "apple123")  // 查询name字段包含'apple123'的记录,不能正确匹配

也支持正则匹配 (正则表达式相关知识 ):

/* 以查找名字为例,name 字段必须为 string 类型 */
Where where = new Where();

// 查找 以 foo 开头的名字
where.matches("name", "^foo.*");

/* 以查找手机号码为例,phoneNumber 字段必须为 string 类型 */

// 查找 以 188 开头的手机号码
where.matches("phoneNumber", "^188\\d*");

// 查找 以 708 结尾的手机号码
where.matches("phoneNumber", "\\d*708$");

// 查找 以 188 开头的手机号码,以 708 结尾的手机号码
where.matches("phoneNumber", "^188\\d*708$");

正则匹配示例

/* 以查找名字为例,name 字段必须为 string 类型 */
Where where = new Where();

// 查找 以 foo 开头的名字
where.matches("name", "^foo.*");

/* 以查找手机号码为例,phoneNumber 字段必须为 string 类型 */

// 查找 以 188 开头的手机号码
where.matches("phoneNumber", "^188\\d*");

// 查找 以 708 结尾的手机号码
where.matches("phoneNumber", "\\d*708$");

// 查找 以 188 开头的手机号码,以 708 结尾的手机号码
where.matches("phoneNumber", "^188\\d*708$");

数组查询

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

where.containedIn(fieldName, array)

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

where.notContainedIn(fieldName, array)

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

where.arrayContains(fieldName, array)

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

where.equalTo(fieldName, array)

请求示例

/* color 是类型为字符串的字段,desc 是类型为数组的字段 */
List<String> array = Arrays.asList('green', 'red', 'yellow');

// 查询 color 是 green 或 red 或 yellow 的记录
where.containedIn('color', array);

// 查询 desc 中包含 green 或 red 或 yellow 的记录
where.containedIn('desc', array);

// 查询 color 不是 green、red 和 yellow 的记录
where.notContainedIn('color', array);

// 查询 desc 中不包含 green、red 和 yellow 的记录
where.notContainedIn('desc', array);

// 查询 desc 中包含 green、red 和 yellow 的记录
where.contains('desc', array);

// 查询 desc 中只包含 green、red 和 yellow 的记录
where.equalTo('desc', array);

null 和 exists 查询

where.isNull('name');       // 查询字段是否为 null
where.isNotNull('name');    // 查询字段是否不为 null
where.exists("name");       // 查询字段是否存在
where.notExists("name");    // 查询字段是否不存在

hasKey 查询 (仅限 object 类型)

参数说明

参数 类型 必填 说明
key String 在数据表中的类型必须是 Object
value String 需要检测的属性名, 只能包含字母、数字和下划线,必须以字母开头

示例代码

假设数据表有如下数据行

[
  {
    'id': '59a3c2b5afb7766a5ec6e84e',
    name: '战争与和平',
    publisherInfo: {
      name: 'abc出版社',
    },
  },
  {
    'id': '59a3c2b5afb7766a5ec6e84g',
    name: '西游记',
    publisherInfo: {
      name: 'efg出版社',
      location: '广东省广州市天河区五山路 100 号'
    },
  },
]

查询字段 publisherInfo 中存在 location 属性的数据行

where.hasKey('publisherInfo', 'location')

查询结果

[
  {
      'id': '59a3c2b5afb7766a5ec6e84g',
      name: '西游记',
      publisherInfo: {
        name: 'efg出版社',
        location: '广东省广州市天河区五山路 100 号'
      },
  }
]

注意:目前暂不支持查询内嵌属性

假设数据行如下

[
  {
      'id': '59a3c2b5afb7766a5ec6e84g',
      name: '西游记',
      publisherInfo: {
        abc: {
          name: 'efg出版社',
          location: '广东省广州市天河区五山路 100 号'
        }
      },
  }
]

则下面的查询语句是非法的

where.hasKey('publisherInfo', 'abc.location')

组合查询

Where where1 = new Where();
where1.isNull("name");
Where where2 = new Where();
where2.greaterThan("price", 10);

// and
Where where = Where.and(where1, where2);

// or
Where where = Where.or(where1, where2);

复杂组合查询

Where where1 = new Where();
where1.isNull("name");

Where where2 = new Where();
where2.greaterThan("price", 10);

Where where3 = new Where();
where3.greaterThan("amout", 3);

// where1 和 where2 是 and,然后与 where3 进行 or
Where finial = Where.or(Where.and(where1, where2), where3);
Query query = new Query();
query.put(finial);

获取符合筛选条件的数据总数

Table table = new Table("Products");
Query query = new Query();

table.countInBackground(query, new BaseCallback<Integer>() {
    @Override
    public void onSuccess(Integer integer) {
        // success
    }
    @Override
    public void onFailure(Throwable e) {
        // fail
    }
});

results matching ""

    powered by

    No results matching ""