Realm中文文檔：https://realm.io/cn/docs/objc/latest/
優(yōu)點：安全觉痛、穩(wěn)定、迅速
缺點：不能直接跨線程訪問同一對象, 不能分頁查詢
官方基本使用
1. 打開數(shù)據(jù)庫
// 默認配置
RLMRealm *realm = [RLMRealm defaultRealm];
// 獲取 Realm 文件的父目錄
NSString *folderPath = realm.configuration.fileURL.URLByDeletingLastPathComponent.path;
// 禁用此目錄的文件保護
[[NSFileManager defaultManager] setAttributes:@{NSFileProtectionKey: NSFileProtectionNone}
ofItemAtPath:folderPath error:nil];
// 自定義配置
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
// 獲取預植數(shù)據(jù)庫文件的 URL
config.fileURL = [[NSBundle mainBundle] URLForResource:@"MyBundledData" withExtension:@"realm"];
// 以只讀模式打開該文件咳榜，這是因為應用的預植數(shù)據(jù)庫是不可寫的
config.readOnly = YES;
config.schemaVersion = 1;
// 使用該配置來打開 Realm 數(shù)據(jù)庫
RLMRealm *realm = [RLMRealm realmWithConfiguration:config error:nil];
2. 內存或文件數(shù)據(jù)庫
// 設置 inMemoryIdentifier 會將 fileURL 置為 nil（反之亦然）状囱，創(chuàng)建一個完全在內存中運行的 Realm 數(shù)據(jù)庫 (in-memory Realm)，它將不會存儲在磁盤當中
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
config.inMemoryIdentifier = @"MyInMemoryRealm";
RLMRealm *realm = [RLMRealm realmWithConfiguration:config error:nil];
3. 刪除 Realm
需要清除緩存或者重置數(shù)據(jù)庫時掖桦，需要刪除所有數(shù)據(jù)或者刪除Realm文件，避免發(fā)生Crash, 以下方法可以使用
// 1. 應用啟動時、在打開 Realm 數(shù)據(jù)庫之前完成
RLMRealm *realm = [RLMRealm defaultRealm];
[realm beginWriteTransaction];
[realm deleteAllObjects];
[realm commitWriteTransaction];
// 2. 只在顯式聲明的自動釋放池中打開 Realm 數(shù)據(jù)庫祠肥，然后在自動釋放池后面進行刪除
@autoreleasepool {
// 在這里進行所有的 Realm 操作
}
NSFileManager *manager = [NSFileManager defaultManager];
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
NSArray<NSURL *> *realmFileURLs = @[
config.fileURL,
[config.fileURL URLByAppendingPathExtension:@"lock"],
[config.fileURL URLByAppendingPathExtension:@"note"],
[config.fileURL URLByAppendingPathExtension:@"management"]
];
for (NSURL *URL in realmFileURLs) {
NSError *error = nil;
[manager removeItemAtURL:URL error:&error];
if (error) {
// 錯誤處理
}
}
3. 對于每個用戶建立不同RLMRealmConfiguration，等待合適時機刪除
4. 數(shù)據(jù)模型
#import <Realm/Realm.h>
@class Person;
// 狗狗的數(shù)據(jù)模型
@interface Dog : RLMObject
@property NSString *name;
@property Person *owner;
@end
RLM_ARRAY_TYPE(Dog) // 定義 RLMArray<Dog>
// 主人的數(shù)據(jù)模型
@interface Person : RLMObject
@property NSString *name;
@property NSDate *birthdate;
@property RLMArray<Dog *><Dog> *dogs;
@end
RLM_ARRAY_TYPE(Person) // 定義 RLMArray<Person>
// Implementations
@implementation Dog
@end // none needed
@implementation Person
@end // none needed
1) 必需屬性
@interface Person : RLMObject
@property NSString *name;
@property NSDate *birthday;
@end
@implementation Person
// 嘗試將 name 屬性設置為 nil 將會拋出異常
+ (NSArray *)requiredProperties {
return @[@"name"];
}
@end
2) 主鍵
聲明主鍵允許對象的查詢和更新更加高效, 一旦添加梯皿，無法更改
@interface Person : RLMObject
@property NSInteger id;
@property NSString *name;
@end
@implementation Person
+ (NSString *)primaryKey {
return @"id";
}
@end
3) 索引屬性
索引會稍微減慢寫入速度仇箱，但是使用比較運算符進行查詢的速度將會更快（它同樣會造成 Realm 文件體積的增大，因為需要存儲索引东羹。）當您需要為某些特定情況優(yōu)化讀取性能的時候剂桥，那么最好添加索引。
@interface Book : RLMObject
@property float price;
@property NSString *title;
@end
@implementation Book
+ (NSArray *)indexedProperties {
return @[@"title"];
}
@end
4) 被忽略屬性
@interface Person : RLMObject
@property NSInteger tmpID;
@property (readonly) NSString *name; // 只讀屬性會被自動忽略
@property NSString *firstName;
@property NSString *lastName;
@end
@implementation Person
// 被忽略屬性的行為與正常屬性完全相同, 這些屬性仍能夠使用 KVO 進行觀察
+ (NSArray *)ignoredProperties {
return @[@"tmpID"];
}
- (NSString *)name {
return [NSString stringWithFormat:@"%@ %@", self.firstName, self.lastName];
}
@end
5) 默認屬性值
@interface Book : RLMObject
@property float price;
@property NSString *title;
@end
@implementation Book
+ (NSDictionary *)defaultPropertyValues {
return @{@"price" : @0, @"title": @""};
}
@end
注意
最近項目中使用到Realm數(shù)據(jù)庫属提，在無數(shù)次Crash中有以下總結：
1. 不要直接跨線程
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
RLMRealm *realm = [RLMRealm defaultRealm];
NSString *messageId1 = @"messageId";
RLMessage *message = [RLMessage objectInRealm:realm forPrimaryKey:messageId1];
dispatch_async(dispatch_get_main_queue(), ^{
// Will Crash
NSString *messageId2 = message.messageId;
});
});
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
RLMRealm *realm1 = [RLMRealm defaultRealm];
NSString *messageId1 = @"messageId";
RLMessage *message1 = [RLMessage objectInRealm:realm forPrimaryKey:messageId1];
dispatch_async(dispatch_get_main_queue(), ^{
// no crash
RLMRealm *realm2 = [RLMRealm defaultRealm];
RLMessage *message2 = [RLMessage objectInRealm:realm2 forPrimaryKey:messageId1];
});
});
構造一個 RLMThreadSafeReference, 傳遞給目標線程或者隊列, RLMThreadSafeReference 對象最多只能夠解析一次权逗。如果 RLMThreadSafeReference 解析失敗的話，將會導致 Realm 的原始版本被鎖死冤议，直到引用被釋放為止斟薇。因此，RLMThreadSafeReference 的生命周期應該很短
Person *person = [Person new];
person.name = @"Jane";
[realm transactionWithBlock:^{
[realm addObject:person];
}];
RLMThreadSafeReference *personRef = [RLMThreadSafeReference
referenceWithThreadConfined:person];
dispatch_async(queue, ^{
@autoreleasepool {
RLMRealm *realm = [RLMRealm realmWithConfiguration:realm.configuration
error:nil];
Person *person = [realm resolveThreadSafeReference:personRef];
if (!person) {
return; // person 被刪除
}
[realm transactionWithBlock:^{
person.name = @"Jane Doe";
}];
}
});
2. 不要任性的deleteAllObjects
如果數(shù)據(jù)庫正在讀寫操作恕酸，deleteAllObjects會Crash, 解決方案參照上面的"3. 刪除 Realm"
