Realm基础

安装

• 四种安装方式
  • cocoapods
  • Dynamic FrameWork
  • Carthage
  • Static Framework

在这里只介绍常用的两种，具体介绍这里

cocoapods

1. 安装 CocoaPods 1.1.0 或者更高版本；
2. 执行 pod repo update，从而让 CocoaPods 更新至目前最新可用的 Realm 版本；
3. 在您的 Podfile 中，将 pod 'Realm' 添加到应用目标中，并将 pod 'Realm/Headers' 添加到测试目标中；
4. 在命令行中执行 pod install；
5. 使用由 CocoaPods 生成的 .xcworkspace 文件来编写工程；
6. 如果使用了 Realm Swift，请将 Swift/RLMSupport.swift 文件拖曳到 Xcode 工程的文件导航栏中，请确保选中了 Copy items if needed 选择框。

Static Framework

1. 下载 Realm 的最新发布版本，并解压；
2. 前往 Xcode 工程的 “General” 设置选项卡中，从 ios/static/ 目录中将 Realm.framework 拖曳到 Xcode 工程的文件导航器内。请确保勾选了 Copy items if needed，然后单击 Finish 按钮；
3. 在 Xcode 文件导航器中选中工程。然后选择应用目标，前往 Build Phases 选项卡。在 Link Binary with Libraries 部分中单击 + 按钮，然后添加 libc++.tbd 和 libz.tbd。
4. 如果使用了 Realm Swift，请将 Swift/RLMSupport.swift 文件拖曳到 Xcode 工程的文件导航栏中，请确保选中了 Copy items if needed 选择框。

查看数据库可以通过realm提供的<font color=red>Realm Browser</font>工具查看，可以从App Store下载

Realm使用

一. 数据库的创建

- (void)creatDataBaseWithName:(NSString *)databaseName{
    NSArray *docPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *path = [docPath objectAtIndex:0];
    NSString *filePath = [path stringByAppendingPathComponent:databaseName];
    NSLog(@"数据库目录 = %@",filePath);
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
    config.fileURL = [NSURL URLWithString:filePath];
    config.objectClasses = @[MyClass.class, MyOtherClass.class];
    config.readOnly = NO;
    int currentVersion = 1.0;
    config.schemaVersion = currentVersion;
    config.migrationBlock = ^(RLMMigration *migration , uint64_t oldSchemaVersion) {
       // 这里是设置数据迁移的block
        if (oldSchemaVersion < currentVersion) {
            // 没有什么要做的！
            // Realm 会自行检测新增和被移除的属性
            // 然后会自动更新磁盘上的架构
        }
    };
    [RLMRealmConfiguration setDefaultConfiguration:config];

}

二. 数据模型

创建数据模型就是创建数据库的表，只能继承 RLMObject 或者某个已存在的 Realm 数据模型类。

支持的属性类型

• Realm 支持下述属性类型：BOOL、bool、int、NSInteger、long、long long、float、double、NSString、NSDate、NSData 以及 被特殊类型标记的 NSNumber 。
  CGFloat 属性被取消了，因为它不具备平台独立性。

三. 对象操作

对象的所有更改（添加、修改和删除）都必须在写入事务内完成。

增

+ (void)addObject:(RLMObject *)obj{
    RLMRealm *realm = [RLMRealm defaultRealm];
    [realm transactionWithBlock:^{
        [realm addObject: obj];
    }];
}

查

查询将会返回一个 RLMResults 实例，其中包含了一组 RLMObject 对象。RLMResults的接口与NSArray基本相同，并且可以使用索引下标来访问包含在RLMResults当中的对象。与NSArray所不同的是，RLMResults中元素的类型是固定的，并且只能持有一个 RLMObject 子类类型。

所有的查询操作（包括检索和属性访问）在 Realm中都是延迟加载的。只有当属性被访问时，数据才会被读取。

//从默认数据库查询所有的车
RLMResults<Car *> *cars = [Car allObjects];

// 使用断言字符串查询
RLMResults<Dog *> *tanDogs = [Dog objectsWhere:@"color = '棕黄色' AND name BEGINSWITH '大'"];

// 使用 NSPredicate 查询
NSPredicate *pred = [NSPredicate predicateWithFormat:@"color = %@ AND name BEGINSWITH %@",
                     @"棕黄色", @"大"];
RLMResults *results = [Dog objectsWithPredicate:pred];

// 排序名字以“大”开头的棕黄色狗狗
RLMResults<Dog *> *sortedDogs = [[Dog objectsWhere:@"color = '棕黄色' AND name BEGINSWITH '大'"] sortedResultsUsingProperty:@"name" ascending:YES];

改

当没有主键的情况下，需要先查询，再修改数据。
当有主键的情况下，有以下几个非常好用的API

[realm addOrUpdateObject:Car];

[Car createOrUpdateInRealm:realm withValue:@{@"id": @1, @"price": @9000.0f}];

删

- (void)deleteObject:(RLMObject *)obj{
    RLMRealm *realm = [RLMRealm defaultRealm];
    [realm transactionWithBlock:^{
        [realm deleteObject: obj];
    }];
}

相关特性

1. 支持kvo和kvc

2. 支持数据库加密

3. 通知

   通知处理模块可以对整个 Realm 数据库进行注册。每次涉及到 Realm 的写入事务提交之后，无论写入事务发生在哪个线程还是进程中，通知处理模块都会被激活：

   // 获取 Realm 通知
   token = [realm addNotificationBlock:^(NSString *notification, RLMRealm * realm) {
       [myViewController updateUI];
   }];
   
   // 随后
   [token invalidate];
   

4. 数据库迁移

注意问题

• 跨线程访问数据库，Realm对象一定需要新建一个。同一个Realm对象是不支持跨线程操作realm数据库的。
• transactionWithBlock 已经处于一个写的事务中，事务之间不能嵌套
• 查询也不能跨线程查询

RLMResults * results = [self selectUserWithAccid:bhUser.accid];
    
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
        
        RLMRealm *realm = [RLMRealm defaultRealm];
        [realm transactionWithBlock:^{
            [realm addOrUpdateObject:results[0]];
        }];
    });