安装
- 四种安装方式
- cocoapods
- Dynamic FrameWork
- Carthage
- Static Framework
在这里只介绍常用的两种，具体介绍这里
cocoapods
- 安装 CocoaPods 1.1.0 或者更高版本；
- 执行 pod repo update，从而让 CocoaPods 更新至目前最新可用的 Realm 版本；
- 在您的 Podfile 中，将 pod 'Realm' 添加到应用目标中，并将 pod 'Realm/Headers' 添加到测试目标中；
- 在命令行中执行 pod install；
- 使用由 CocoaPods 生成的 .xcworkspace 文件来编写工程；
- 如果使用了 Realm Swift，请将 Swift/RLMSupport.swift 文件拖曳到 Xcode 工程的文件导航栏中，请确保选中了 Copy items if needed 选择框。
Static Framework
- 下载 Realm 的最新发布版本，并解压；
- 前往 Xcode 工程的 “General” 设置选项卡中，从 ios/static/ 目录中将 Realm.framework 拖曳到 Xcode 工程的文件导航器内。请确保勾选了 Copy items if needed，然后单击 Finish 按钮；
- 在 Xcode 文件导航器中选中工程。然后选择应用目标，前往 Build Phases 选项卡。在 Link Binary with Libraries 部分中单击 + 按钮，然后添加 libc++.tbd 和 libz.tbd。
- 如果使用了 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];
}];
}
相关特性
支持kvo和kvc
支持数据库加密
-
通知
通知处理模块可以对整个 Realm 数据库进行注册。每次涉及到 Realm 的写入事务提交之后，无论写入事务发生在哪个线程还是进程中，通知处理模块都会被激活：
// 获取 Realm 通知 token = [realm addNotificationBlock:^(NSString *notification, RLMRealm * realm) { [myViewController updateUI]; }]; // 随后 [token invalidate];
- 数据库迁移
注意问题
- 跨线程访问数据库，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]];
}];
});
