字段过滤与扩展

字段过滤

使用 select 来控制请求返回的字段

在 get 方法中使用

var Product = new BaaS.TableObject(tableID)
var recordID = 'xxxxxxxxx' // 指定数据行 id

// 规定返回特定字段
Product.select('created_at').get(recordID)
// or
Product.select(['created_at', 'created_by']).get(recordID)

// 规定不返回特定字段
Product.select('-created_at').get(recordID)
// or
Product.select(['-created_at', '-created_by']).get(recordID)

在 find 方法中使用

var Product = new BaaS.TableObject(tableID)

var query = new BaaS.Query()
query.compare('amount', '>', 0)

// 规定返回特定字段
Product.setQuery(query).select('created_at').find()
// or
Product.setQuery(query).select(['created_at', 'created_by']).find()

// 规定不返回特定字段
Product.setQuery(query).select('-created_at').find()
// or
Product.setQuery(query).select(['-created_at', '-created_by']).find()

注:

通过数组控制请求返回字段时,若数组内元素同时存在“规定返回”和“规定不返回”的字段,如:['-created_at', 'created_by']。后端服务会忽略掉此次操作,直接返回所有字段。

字段扩展

开发者可以通过 expand pointer 来查询该字段的更多信息,返回结果中的 pointer 字段会被替换为这个字段对应的完整的数据行对象。

created_by 字段是一个特殊的 pointer,开发者无需配置,默认指向了 _userpofile 表。 使用 expand 方法会增加一次数据表查询,api call 计费 +1

expand 返回结果示例

注:pointer_value 为指向其他表的 pointer 类型字段

不使用 expand

{
  "created_at": 1516118400,
  "created_by": 1234,
  "id": "5a2fa9b008443e59e0e67829",
  "name": "小米无线耳机",
  "price": 199,
  "pointer_value": "5a2fa9xxxxxxxxxxxxxx"
}

使用 expand

{
  "created_at": 1516118400,
  "created_by": {
    "avatar": "https://media.ifanrusercontent.com/tavatar/fb/cd/xxxx.jpg",
    "id": 62536607,
    "nickname": "Larry。"
  },
  "pointer_value": {
    "created_at": 1516118400,
    "name": "123",
    "id": "5a2fa9xxxxxxxxxxxxxx"
  },
  "id": "5a2fa9b008443e59e0e67829",
  "name": "小米无线耳机",
  "price": 199
}

使用方法

在 get 方法中使用

var Product = new BaaS.TableObject(tableID)
Product.expand(['created_by', 'pointer_value']).get('5acc2904da6b737322a82f78')

在 find 方法中使用

var Product = new BaaS.TableObject(tableID)

var query = new BaaS.Query()
query.compare('amount', '>', 0)

// 扩展特定字段
Product.setQuery(query).expand(['created_by', 'pointer_value']).find()

results matching ""

    powered by

    No results matching ""