简介

• 文档首页
• 数据服务
  • Android SDK
  • iOS SDK
  • 小程序
  • Cocos2D-X
  • C# SDK
  • GO
  • JavaScript
  • PHP
  • RESTful
• 云函数
  • Android SDK
  • iOS SDK
  • Java 云函数
  • JavaScript
  • C#
  • PHP
  • RESTful
  • Web
• 支付服务
  • Android SDK
  • iOS SDK
  • RESTful
• 短信服务
  • Android SDK
  • iOS SDK
  • JavaScript
  • PHP
  • RESTful
• IM服务
  • Android SDK
  • iOS SDK
• 推送服务
  • Android SDK
  • iOS SDK
  • JavaScript
  • PHP
  • RESTful
• 其他
  • 常见问题
  • 错误码
  • 数据安全
  • BQL
• 知识库
• 下载

iOS SDK

• 快速入门
• 开发文档
  • 简介
  • 安装
    • 使用CocoaPods安装BmobSDK
    • 兼容iOS9
    • 应用程序
    • 应用安全
  • 数据迁移
  • 对象
    • 数据对象
    • 特殊对象
    • 数据类型
    • 创建BmobObject对象
    • 添加数据
    • 更新数据
    • 删除数据
    • 批量数据操作
  • 查询
    • 查询单条数据
    • 查询多条数据
    • 条件查询
    • 复合查询
    • 返回指定列
    • 查询结果计数
    • 统计查询
    • 缓存查询
    • BQL查询
  • 数组
    • 添加数组数据
    • 删除数组数据
    • 更新数组数据
    • 查询数组数据
  • 数据关联
    • 关联关系描述
    • Pointer的使用
    • Relation的使用
  • 用户管理
    • 属性
    • 注册
    • 登录
    • 获取当前用户
    • 更新用户
    • 查询用户
    • 修改密码
    • 找回密码
    • 邮箱
    • 第三方账号登录
    • 手机号相关功能
  • 子类化
    • 子类化的使用
    • 针对BmobUser的特别说明
    • 查询
  • 文件管理
    • 创建文件对象
    • 上传文件
    • 以分片的方式上传文件
    • 批量上传文件
    • 下载文件
    • 删除文件
    • 缩略图
  • 数据实时功能
    • 监听功能
    • 取消监听功能
  • ACL和角色
    • 默认访问权限
    • 指定用户的访问权限
    • 角色管理
    • 角色之间的从属关系
  • 地理位置
    • 地理位置对象
    • 地理查询
  • 其它功能
    • 获取服务器时间
    • 设置API网络请求超时时间
    • 获取表结构
• 示例/功能
• 更新日志

简介

Bmob平台为您的移动应用提供了一个完整的后端解决方案，我们提供轻量级的SDK开发包，让开发者以最小的配置和最简单的方式使用Bmob平台提供的服务，进而完全消除开发者编写服务器代码以及维护服务器的操作。

安装

使用CocoaPods安装BmobSDK

如何使用CocoaPods安装BmobSDK可查看 我们提供的文档

兼容iOS9

iOS9默认不允许进行http请求，所以在使用SDK的过程中需要往Info.plist添加一些内容，

• 完全取消http请求限制

<key>NSAppTransportSecurity</key> 
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>

• 指定部分网址支持http

<key>NSAppTransportSecurity</key> 
<dict>
   <key>NSExceptionDomains</key>
      <dict>     
            <key>yourserver.com</key>    
        <dict>      
            <key>NSIncludesSubdomains</key>
                <true/>
                <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
                <true/>             
                <key>NSTemporaryExceptionMinimumTLSVersion</key>       
                <string>TLSv1.1</string>    
            </dict>   
        </dict>
 </dict>

另外，最新版的sdk已支持bitcode。

其他一些需要注意兼容iOS9的地方可以 参照这里

应用程序

在Bmob平台注册的每个账户都可以创建多个应用程序，每个应用程序都有其独自的应用程序ID，在后续程序编写中，所有的应用程序将凭其ID来使用Bmob SDK。同一个应用可以分别在测试环境和生产环境中部署不同的版本。

应用安全

请大家在使用Bmob开发应用程序之前，认真阅读我们给大家提供的“数据与安全”的文档，确保你的应用在发布时安全。文档 请点击;

数据迁移

从v2.1.8开始，数据SDK新增了能重新设置请求域名的Api，类似数据迁移，调用方式如下：

[Bmob resetDomain:@"http://demo.bmob.cn/"];

其中，参数为开发者的域名，调用后的所有请求都指向新的域名。

对象

数据对象

Bmob存储的数据是建立在BmobObject基础上的，每个BmobObject包含键(Key)-值(value)对的JSON兼容数据。这个数据是无模式的，这意味着不需要提前指定每个BmobObject存在什么键。你只需要设置你想要的键值对让我们在后端存储。

例如，假设你要记录一个游戏的得分。一个单一的BmobObject对象可能包含：score: 1337, playerName: "Sean Plott", cheatMode: false。键必须是字母、数字的字符串。值可以是字符串、数字、布尔值、Json数组、和BmobObject对象等。

每个BmobObject有一个ClassName，它对应后台的表名。例如，我们可以调用的游戏分数对象的ClassName为GameScore，那么它在后台对应的表名就是GameScore。

特殊对象

为了提供更好的服务，BmobSDK中提供了BmobUser、BmobInstallation两个特殊的BmobObject对象来完成不同的功能，在这里我们统一称为特殊对象。 BmobUser对象主要是针对应用中的用户功能而提供的，它对应着web端的User表，使用BmobUser对象可以很方便的在应用中实现用户的注册、登录、邮箱验证等功能，具体的使用方法可查看文档的用户部分。 BmobInstallation对象主要用于应用的安装设备管理中，它对应着web端的Installation表，任何安装了你应用的设备都会在此表中产生一条数据标示该设备。结合Bmob提供的推送功能，还可以实现将自定义的消息推送给不同的设备终端，具体的使用方法可查看文档的消息推送部分。

数据类型

目前为止，我们支持的数据类型有NSString、NSNumber、NSDate、NSArray、NSDictionary以及BmobObject及其子类对象类型。对应后台的类型为String、Number、Date、Array、Object以及Pointer。

创建BmobObject对象

BmobObject提供以下几种方法对BmobOjbect进行初始化：

/**
 *  创建一个带有className的BmobObject对象
 *
 *  @param  className   表示对象名称(类似数据库表名)
 *
 *  @return BmobObject
 */
+(instancetype )objectWithClassName:(NSString*)className;
/**
 *  创建一个带有className 和objectId的BmobObject对象
 *
 *  @param className 表名
 *  @param objectId  对象的id
 *
 *  @return BmobObject对象
 */
+(instancetype)objectWithoutDataWithClassName:(NSString*)className objectId:(NSString *)objectId;
/**
 *  从字典创建BmobObject
 *
 *  @param dictionary 字典
 *
 *  @return BmobObject 对象
 */
-(instancetype)initWithDictionary:(NSDictionary *)dictionary;

添加数据

添加一条数据有两步，第一步是构造数据，第二步是保存数据至服务器上，有以下两种方法：

/**
 *  后台保存BmobObject对象，没有返回结果
 */
-(void)saveInBackground;
/**
 *  后台保存BmobObject对象，返回保存的结果
 *
 *  @param  block   返回保存的结果是成功还是失败
 */
-(void)saveInBackgroundWithResultBlock:(BmobBooleanResultBlock)block;

比如，在一个游戏的应用中，当需要保存游戏分数、玩家信息到服务器中的时候，就可以创建GameScore表来添加数据，添加数据的形式类型与iOS中的NSMutableDictionary对象类似，如下：

    //在GameScore创建一条数据，如果当前没GameScore表，则会创建GameScore表
    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    //score为1200
    [gameScore setObject:[NSNumber numberWithInt:1200] forKey:@"score"];
    //设置userName为小明
    [gameScore setObject:@"小明" forKey:@"playerName"];
    //设置cheatMode为NO
    [gameScore setObject:[NSNumber numberWithBool:NO] forKey:@"cheatMode"];
    //设置age为18
    [gameScore setObject:[NSNumber numberWithInt:18] forKey:@"age"];
    //异步保存到服务器
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功后会返回objectId，updatedAt，createdAt等信息
            //创建对象成功，打印对象值
            NSLog(@"%@",gameScore);
        } else if (error){
            //发生错误后的动作
            NSLog(@"%@",error);
        } else {
            NSLog(@"Unknow error");
        }
    }];

运行完以上代码后，数据即可保存到服务器端了。为了确认数据是否真的已经保存成功，你可以在Bmob服务器端你的应用程序的数据浏览项目中查看。你应该看到类似这样的结果：

    objectId: "0c6db13c", score: 1200, playerName: "小明", cheatMode: false, createdAt:"2012-03-29 10:32:54", updatedAt:"2012-03-29 10:32:54"

这里需要注意几点：

• 在运行以上代码时，如果服务器端你创建的应用程序中已经存在GameScore数据表和相应的score、playerName、cheatMode等字段，那么你此时添加的数据和数据类型也应该和服务器端的表结构一致，否则将保存数据失败。
• 如果服务器端不存在GameScore数据表，那么Bmob将根据你第一次(也就是运行的以上代码)保存的GameSocre对象在服务器为你创建此数据表并插入相应数据。
• 每个BmobObject对象有几个默认的键(数据列)是不需要开发者指定的，objectId是每个保存成功数据的唯一标识符。createAt和updateAt代表每个对象(每条数据)在服务器上创建和最后修改的时间。这些键 (数据列)的创建和数据内容是由服务器端来完成的。
• 在 [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error)中，成功创建后，error返回的是nil，可以通过 error.localizedDescription 查看返回的错误信息，之后的类似于 xxInBackground 中的error也是一样的结构。
• objectId，updatedAt，createdAt这些系统属性在调用创建函数（saveInBackground）的时候不需要进行设置，创建成功后，会返回objectId，updatedAt，createdAt。

上述方法中每添加一条数据需要设置一次键值对，如果觉得过于繁琐，可以通过一个NSDictionary来添加数据，利用以下方法即可:

    -(void)saveAllWithDictionary:(NSDictionary*)dic;

这个函数。

如:

    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    //设置playerName列的值为小黑和age列的值18
    NSDictionary *dic = @{@"playerName":@"小黑",@"score":@18};
    [gameScore saveAllWithDictionary:dic];
    //异步保存
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功后的动作
        } else if (error){
            //发生错误后的动作
            NSLog(@"%@",error);
        } else {
            NSLog(@"Unknow error");
        }
    }];

更新数据

更新一个对象也是非常简单的，首先获取到要更新的BmobObject对象，进行修改值后再更新数据。例如：

- (void)updateObject{
    //创建一条数据，并上传至服务器
    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    [gameScore setObject:[NSNumber numberWithInt:1200] forKey:@"score"];
    //异步保存到服务器
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功后会返回objectId，updatedAt，createdAt等信息
            NSLog(@"创建成功,以下为对象值");
            NSLog(@"%@",gameScore);
            //此处是更新操作
            [gameScore setObject:[NSNumber numberWithInt:110] forKey:@"score"];
            [gameScore updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
                if (isSuccessful) {
                    NSLog(@"更新成功，以下为对象值，可以看到score值已经改变");
                    NSLog(@"%@",gameScore);
                } else {
                    NSLog(@"%@",error);
                }
            }];
        } else if (error){
            //发生错误后的动作
            NSLog(@"%@",error);
        } else {
            NSLog(@"Unknow error");
        }
    }];
}

如果列存储的是符合JSON格式的字符串对象，可以单独修改该对象的某个值，如有一列名为userAttibute，其值是: {"name":"John", "gender":"男"}，如果要修改name为Mike，可以使用以下代码

- (void)updateObjectJSONField{
    //创建一条数据，并上传至服务器
    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    NSDictionary *json = @{@"name":@"John", @"gender":@"man"};
    [gameScore setObject:json forKey:@"userAttibute"];
    //异步保存到服务器
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功后会返回objectId，updatedAt，createdAt等信息
            NSLog(@"创建成功,以下为对象值");
            NSLog(@"%@",gameScore);
            //此处是更新操作
            BmobObject *gameScoreChanged = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:gameScore.objectId];
            [gameScoreChanged setObject:@"Mike" forKey:@"userAttibute.name"];
            [gameScoreChanged updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
                if (isSuccessful) {
                    NSLog(@"更新成功，以下为对象值，可以看到json里面的name已经改变");
                    NSLog(@"%@",gameScoreChanged);
                } else {
                    NSLog(@"%@",error);
                }
            }];
        } else if (error){
            //发生错误后的动作
            NSLog(@"%@",error);
        } else {
            NSLog(@"Unknow error");
        }
    }];
}

此处要注意一点，就是在上传 gameScore 之后，如果要再次进行更新，请重新构造对象，因为此时的 gameScore 对象还含有userAttibute 的值，下面是错误的代码：

    //创建一条数据，并上传至服务器
    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    NSDictionary *json = @{@"name":@"John", @"gender":@"man"};
    [gameScore setObject:json forKey:@"userAttibute"];
    //异步保存到服务器
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功后会返回objectId，updatedAt，createdAt等信息
            NSLog(@"创建成功,以下为对象值");
            NSLog(@"%@",gameScore);
            //错误的做法，直接使用gameScore来设置，请观察gameScore值上传时的值
            [gameScore setObject:@"women" forKey:@"userAttibute.gender"];
            NSLog(@"上传前的gameScore对象值\n%@",gameScore);
            [gameScore updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
                if (isSuccessful) {
                    NSLog(@"更新成功，以下为对象值，可以看到json里面的gender已经改变");
                    NSLog(@"%@",gameScore);
                } else {
                    NSLog(@"%@",error);
                }
            }];
        } else if (error){
            //发生错误后的动作
            NSLog(@"%@",error);
        } else {
            NSLog(@"Unknow error");
        }
    }];
}

运行后查看log，我们可以看到，除了userAttibute属性外，gameScore对象还有userAttibute.gender属性上传至服务器，这样服务器就无法区分客户端到底是要更新 userAttibuteg还是只更新userAttibute中的gender，从而报错。

2015-12-14 20:45:55.417 BmobSDKDemo[16867:1430005] 创建成功,以下为对象值
2015-12-14 20:45:55.418 BmobSDKDemo[16867:1430005]
className = GameScore;
objectId = 0f3d45dbc5;
createdAt = 2015-12-14 12:45:55 +0000;
updatedAt = 2015-12-14 12:45:55 +0000;
date = {
    userAttibute =     {
        gender = man;
        name = John;
    };
};
2015-12-14 20:45:55.419 BmobSDKDemo[16867:1430005] 上传前的gameScore对象值
className = GameScore;
objectId = 0f3d45dbc5;
createdAt = 2015-12-14 12:45:55 +0000;
updatedAt = 2015-12-14 12:45:55 +0000;
date = {
    userAttibute =     {
        gender = man;
        name = John;
    };
    "userAttibute.gender" = women;
};

原子计数器

为了存储一个计数器类型的数据，Bmob提供对任何数字字段进行原子增加(或者减少)的功能，所以我们可以让score像下面一样增加一个固定的值:

    //创建一条数据，并上传至服务器
    BmobObject  *gameScore = [BmobObject objectWithClassName:@"GameScore"];
    [gameScore setObject:@0 forKey:@"atomicCounter"];
    [gameScore saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            BmobObject *gameScoreToBeChanged = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:gameScore.objectId];
            [gameScoreToBeChanged incrementKey:@"atomicCounter"];
            [gameScoreToBeChanged updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
                if (isSuccessful) {
                    NSLog(@"添加成功，可在后台查看objectID为%@的atomicCounter的值是否为1",gameScoreToBeChanged.objectId);
                } else {
                    NSLog(@"%@",error);
                }
            }];
        } else {
            NSLog(@"%@",error);
        }
    }];

也提供了

//列的值增加amount
- (void)incrementKey:(NSString *)key byAmount:(NSInteger )amount
//列的值减去一
- (void)decrementKey:(NSString *)key
//列的值减去amount
- (void)decrementKey:(NSString *)key byAmount:(NSInteger )amount

注意：需要调用更新函数才能完成计数器原子增加(或者减少)。

删除数据

从服务器删除对象：

    BmobObject *bmobObject = [BmobObject objectWithoutDataWithClassName:@"GameScore"  objectId:@"baaf9cfa1b"];
    [bmobObject deleteInBackgroundWithBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //删除成功后的动作
            NSLog(@"successful");
        } else if (error){
            NSLog(@"%@",error);
        } else {
            NSLog(@"UnKnow error");
        }
    }];

批量数据操作

Bmob提供了批量操作的类BmobObjectsBatch,使用该类，可以批量增加，修改，删除数据，但一次请求不能超过50条数据。下面是例子程序：

BmobObjectsBatch    *batch = [[BmobObjectsBatch alloc] init] ;
//在GameScore表中创建一条数据
[batch saveBmobObjectWithClassName:@"GameScore" parameters:@{@"aveScore": @{@"数学":@90},@"score":@78}];
//在GameScore表中更新objectId为27eabbcfec的数据
[batch updateBmobObjectWithClassName:@"GameScore" objectId:@"27eabbcfec" parameters:@{@"score": @85}];
//在GameScore表中删除objectId为30752bb92f的数据
[batch deleteBmobObjectWithClassName:@"GameScore" objectId:@"30752bb92f"];
[batch batchObjectsInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
    NSLog(@"batch error %@",[error description]);
}];

查询

查询单条数据

在某些情况下，如果知道某条数据的objectId，而且想得知该条数据的内容，可以使用BmobQuery检索得到一个完整的BmobObject：

//查找GameScore表
BmobQuery   *bquery = [BmobQuery queryWithClassName:@"GameScore"];
//查找GameScore表里面id为0c6db13c的数据
[bquery getObjectInBackgroundWithId:@"0c6db13c" block:^(BmobObject *object,NSError *error){
  if (error){
        //进行错误处理
  }else{
      //表里有id为0c6db13c的数据
      if (object) {
          //得到playerName和cheatMode
          NSString *playerName = [object objectForKey:@"playerName"];
          BOOL cheatMode = [[object objectForKey:@"cheatMode"] boolValue];
          NSLog(@"%@----%i",playerName,cheatMode);
          //打印objectId,createdAt,updatedAt
          NSLog(@"object.objectId = %@", [object objectId]);
          NSLog(@"object.createdAt = %@", [object createdAt]);
          NSLog(@"object.updatedAt = %@", [object updatedAt]);
      }
  }
}];

查询多条数据

在某些情况下，当需要查询表中多条元素的时候，可以直接使用findObjectsInBackgroundWithBlock函数获取查询结果，默认100条。

BmobQuery   *bquery = [BmobQuery queryWithClassName:@"GameScore"];
//查找GameScore表的数据
[bquery findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        for (BmobObject *obj in array) {
            //打印playerName
            NSLog(@"obj.playerName = %@", [obj objectForKey:@"playerName"]);
            //打印objectId,createdAt,updatedAt
            NSLog(@"obj.objectId = %@", [obj objectId]);
            NSLog(@"obj.createdAt = %@", [obj createdAt]);
            NSLog(@"obj.updatedAt = %@", [obj updatedAt]);
    }
}];

这里需要注意的是：

1.默认情况下，系统实际上并不会返回所有的数据，而是默认返回10条数据记录，你可以通过setLimit方法设置返回的记录数量。更多细节可点击查看查询一节中的分页查询。

2.当查询的是用户表这种系统表的时候，返回的是BmobUser的数组，设备表，角色表也是这样的。

3.查询用户表，设备表、角色表为：

BmobQuery   *bquery = [BmobUser query]; //用户表
BmobQuery   *bquery = [BmobInstallation query]; //设备表
BmobQuery   *bquery = [BmobRole query]; //角色表

条件查询

比较查询

当然了，在大多数情况下，开发者还是会通过特定的条件来筛选，过滤某些数据来进行查询。BmobQuery也提供了对应的查询方法。

如果要过滤特定键的值可以使用- (void)whereKey:(NSString *)key notEqualTo:(id)object。比如需要查询playerName不等于”小明”的数据时可以这样写：

当然，你也可以在你的查询操作中添加多个约束条件，来查询符合要求的数据。

BmobQuery   *bquery = [BmobQuery queryWithClassName:@"GameScore"];
//添加playerName不是小明的约束条件
[bquery whereKey:@"playerName" notEqualTo:@"小明"];

各种不同条件的比较查询，还有

各种不同的比较查询：
[bquery whereKey:@"age" lessThan:[NSNumber numberWithInt:18]];//age小于18
[bquery whereKey:@"age" lessThanOrEqualTo:[NSNumber numberWithInt:18]]; //age小于或等18
[bquery whereKey:@"age" greaterThan:[NSNumber numberWithInt:18]]; //age大于18
[bquery whereKey:@"age" greaterThanOrEqualTo:[NSNumber numberWithInt:18]]; //age大于或等于18

这里有点需要注意的是

时间搜索的话，等于的情况因为服务器是精确到微秒值，所以比较的值要加1秒。

子查询

如果你想查询匹配几个不同值的数据，如要查询“小明”，“小红”，“小白”三个人的信息是，可以使用

- (void)whereKey:(NSString *)key containedIn:(NSArray *)array;

函数，如下面所示：

[bquery whereKey:@"playerName" containedIn:[NSArray arrayWithObjects:@"小明",@"小红",@"小白", nil]];

如果是关联关系，直接在数组里面填写objectId即可，如下

 [bquery whereKey:@"author" containedIn:@[@"063a2d739e",@"b97ca382c3"]];

相反，要排除这几个人的信息可以用

- (void)whereKey:(NSString *)key notContainedIn:(NSArray *)array;

函数，如下所示：

[bquery whereKey:@"playerName" notContainedIn:[NSArray arrayWithObjects:@"小明",@"小红",@"小白", nil]];

列值是否存在

其他的约束条件有

//设置查询中该字段是有值的结果
-(void)whereKeyExists:(NSString *)key;
//设置查询中该字段是没有值的结果
-(void)whereKeyDoesNotExist:(NSString *)key;

例如:

//查询表中score列有值的数据
[bquery whereKeyExists:@"score"];

//查询表中score列没有值的数据
[bquery whereKeyDoesNotExist:@"score"];

模糊查询

对字符串值的模糊查询 比如查询包含字符串的值，有几种方法。如下：

//使用正则表达式查询
-(void)whereKey:(NSString*)key matchesWithRegex:(NSString*)regex;
//查询以特定字符串开头的值
-(void)whereKey:(NSString *)key startWithString:(NSString*)start;
//查询以特定字符串结尾的值
-(void)whereKey:(NSString *)key endWithString:(NSString*)end;

注:模糊查询只对付费用户开放，付费后可直接使用。

分页查询

有时，在数据比较多的情况下，你希望查询出的符合要求的所有数据能按照多少条为一页来显示，这时可以使用limit方法来限制查询结果的数据条数来进行分页。默认情况下，Limit的值为100，最大有效设置值1000（设置的数值超过1000还是视为1000）。

bquery.limit = 3;//限制得到的结果条数为3条

在数据较多的情况下，在limit的基础上分页显示数据是比较合理的解决办法，skip属性可以做到跳过查询的前多少条数据来实现分页查询的功能。默认情况下Skip的值为0。

bquery.skip = 3;//跳过3条数据

排序

对应数据的排序，如数字和字符串，可以使用升序或降序的方式来控制查询数据的结果顺序：

// 升序
- (void)orderByAscending:(NSString *)key ;
// 降序
- (void)orderByDescending:(NSString *)key ;

例如，分数由高到低的排序可以写成

[bquery orderByDescending:@"score"];

当需要组合排序的时候可以这样处理

//先按照年龄升序排序，年龄一样再按照更新时间降序排序
[bquery orderByAscending:@"age"]
[bquery orderByDescending:@"updatedAt"]

复合查询

当简单的查询条件，不能满足查询要时，BmobQuery也提供了2种复合查询的方法。

//并查询
-(void)addTheConstraintByAndOperationWithArray:(NSArray*)array;
//或查询
-(void)addTheConstraintByOrOperationWithArray:(NSArray *)array;

数组里面存的是若干个条件字典，其格式为

@{@"列名":条件值}

例如：

//查询score列中值等于5且姓名为Mike的数据
NSArray *array =  @[@{@"score":@5},@{@"name":@"Mike"}];
[bquery addTheConstraintByAndOperationWithArray:array];

支持的条件符号有

例如:

//查询score列中值大于150或者小于5的数据
NSArray *array =  @[@{@"score":@{@"$gt":@150}},@{@"score":@{@"$lt":@5}}];
[bquery addTheConstraintByOrOperationWithArray:array];

//查询score列中值大于5和小于150的数据
NSArray *array =  @[@{@"score":@{@"$gt":@5}},@{@"score":@{@"$lt":@150}}];
[bquery addTheConstraintByAndOperationWithArray:array];

需要注意的是，如果是要查找条件为等于的数据的话，直接构造成{@"列名":条件}即可，例如下面的例子:

//查找分数为90分跟分数为150分的数据
NSArray *array =  @[@{@"score":@90},@{@"score":@150}];
[bquery addTheConstraintByOrOperationWithArray:array];
//查找名字为张三跟李四的数据
NSArray *array =  @[@{@"name":@"张三"},@{@"name":"李四"}];
[bquery addTheConstraintByOrOperationWithArray:array];

其中日期类型和pointer类型构造的方法比较特殊。 例如要查询要个时间段的数据，可以构造时间

//createdAt大于或等于 2014-07-15 00:00:00
 NSDictionary *condiction1 = @{@"createdAt":@{@"$gte":@{@"__type": @"Date", @"iso": @"2014-07-15 00:00:00"}}}; 
//createdAt小于 2014-10-15 00:00:00
NSDictionary *condiction2 = @{@"createdAt":@{@"$lt":@{@"__type": @"Date", @"iso": @"2014-10-15 00:00:00"}}};
NSArray *condictonArray = @[condiction1,condiction2];
//作用就是查询创建时间在2014年7月15日到2014年10月15日之间的数据
[bquery addTheConstraintByAndOperationWithArray:condictonArray];

如果查询的条件刚好是pointer类型的话，例如要查询某篇文章的作者是A或者B的话，可以这样构造数据:

BmobQuery *query = [BmobQuery queryWithClassName:@"Post"];
//列author为pointer类型，指向用户表
//假设用户A的objectId为aaaa ,其中classname为表名
NSDictionary *condiction1 = @{@"author":@{@"__type":@"Pointer",@"className":@"_User",@"objectId":@"aaaa"}};
//假设用户b的objecId为bbbb
NSDictionary *condiction2= @{@"author":@{@"__type":@"Pointer",@"className":@"_User",@"objectId":@"bbbb"}};
NSArray *condictionArray = @[condiction1,condiction2];
//查找作者为用户A或者作者为用户B的数据
[query addTheConstraintByOrOperationWithArray:condictionArray];
[query findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
}];

另外我们还封装了以下方法，方便开发者使用，以下是与查询，注意add之前的查询只能添加一个条件，如果是或查询，将[main andOperation];换成[main orOperation];

    BmobQuery   *bquery = [BmobQuery queryWithClassName:@"GameScore_LT"];
    [bquery whereKey:@"score" equalTo:[NSNumber numberWithDouble:10.3]];
    BmobQuery   *bquery1 = [BmobQuery queryWithClassName:@"GameScore_LT"];
    [bquery1 whereKey:@"playerName" equalTo:@"test"];
    BmobQuery   *main = [BmobQuery queryWithClassName:@"GameScore_LT"];
    [main add:bquery];
    [main add:bquery1];
    [main andOperation];
    [main findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        for (BmobObject *obj in array) {
            //打印playerName
            NSLog(@"%@",obj);
            NSLog(@"obj.playerName = %@", [obj objectForKey:@"playerName"]);
        }
    }];

返回指定列

有的时候，一张表的数据列比较多，而我们只想查询返回某些列的数据时，我们可以使用以下方法来只返回需要的列的值

//设置查询后返回的字段数组  
-(void)selectKeys:(NSArray*)keys;

//指定返回查询的结果包括score和playerName两列的数据
[bquery selectKeys:@[@"score",@"playerName"]];

查询结果计数

如果你只是想统计满足查询对象的数量，你并不需要获取所有匹配的对象的具体数据信息，可以直接使用count替代find。例如，查询一个特定玩家玩的游戏场数：

BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore"];
[bquery whereKey:@"playerName" equalTo:@"Barbie"];
[bquery countObjectsInBackgroundWithBlock:^(int number,NSError  *error){
         NSLog(@"%d",num);
}];

统计查询

如果你想对表进行统计查询，可以采用以下方法。

统计查询方法

统计方法共有以下几种,分别用于计算总和、平均值、最大值、最小值

- (void)sumKeys:(NSArray *)keys
- (void)averageKeys:(NSArray *)keys
- (void)maxKeys:(NSArray *)keys
- (void)minKeys:(NSArray *)keys

设置完成后使用下面的方法来返回结果。

- (void)calcInBackgroundWithBlock:(BmobObjectArrayResultBlock)block

例如，如果我们要计算GameScore表所有玩家的得分总和，可以使用以下代码：

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore"];
    NSArray *sumArray = [NSArray arrayWithObject:@"score"];
    [bquery sumKeys:sumArray];
    [bquery calcInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"error is:%@",error);
        } else{
            if (array) {
                NSLog(@"%@",array);
                NSDictionary *dic = [[NSDictionary alloc] init];
                dic = [array objectAtIndex:0];
                NSLog(@"sum of score:%d",[[dic objectForKey:@"_sumScore"] intValue] );
            }
        }
    }];

计算总和只对Number类型的列有效，列名使用数组存放。返回的字典key值为_sum+首字母大写的列名，其它计算方法与sum类似，其返回的字典key值见下表

分组统计

分组可用于获取并不复杂的列值，如我想知道playerName列中有多少个不同的玩家名字，可使用以下代码：

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore_LT"];
    NSArray *groupbyArray = [NSArray arrayWithObject:@"playerName"];
    [bquery groupbyKeys:groupbyArray];
    [bquery calcInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"error is:%@",error);
        } else{
            if (array) {
                NSLog(@"%@",array);
                for (NSDictionary *dic in array) {
                    NSString *playerName = [dic objectForKey:@"playerName"];
                    NSLog(@"player:%@",playerName);
                }
            }
        }
    }];

另外，groupby可以结合计算函数来使用，比如我想统计每个玩家的总分，可以使用以下代码：

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore"];
    NSArray *groupbyArray = [NSArray arrayWithObject:@"playerName"];
    NSArray *sumArray = [NSArray arrayWithObject:@"score"];
    [bquery groupbyKeys:groupbyArray];
    [bquery sumKeys:sumArray];
    [bquery calcInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"error is:%@",error);
        } else{
            if (array) {
                NSLog(@"%@",array);
                for (NSDictionary *dic in array) {
                    NSString *playerName = [dic objectForKey:@"playerName"];
                    NSString *sum = [dic objectForKey:@"_sumScore"];
                    NSLog(@"player:%@\tsum:%@",playerName,sum);
                }
            }
        }
    }];

分组记录数

有时候，我们还想知道分组统计时每个分组有多少条记录，设置isGroupcount为YES即可,如下：

    bquery.isGroupcount = YES;

这样在返回的结果中就会包含类似于以下的键值对：

_count = 10

添加过滤条件

利用计算方法返回来的值可以通过限制条件来获取我们想关注的结果。添加条件使用以下方法。

 -(void)constructHavingDic:(NSDictionary *)havingDic

该方法通过构造havingDic来添加限制条件，其使用方法与复杂查询类似。

例如，我们统计每个玩家的总分，但我们只需要得到总分大于50的玩家，可以使用以下代码得到：

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"GameScore"];
    NSArray *groupbyArray = [NSArray arrayWithObject:@"playerName"];
    [bquery groupbyKeys:groupbyArray];
    NSArray *sumArray = [NSArray arrayWithObject:@"score"];
    [bquery sumKeys:sumArray];
    NSDictionary *condication = [[NSDictionary alloc] initWithObjectsAndKeys:[NSNumber numberWithInt:50],@"$gt", nil];
    [bquery constructHavingDic:[[NSDictionary alloc] initWithObjectsAndKeys:condication,@"_sumScore", nil]];
    [bquery calcInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"error is:%@",error);
        } else{
            if (array) {
                NSLog(@"%@",array);
                for (NSDictionary *dic in array) {
                    NSString *playerName = [dic objectForKey:@"playerName"];
                    NSString *sum = [dic objectForKey:@"_sumScore"];
                    NSLog(@"player:%@\tsum:%@",playerName,sum);
                }
            }
        }
    }];

缓存查询

缓存查询通常是将查询结果缓存在磁盘上，当用户的设备处于离线状态时，就可以从缓存中获取数据来显示。或者在应用界面刚刚启动，从网络获取数据还未得到结果时，先使用缓存数据来显示。这样可以让用户不必在按下某个按钮后进行枯燥的等待。 默认的查询操作是没有启用缓存的，开发者可以通过设置BmobCachePolicy来启用缓存功能。例如：优先从网络获取数据，如果获取失败时再从缓存获取数据，这种情况通常用在网络不可用的情况下。

bquery.cachePolicy = kBmobCachePolicyNetworkElseCache;
[bquery findObjectsInBackgroundWithBlock:^(NSArray *array,NSError *error){
}];

BmobSDK提供几种不同的缓存策略，以使用不同应用场景的需求。

• kBmobCachePolicyIgnoreCache

只从网络获取数据，且数据不会缓存在本地，这是默认的缓存策略。

• kBmobCachePolicyCacheOnly

只从缓存读数据，如果缓存没有数据，返回一个空数组。

• kBmobCachePolicyNetworkOnly

只从网络获取数据，同时会在本地缓存数据。

• kBmobCachePolicyCacheElseNetwork

先从缓存读取数据，如果没有再从网络获取。

• kBmobCachePolicyNetworkElseCache

先从网络获取数据，如果没有，再从缓存读取。

• kBmobCachePolicyCacheThenNetwork

先从缓存读取数据，无论结果如何都会再次从网络获取数据，在这种情况下，Block将产生两次调用。通常这种做法是先快速从缓存读取数据显示在界面，然后在后台连接网络获取最新数据，取到后再更新界面。

|检查是否存在当前查询条件的缓存数据

[bquery hasCachedResult];

存在返回YES，否则返回NO |清除当前查询的缓存数据

[bquery clearCachedResult];

|清除所有查询结果的缓存数据

[BmobQuery clearAllCachedResults];

|设置缓存有限时间，单位为秒

bquery.maxCacheAge = 10000;

BQL查询

Bmob Query Language（简称 BQL）是 Bmob 自 BmobSDK V1.5.7 版本开始，为查询 API 定制的一套类似 SQL 查询语法的子集和变种，主要目的是降低大家学习 Bmob 查询 API 的成本，可以使用传统的 SQL 语法来查询 Bmob 应用内的数据。

具体的 BQL 语法，请参考 Bmob Query Language 详细指南。

基本BQL查询

可以通过以下方法来进行SQL查询：

例如：需要查询所有的游戏得分记录

    BmobQuery *bmobQuery = [[BmobQuery alloc] init];
    NSString *bql = @"select * from GameScore_BQL";
    [bmobQuery queryInBackgroundWithBQL:bql block:^(BQLQueryResult *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            if (result) {
                NSLog(@"%@",result.resultsAry);
            }
        }
    }];

其中result.resultsAry为BmobObject数组。

如果需要查询个数，则可以这样：

    NSString *bql = @"select count(*) from GameScore_BQL";
    BmobQuery *bmobQuery = [[BmobQuery alloc] init];
    [bmobQuery queryInBackgroundWithBQL:bql block:^(BQLQueryResult *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            if (result) {
                NSLog(@"%d",result.count);
            }
        }
    }];

其中result.count为记录条数，需要注意的是如果没有使用count关键字进行查询的话，对象result的count属性是没有意义的。

统计BQL查询

由于统计查询的结果是不定的，故BQL提供了另外一种查询方法来进行统计查询，可以使用 - (void)statisticsInBackgroundWithBQL:(NSString *)bql block:(BmobBQLArrayResultBlock)block; 方法来进行。

     NSString *bql = @"select sum(score) from GameScore_BQL group by playerName";
    [bmobQuery statisticsInBackgroundWithBQL:bql block:^(NSArray *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            if (result) {
                NSLog(@"%@",result);
            }
        }
    }];

目前统计查询支持的关键字如下表所示，即如果在sql语句中包含以下关键字时，则需要使用统计查询方法才能返回正确结果：

占位符查询

在更多的时候，一个查询语句中间会有很多的值是可变值，为此，我们也提供了类似 Java JDBC 里的 PreparedStatement 使用占位符查询的语法结构。

注：目前只有where和limit关键字以及内置函数支持使用占位符。

普通查询

    BmobQuery *bmobQuery = [[BmobQuery alloc] init];
    NSString *bql = @"select * from GameScore_BQL where playerName = ? and score = ?";
    NSArray *placeholderArray = @[@"name2",@9];
    [bmobQuery queryInBackgroundWithBQL:bql pvalues:placeholderArray block:^(BQLQueryResult *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            if (result) {
                NSLog(@"%@",result.resultsAry);
            }
        }
    }];

数组中的数据会依次替换bql中的问号。

内置函数

对于包含内置函数的占位符查询，比较特殊，请使用Bmob Query Language 详细指南中的内置函数中占位符查询用到的内置函数用到的内置函数列出的形式进行查询操作：

举例：我想查询在 '2015-05-14 14:56:30' 后的创建的记录，可以这样：

    BmobQuery *bmobQuery = [[BmobQuery alloc] init];
    NSString *bql = @"select * from GameScore_BQL where createdAt > date(?)";
    NSArray *placeholderArray = @[@"2015-05-14 14:56:30"];
    [bmobQuery queryInBackgroundWithBQL:bql pvalues:placeholderArray block:^(BQLQueryResult *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            if (result) {
                NSLog(@"%@",result.resultsAry);
            }
        }
    }];

注

1、我们更推荐使用占位符语法，理论上会降低 BQL 转换的性能开销；

2、同样的，统计查询也支持占位符,只需要- (void)statisticsInBackgroundWithBQL:(NSString *)bql pvalues:(NSArray*)pvalues block:(BmobBQLArrayResultBlock)block;方法即可。

BQL缓存策略

如果要使用缓存策略，可用 - (void)queryBQLCanCacheInBackgroundWithblock:(BmobBQLObjectResultBlock)block; 方法，样例代码如下：

    NSString *bql = [NSString stringWithFormat:@"select * from %@ where %@ = ?",TABLENAME,COLPLAYERNAME];
    NSArray *placeholder = @[@"name1"];
    BmobQuery *bmobQueryWriteCache = [[BmobQuery alloc] init];
    bmobQueryWriteCache.cachePolicy = kBmobCachePolicyNetworkOnly;
    [bmobQueryWriteCache setBQL:bql];
    [bmobQueryWriteCache setPlaceholder:placeholder];
    [bmobQueryWriteCache queryBQLCanCacheInBackgroundWithblock:^(BQLQueryResult *result, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else if (result){
            NSLog(@"actual:%@",result);
        }
    }];

注意：

• BQL查询方法中，只有 - (void)queryBQLCanCacheInBackgroundWithblock:(BmobBQLObjectResultBlock)block; 才能使用缓存策略，其它方法即使设置了缓存策略也无缓存效果；
• 使用- (void)queryBQLCanCacheInBackgroundWithblock:(BmobBQLObjectResultBlock)block;进行查询时，通过 -(void)setBQL:(NSString*)bql; 和 -(void)setPlaceholder:(NSArray*)ary; 来设置BQL语句和占位符。

缓存策略只对普通查询有效，统计查询只支持从网络进行查询。具体使用可参考iOS开发文档中的查询缓存查询小节。

数组

为了存储数组型数据，Bmob提供了3种操作来原子性地更改一个数组字段:

Add 在一个数组字段的后面添加一些指定的对象(包装在一个数组内)

AddUnique 只会在原本数组字段中没有这些对象的情形下才会添加入数组，插入数组的位置不固定的

Remove 从一个数组字段的值内移除指定的数组中的所有对象

添加数组数据

添加一行记录时创建一个普通的类似于列表的数组类型字段，可以使用以下方法添加：

BmobObject *gameScore = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:@"xxxxxxxx"];
[gameScore addObjectsFromArray:@[@"P1",@"P2"] forKey:@"skill"];
[gameScore updateInBackground];

删除数组数据

当需要移除数组里的数据时可以使用

-(void)removeObjectsInArray:(NSArray *)objects forKey:(NSString *)key;

如下面就移除了P3这个元素:

BmobObject *gameScore = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:@"xxxxxxxx"];
[gameScore removeObjectsInArray:@[@"P3"] forKey:@"skill"];
[gameScore updateInBackground];

更新数组数据

每一种方法都会有一个objects，即包含了这些方法将被添加或删除的对象列表，举个例子，技能skills是一个类似于集合的数组类型，那么我们可以在skills中加入一些对象，只有在skills原来的对象中不包含这些值的情况下才会被加入:

BmobObject *gameScore = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:@"xxxxxxxx"];
[gameScore addUniqueObjectsFromArray:@[@"P3"] forKey:@"skill"];
[gameScore updateInBackground];

查询数组数据

对于Key的类型是数组的情况，可以查找Key的数组值中包含有P1的对象。代码如下：

    //查询数组中包含某个元素的记录
    BmobQuery *query = [BmobQuery queryWithClassName:@"GameScore"];
    [query whereKey:@"skill" equalTo:@"P1"];
    [query findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            for (BmobObject *obj in array) {
                NSLog(@"%@",obj);
            }
        }
    }];

你同样可以使用"$all"操作符来找到类型为数组的Key的值中同时包含有P1和P2的对象:

    //查询数组中包含某些元素的记录
    BmobQuery *query1 = [BmobQuery queryWithClassName:@"GameScore
    "];
    NSArray *array = @[@"P1",@"P2"];
    [query1 whereKey:@"skill" equalTo:@{@"$all":array}];
    [query1 findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            for (BmobObject *obj in array) {
                NSLog(@"%@",obj);
            }
        }
    }];

当然，你也可以使用我们封装好的方法来查找

    //查询数组中包含某些元素的记录
    BmobQuery *query1 = [BmobQuery queryWithClassName:@"GameScore"];
    NSArray *array = @[@"P1",@"P2"];
    [query1 whereKey:@"skill" containsAll:array];
    [query1 findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            for (BmobObject *obj in array) {
                NSLog(@"%@",obj);
            }
        }
    }];

如果要查找包含P1或P2的对象，可以使用复杂查询中的或查

    BmobQuery *query = [BmobQuery queryWithClassName:@"Post"];
    NSArray *array =  @[@{@"skill":@{@"$all": @[@"P1"]}},@{@"skill":@{@"$all":@[@"P2"]}}];
    [query addTheConstraintByOrOperationWithArray:array];
    [query findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else {
            NSLog(@"%d",array.count);
            for (BmobObject *obj in array) {
                 NSLog(@"%@",obj);
            }
        }
    }];

使用索引和对象key修改数组中的对象

比如你当前行有一列叫用户的工作经验projectExperiences，是一个Array数组列，里面包含了多个对象值：[{"name":"项目名称","descr":"项目描述"，"startTime":"开始时间"，"endTime":"结束时间"}, …]

那么我们要修改projectExperiences数组中第一个对象的name值：

BmobObject *gameScore = [BmobObject objectWithoutDataWithClassName:@"GameScore" objectId:@"xxxxxxxx"];
[bmobObject setObject:@"项目名称2" forKey:@"projectExperiences.0.name"];
[gameScore updateInBackground];

数据关联

数据关联章节Demo下载

关联关系描述

在程序设计中，不同类型的数据之间可能存在某种关系。分别是以下三种： 1. 一对一，比如车队给司机分车，1个司机对应1台车； 2. 一对多，比如1个作者会对应多篇贴子； 3. 多对多，比如1篇帖子会有多个喜欢的读者，而每个读者也会有多篇喜欢的帖子。 前面的两种关系我们提供Pointer类型来表示，而最后一种关系我们使用Relation类型来表示

在下面的讲解中我们可能会使用到以下的两张表，其表结构如下：

_User

Post

预先在后台添加记录 _User表

Post表

Pointer的使用

添加关系

例如，user1写了一篇帖子，需要在Post表中添加一条记录，并且该记录包含一个关联author1记录的字段数据，可采用以下代码：

    BmobObject  *post = [BmobObject objectWithClassName:@"Post"];
    //设置帖子的标题和内容
    [post setObject:@"title4" forKey:@"title"];
    [post setObject:@"content4" forKey:@"content"];
    //设置帖子关联的作者记录
    BmobUser *author = [BmobUser objectWithoutDataWithClassName:@"_User" objectId:@"vbhGAAAY"];
    [post setObject:author forKey:@"author"];
    //异步保存
    [post saveInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            //创建成功，返回objectId，updatedAt，createdAt等信息
            //打印objectId
            NSLog(@"objectid :%@",post.objectId);
        }else{
            if (error) {
                NSLog(@"%@",error);
            }
        }
    }];

添加成功后在后台的结果如下图所示，我们可以看到，author列的值是用圆框框起来的，表示这是一个Pointer，显示的值，为对应记录的objectId,点击它可以进入_User表中：

我们可以这么理解关联关系，它就是一个类型为指针的字段，利用它可以指向其它表的某条记录。

删除关系

如果需要删除某篇帖子关联的作者可以使用

- (void)deleteForKey:(id)key

具体代码如下：

    BmobQuery   *bquery = [BmobQuery queryWithClassName:@"Post"];
    [bquery getObjectInBackgroundWithId:@"ZqQ7KKKx" block:^(BmobObject *object,NSError *error){
        if (error){
            NSLog(@"%@",error);
        }else{
            if (object) {
                BmobObject *post = object;
                //将author列的值置为空
                [post deleteForKey:@"author"];
                //进行更新
                [post updateInBackground];
            }
        }
    }];

结果如下，可以看到，author列已经被置空

修改关系

如果需要修改某篇帖子关联的作者，可以使用以下代码:

    BmobQuery   *bquery = [BmobQuery queryWithClassName:@"Post"];
    //获得objectId查找出先前添加的文章
    [bquery getObjectInBackgroundWithId:@"ZqQ7KKKx" block:^(BmobObject *object,NSError *error){
        if (error){
            NSLog(@"%@",error);
        }else if (object) {
            BmobObject *post = object;
            //获得BmobUser对象
            BmobUser *user = [BmobUser objectWithoutDataWithClassName:@"_User" objectId:@"qXZeCCCX"];
            //设置post的author值为新获得的BmobUser对象
            [post setObject:user forKey:@"author"];
            //进行更新
            [post updateInBackground];
        }
    }];

可以看到关联记录已经被修改：

查询关系

查询某个特定作者的帖子，可以用 -(void)whereKey:(NSString *)key equalTo:(id)object,具体代码如下

 //查询帖子表
 BmobQuery *query = [BmobQuery queryWithClassName:@"Post"];
 //构建objectId为vbhGAAAY 的作者
 BmobUser *author = [BmobUser objectWithoutDataWithClassName:@"_User" objectId:@"vbhGAAAY"];
 //添加作者是objectId为vbhGAAAY条件
 [query whereKey:@"author" equalTo:author];
 [query findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else if (array){
            for (BmobObject *post in array) {
                NSLog(@"%@",[post objectForKey:@"title"]);
            }
        }
    }];

如我们需要查询帖子，并且需要将该帖子关联的作者的信息（objectId,username）打印出来，我们可以使用以下代码：

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"Post"];
    //声明该次查询需要将author关联对象信息一并查询出来
    [bquery includeKey:@"author"];
    [bquery getObjectInBackgroundWithId:@"ZqQ7KKKx" block:^(BmobObject *object, NSError *error) {
        //打印文章标题，内容
        BmobObject *post = object;
        NSLog(@"title:%@",[post objectForKey:@"title"]);
        NSLog(@"content:%@",[post objectForKey:@"content"]);
        //取得文章的关联作者对象
        BmobUser *author = [post objectForKey:@"author"];
        //打印文章的关联作者对象的相关信息
        NSLog(@"objectId:%@",author.objectId);
        NSLog(@"name:%@",[author objectForKey:@"username"]);
    }];

查询关系的核心在于查询前需要将关联的列名include进来，使用下列方法即可

- (void)includeKey:(NSString *)key

如果查询多个关联关系，可以使用以下方法，使用逗号(,)操作来使查询中包含多个属性

[bquery includeKey:@"column1,column2,..."];

如果关联关系存在嵌套，可以使用以下英文字符点号(.)来操作，如下：

[bquery includeKey:@"column1.column2"];

另外，include 时可以指定返回的字段，如下：

//只返回likes列的数据
[bquery includeKey:@"post[likes]"];
//返回title和content列数据
[bquery includeKey:@"post[title|content]"];

约束关联对象值查询

我们可以对关联对象的值进行约束，来进行匹配查询。例如，如果我们想找查询出所有关联了user2的文章，可以使用以下代码

    BmobQuery *bquery = [BmobQuery queryWithClassName:@"Post"];
    //构造约束条件
    BmobQuery *inQuery = [BmobQuery queryWithClassName:@"_User"];
    [inQuery whereKey:@"username" equalTo:@"user2"];
    //匹配查询
    [bquery whereKey:@"author" matchesQuery:inQuery];
    [bquery findObjectsInBackgroundWithBlock:^(NSArray *array, NSError *error) {
        if (error) {
            NSLog(@"%@",error);
        } else if (array){
            for (BmobObject *post in array) {
                NSLog(@"%@",[post objectForKey:@"title"]);
            }
        }
    }];

如果想要查询找所有没有关联user1的文章，则将

[bquery whereKey:@"author" matchesQuery:inQuery];

替换成

[bquery whereKey:@"author" doesNotMatchQuery:inQuery];

即可。

Pointer本质

Pointer可以用来表示一对一或者一对多的关系，其实可以看成是我们将一个指向某条记录的指针记录下来，我们查询时可以通过该指针以获得另外关联的对象。当然，我们也可以给这些指针指向的关联记录进行约束，只查询出符合特定条件的记录。

Relation的使用

添加关联关系

如果我们需要在Post表中添加一个字段以记录喜欢该贴子的读者，我们可以使用以下代码：

    //获取要添加关联关系的post
    BmobObject *post = [BmobObject objectWithoutDataWithClassName:@"Post" objectId:@"ZqQ7KKKx"];
    //新建relation对象
    BmobRelation *relation = [[BmobRelation alloc] init];
    [relation addObject:[BmobObject objectWithoutDataWithClassName:@"_User" objectId:@"vbhGAAAY"]];
    [relation addObject:[BmobObject objectWithoutDataWithClassName:@"_User" objectId:@"qXZeCCCX"]];
    //添加关联关系到likes列中
    [post addRelation:relation forKey:@"likes"];
    //异步更新obj的数据
    [post updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            NSLog(@"successful");
        }else{
            NSLog(@"error %@",[error description]);
        }
    }];

可以看到添加了一个 likes 列，点击进去可以查看到该列里面存在哪些数据。

Post表：

从Post表中的title4记录点击关联关系框进去后查看的结果：

删除关联关系

如果要从刚刚的添加的likes列中删去其中一个读者，可采用以下代码。

    BmobObject *post = [BmobObject objectWithoutDataWithClassName:@"Post" objectId:@"ZqQ7KKKx"];
    //新建relation对象
    BmobRelation *relation = [[BmobRelation alloc] init];
    [relation removeObject:[BmobObject objectWithoutDataWithClassName:@"_User" objectId:@"vbhGAAAY"]];
    //添加关联关系到likes列中
    [post addRelation:relation forKey:@"likes"];
    //异步更新obj的数据
    [post updateInBackgroundWithResultBlock:^(BOOL isSuccessful, NSError *error) {
        if (isSuccessful) {
            NSLog(@"successful");
        }else{
            NSLog(@"error %@",[error description]);
        }
    }];