wx.BaaS.TableObject 类

每个 TableObject 实例对应一张数据表，通过 TableObject 实例，你可以对数据表进行增删改查的操作。

初始化

初始化 TableObject 的参数可以用 tableID 或 tableName，这里推荐使用 tableName ( SDK >= 1.2.0 )。

new TableObject( tableID | tableName )

参数说明

tableID 和 tableName 二选一，不能同时存在

实例方法

create()

创建一行数据

返回值

wx.BaaS.TableRecord 类实例

createMany ([item, …], opts)

批量新增数据项

参数说明

返回值

Promise<ResObject>

ResObject 结构如下:

{
  statusCode: 201, // 状态码
  data: {
    succeed: 10, // 成功插入记录数
    total_count: 10 // 总的待插入记录数
  }
}

delete(query|recordID, opts)

批量/单个删除数据行

参数说明

query 和 recordID 二选一，不能同时存在

返回值

Promise<ResObject>

ResObject 结构如下:

{
  statusCode: 204,
  data: ""
}

getWithoutData( query | recordID )

获取 TableRecord 实例，以便于更新数据行

参数说明

返回值

wx.BaaS.TableRecord 类实例

get(recordID)

获取指定数据行的数据

参数说明

返回值

Promise<RecordObject>

RecordObject 结构如下：

{
  statusCode: 200,
  data: {
    _id: "59a3c2b5afb7766a5ec6e84e",
    amount: 0,
    created_at: 1503904437,
    created_by: 36395395,
    id: "59a3c2b5afb7766a5ec6e84e",
    write_perm: ["user:*"]
    // ...
  }
}

find()

执行查询动作

参数说明

无

返回值

Promise<ResObject>

ResObject 结构如下:

{
  statusCode: 200,
  data: {
    meta: {
      limit: 20,       // 当前查询的 limit
      next: null,
      offset: 0,       // 当前查询的 offset
      previous: null,
      total_count: 3   // 符合查询条件的数据行数量
    },
    objects: [         // 数据行数组
      {                  // 单个数据行内容
        _id: "59a3c2b5afb7766a5ec6e84e",
        // ... 数据行的其他字段
      },
    ]
  }
}

count()

统计符合条件的数据行数量

参数说明

无

返回值

Promise<Integer>

setQuery(query)

设置查询条件，将影响 find() 和 count() 的结果

参数说明

返回值

this，即当前 TableObject 实例

select(args)

指定筛选字段

返回值

this，即当前 TableObject 实例

expand(args)

返回值

this，即当前 TableObject 实例

limit(num)

返回值

this，即当前 TableObject 实例

offset(num)

返回值

this，即当前 TableObject 实例

orderBy(args)

指定排序值

返回值

this，即当前 TableObject 实例