字段过滤与扩展

字段过滤

使用 select 来筛选请求返回的字段，设置需要返回的字段名，不需要返回的字段名前加 -。

在 get 方法中使用

• Swift
• Objective-C

// 返回特定字段
let select = ["created_at", "created_by"]
// 不返回特定字段
let select = ["-created_at", "-created_by"]
let recordId = "5c944a10d575a970a9b9****"
table.get(recordId, select: select) { (record, error) in
}

// 返回特定字段
NSArray *select = @[@"created_at", @"created_by"];
// 不返回特定字段
NSArray *select = @[@"-created_at", @"-created_by"];
[table get:@"5ca47715d625d8370597****" select:select expand:nil completion:^(BaaSRecord * _Nullable record, NSError * _Nullable error) {
}];

参数说明

返回结果

在 find 方法中使用

• Swift
• Objective-C

let query = Query()
// 返回特定字段
query.select = ["created_at", "created_by"]
// 返回特定字段
query.select = ["-created_at", "-created_by"]
table.find(query: query) { (listResult, error) in
}

BaaSQuery *query = [[BaaSQuery alloc] init];
// 返回特定字段
query.select = @[@"created_at", @"created_by"];
// 不返回特定字段
query.select = @[@"-created_at", @"-created_by"];
[_table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {
}];

参数说明

返回结果

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

字段扩展

开发者可以通过 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 方法中使用

• Swift
• Objective-C

// 扩展的字段
let expand = ["created_by", "pointer_value"]
let recordId = "5c944a10d575a970a9b9****"
table.get(recordId, expand: expand) { (record, error) in
}

// 扩展的字段
NSArray *expand = @[@"created_by", @"pointer_value"];
NSString *recordId = @"5ca09074be20d6749023****";
[_table get:recordId select:nil expand:expand completion:^(BaaSRecord * _Nullable record, NSError * _Nullable error) {
}];

参数说明

返回结果

在 find 方法中使用

• Swift
• Objective-C

let query = Query()
// 扩展的字段
table.expand = ["created_by", "pointer_value"]
table.find(query: query) { (listResult, error) in
}

BaaSQuery *query = [[BaaSQuery alloc] init];
// 返回特定字段
query.expand = @[@"created_by", @"pointer_value"];
[_table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {
}];

参数说明

返回结果