Realm數(shù)據(jù)庫配置
不同的用戶, 使用不同的數(shù)據(jù)庫文件
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
// 使用默認的目錄,但是使用用戶名來替換默認的文件名
config.fileURL = [[[config.fileURL URLByDeletingLastPathComponent]URLByAppendingPathComponent:@"userName"]URLByAppendingPathExtension:@"realm"];
[RLMRealmConfiguration setDefaultConfiguration:config];
只讀方式打開數(shù)據(jù)庫
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
config.fileURL = [[NSBundle mainBundle] URLForResource:@"MyBundledData" withExtension:@"realm"];
// 以只讀模式打開文件棒厘,因為應用數(shù)據(jù)包并不可寫
config.readOnly = YES;
RLMRealm *realm = [RLMRealm realmWithConfiguration:config error:nil];
// 從打包的 Realm 數(shù)據(jù)庫中讀取某些數(shù)據(jù)
RLMResults<Dog *> *dogs = [Dog objectsInRealm:realm where:@"age > 5"];
數(shù)據(jù)庫文件刪除
需要刪除數(shù)據(jù)庫文件以及輔助文件
NSFileManager *manager = [NSFileManager defaultManager];
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
NSArray<NSURL *> *realmFileURLs = @[
config.fileURL,
[config.fileURL URLByAppendingPathExtension:@"lock"],
[config.fileURL URLByAppendingPathExtension:@"log_a"],
[config.fileURL URLByAppendingPathExtension:@"log_b"],
[config.fileURL URLByAppendingPathExtension:@"note"]
];
for (NSURL *URL in realmFileURLs) {
NSError *error = nil;
[manager removeItemAtURL:URL error:&error];
if (error) {
// 處理錯誤
}
}
數(shù)據(jù)庫遷移
數(shù)據(jù)結構遷移
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
// 設置新的架構版本奢人。這個版本號必須高于之前所用的版本號(如果您之前從未設置過架構版本淆院,那么這個版本號設置為 0)
config.schemaVersion = 1;
// 設置閉包,這個閉包將會在打開低于上面所設置版本號的 Realm 數(shù)據(jù)庫的時候被自動調(diào)用
config.migrationBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
// 目前我們還未進行數(shù)據(jù)遷移支救,因此 oldSchemaVersion == 0
if (oldSchemaVersion < 1) {
// 什么都不要做拷淘!Realm 會自行檢測新增和需要移除的屬性,然后自動更新硬盤上的數(shù)據(jù)庫架構
}
}
// 告訴 Realm 為默認的 Realm 數(shù)據(jù)庫使用這個新的配置對象
[RLMRealmConfiguration setDefaultConfiguration:config];
// 現(xiàn)在我們已經(jīng)告訴了 Realm 如何處理架構的變化启涯,打開文件之后將會自動執(zhí)行遷移
[RLMRealm defaultRealm];
數(shù)據(jù)遷移
// enumerateObjects:block: 方法遍歷了存儲在 Realm 文件中的每一個“Person”對象
[migration enumerateObjects:Person.className block:^(RLMObject *oldObject, RLMObject *newObject) {
// 將名字進行合并,存放在 fullName 域中 newObject[@"fullName"] = [NSString stringWithFormat:@"%@ %@",oldObject[@"firstName"],oldObject[@"lastName"]];
}];
屬性重命名
[migration renamePropertyForClass:Person.className oldName:@"yearsSinceBirth" newName:@"age"];
多版本增量式遷移
遷移核心代碼
// enumerateObjects:block: 遍歷了存儲在 Realm 文件中的每一個“Person”對象
[migration enumerateObjects:Person.className block:^(RLMObject *oldObject, RLMObject *newObject) {
// 只有當 Realm 數(shù)據(jù)庫的架構版本為 0 的時候,才添加 “fullName” 屬性
if (oldSchemaVersion < 1) {
newObject[@"fullName"] = [NSString stringWithFormat:@"%@ %@", oldObject[@"firstName"],oldObject[@"lastName"]];
}
// 只有當 Realm 數(shù)據(jù)庫的架構版本為 0 或者 1 的時候补君,才添加“email”屬性
if (oldSchemaVersion < 2) {
newObject[@"email"] = @"";
}
}];