
本文經授權轉載,作者:hosea_zhou(簡書)。數據的持久化存儲幾乎是每一款 App 都無法迴避的需求,本文系統梳理了 iOS 平台上常見的本地數據存取方式,從應用沙盒機制講起,一路涵蓋 plist、Preference、歸檔、SQLite3 到 Core Data,是一篇不可多得的完整參考。
每個 iOS 應用都擁有一個獨立的應用沙盒,它本質上是一個與其他文件系統隔離的目錄。應用只能在自己沙盒內讀寫,其他應用無法訪問。
以一個名為 Layer 的應用為例,其沙盒的文件系統目錄結構如下圖所示:

沙盒結構分析:
應用程序包(上圖中的 Layer):包含了所有的資源文件和可執行文件。
Documents:保存應用運行時生成、需要持久化的數據,iTunes 同步設備時會備份該目錄。例如游戲存檔。
tmp:保存臨時數據,用完即刪。應用未運行時系統也可能清理該目錄,iTunes 同步時不會備份。
Library/Caches:保存需要持久化但不需要備份的數據,一般用於存儲體積大、非重要的數據,iTunes 同步時不會備份。
Library/Preference:保存應用的所有偏好設置,iOS 的「設置」應用會在此查找應用的配置信息,iTunes 同步時會備份。
常見的沙盒目錄獲取方式:
沙盒根目錄:NSString *home = NSHomeDirectory();
Documents(兩種方式):
i)利用沙盒根目錄拼接 "Documents" 字符串:
NSString *home = NSHomeDirectory(); NSString *documents = [home stringByAppendingPathComponent:@"Documents"]; // 不建議采用,因為新版本的操作系統可能會修改目錄名
ii)利用 NSSearchPathForDirectoriesInDomains 函數:
// NSUserDomainMask 代表從用戶文件夾下找 // YES 代表展開路徑中的波浪字符"~" NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES); // 在iOS中,只有一個目錄跟傳入的參數匹配,所以這個集合裡面只有一個元素 NSString *documents = [array objectAtIndex:0];
tmp:NSString *tmp = NSTemporaryDirectory();
Library/Caches(跟 Documents 類似的兩種方法):i)拼接 "Caches" 字符串;ii)使用 NSSearchPathForDirectoriesInDomains 函數(將第二個參數改為 NSCachesDirectory 即可)。
Library/Preference:通過 NSUserDefaults 類存取該目錄下的設置信息。
屬性列表是一種 XML 格式的文件,擴展名為 plist。如果對象是 NSString、NSDictionary、NSArray、NSData、NSNumber 等類型,就可以使用 writeToFile:atomically: 方法直接將對象寫入屬性列表文件。
舉例:將一個 NSDictionary 對象歸檔到 plist 中:
// 將數據封裝成字典 NSMutableDictionary *dict = [NSMutableDictionary dictionary]; [dict setObject:@"母雞" forKey:@"name"]; [dict setObject:@"15013141314" forKey:@"phone"]; [dict setObject:@"27" forKey:@"age"]; // 將字典持久化到Documents/stu.plist文件中 [dict writeToFile:path atomically:YES];
成功寫入 Documents 目錄下:

用文本編輯器打開,文件內容為:

用 xcode 打開屬性文件:

讀取屬性列表,恢復 NSDictionary 對象:
// 讀取Documents/stu.plist的內容,實例化NSDictionary NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path]; NSLog(@"name:%@", [dict objectForKey:@"name"]); NSLog(@"phone:%@", [dict objectForKey:@"phone"]); NSLog(@"age:%@", [dict objectForKey:@"age"]);
輸出結果:

很多 iOS 應用都支持偏好設置,比如保存用戶名、密碼、字體大小等。iOS 提供了一套標準方案,每個應用都有一個 NSUserDefaults 實例,通過它來存取偏好設置。例如保存用戶名、字體大小、是否自動登錄:
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; [defaults setObject:@"itcast" forKey:@"username"]; [defaults setFloat:18.0f forKey:@"text_size"]; [defaults setBool:YES forKey:@"auto_login"];

如果對象是 NSString、NSDictionary、NSArray、NSData、NSNumber 等類型,可以直接用 NSKeyedArchiver 進行歸檔和恢復。並非所有對象都能這樣歸檔,只有遵守了 NSCoding 協議的對象才可以。
NSCoding 協議有兩個方法:
encodeWithCoder: 每次歸檔對象時調用,用於指定如何歸檔每個實例變量,可用 encodeObject:forKey: 歸檔。
initWithCoder: 每次從文件恢復(解碼)對象時調用,用於指定如何將文件數據解碼為實例變量,可用 decodeObject:forKey 解碼。
歸檔一個 NSArray 對象到 Documents/array.archive:
NSArray *array = [NSArray arrayWithObjects:@"a",@"b",nil]; [NSKeyedArchiver archiveRootObject:array toFile:path];
歸檔成功:

恢復(解碼)NSArray 對象:
NSArray *array = [NSKeyedUnarchiver unarchiveObjectWithFile:path];

歸檔 Person 對象:
Person.h
@interface Person : NSObject@property (nonatomic, copy) NSString *name; @property (nonatomic, assign) int age; @property (nonatomic, assign) float height; @end
Person.m
@implementation Person - (void)encodeWithCoder:(NSCoder *)encoder { [encoder encodeObject:self.name forKey:@"name"]; [encoder encodeInt:self.age forKey:@"age"]; [encoder encodeFloat:self.height forKey:@"height"]; } - (id)initWithCoder:(NSCoder *)decoder { self.name = [decoder decodeObjectForKey:@"name"]; self.age = [decoder decodeIntForKey:@"age"]; self.height = [decoder decodeFloatForKey:@"height"]; return self; } @end
歸檔(編碼):
Person *person = [[[Person alloc] init] autorelease]; person.name = @"hosea"; person.age = 22; person.height = 1.83f; [NSKeyedArchiver archiveRootObject:person toFile:path];
恢復(解碼):
Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path];
歸檔對象的注意事項:如果父類也遵守了 NSCoding 協議,應在 encodeWithCoder: 中加上 [super encodeWithCode:encode; 以確保繼承的實例變量也能被編碼;應在 initWithCoder: 中加上 self = [super initWithCoder:decoder]; 以確保繼承的實例變量也能被解碼。
歸檔 NSData:使用 archiveRootObject:toFile: 可以將單個對象直接寫入文件,若想將多個對象寫入同一文件,則需借助 NSData。NSData 可為數據提供臨時存儲空間,可用 [NSMutableData data] 創建可變數據空間。

NSData 歸檔兩個 Person 對象到同一文件:
歸檔(編碼):
// 新建一塊可變數據區 NSMutableData *data = [NSMutableData data]; // 將數據區連接到一個NSKeyedArchiver對象 NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data]; // 開始存檔對象,存檔的數據都會存儲到NSMutableData中 [archiver encodeObject:person1 forKey:@"person1"]; [archiver encodeObject:person2 forKey:@"person2"]; // 存檔完畢(一定要調用這個方法) [archiver finishEncoding]; // 將存檔的數據寫入文件 [data writeToFile:path atomically:YES];
恢復(解碼):
// 從文件中讀取數據 NSData *data = [NSData dataWithContentsOfFile:path]; // 根據數據,解析成一個NSKeyedUnarchiver對象 NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data]; Person *person1 = [unarchiver decodeObjectForKey:@"person1"]; Person *person2 = [unarchiver decodeObjectForKey:@"person2"]; // 恢復完畢 [unarchiver finishDecoding];
也可將多個對象放入數組中:對數組歸檔時,數組中每個對象會自動調用 encodeWithCoder: 歸檔;解檔時,每個對象會自動調用 initWithCoder: 解檔。
利用歸檔實現深復制:
// 臨時存儲person1的數據 NSData *data = [NSKeyedArchiver archivedDataWithRootObject:person1]; // 解析data,生成一個新的Person對象 Person *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data]; // 分別打印內存地址 NSLog(@"person1:0x%x", person1);// person1:0x7177a60 NSLog(@"person2:0x%x", person2);// person2:0x7177cf0

SQLite3 是一款開源的嵌入式關系型數據庫,可移植性好、易使用、內存開銷小。它是無類型的,意味著你可以保存任何類型的數據到任意表的任意字段中,例如 create table t_person(name, age); 是合法的。但為保證可讀性,建議加上字段類型:create table t_person(name text, age integer);。常用的 5 種數據類型為 text、integer、float、boolean、blob。
在 iOS 中使用 SQLite3,首先要添加庫文件 libsqlite3.dylib 並導入主頭文件:

創建或打開數據庫:
// path為:~/Documents/person.db sqlite3 *db; int result = sqlite3_open([path UTF8String], &db);
sqlite3_open() 會根據路徑打開數據庫,若不存在則創建。result 等於 SQLITE_OK 表示成功。數據庫路徑必須以 C 字符串傳入。關閉數據庫:sqlite3_close(db);
執行創表語句:
char *errorMsg; // 用來存儲錯誤信息 char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);"; int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg);
sqlite3_exec() 可執行任何 SQL 語句(創表、更新、插入、刪除等),但一般不建議用它執行查詢,因為它不會返回查詢數據。它還可用於事務操作:開啟事務 begin transaction;、回滾 rollback;、提交 commit;。
帶占位符插入數據:
char *sql = "insert into t_person(name, age) values(?, ?);"; sqlite3_stmt *stmt; if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) { sqlite3_bind_text(stmt, 1, "母雞", -1, NULL); sqlite3_bind_int(stmt, 2, 27); } if (sqlite3_step(stmt) != SQLITE_DONE) { NSLog(@"插入數據錯誤"); } sqlite3_finalize(stmt);
sqlite3_prepare_v2() 返回 SQLITE_OK 表示語句準備成功;sqlite3_bind_text() 等綁定函數的第 2 個參數是占位符位置(第一個為 1 而非 0),第 3 個是要綁定的值,第 4 個是數據長度(C 字符串可傳 -1),第 5 個是可選的內存清理回調;sqlite3_step() 返回 SQLITE_DONE 代表執行完畢;sqlite3_finalize() 銷毀 stmt 對象。
查詢數據:
char *sql = "select id,name,age from t_person;"; sqlite3_stmt *stmt; if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) { while (sqlite3_step(stmt) == SQLITE_ROW) { int _id = sqlite3_column_int(stmt, 0); char *_name = (char *)sqlite3_column_text(stmt, 1); NSString *name = [NSString stringWithUTF8String:_name]; int _age = sqlite3_column_int(stmt, 2); NSLog(@"id=%i, name=%@, age=%i", _id, name, _age); } } sqlite3_finalize(stmt);
sqlite3_step() 返回 SQLITE_ROW 代表遍歷到一條新記錄;sqlite3_column_*() 用於獲取每個字段的值,第二個參數是從 0 開始的字段索引。
Core Data 框架提供了對象-關系映射(ORM)功能,能將 OC 對象轉化為數據保存到 SQLite3 數據庫文件中,也能將數據庫中的數據還原成 OC 對象,全程無需編寫 SQL 語句。使用時需添加 CoreData.framework 並導入 CoreData/CoreData.h。

需要映射的對象稱為實體(entity),需用模型文件描述所有實體及屬性。以 Person 和 Card(身份證)兩個實體為例:

Person 中有 Card 屬性,Card 中有 Person 屬性,屬於一對一雙向關聯。
模型文件的創建與配置:

添加實體:

添加 Person 實體的基本屬性:

添加 Card 實體的基本屬性:

在 Person 中添加 card 屬性:

在 Card 中添加 person 屬性:

NSManagedObject:通過 Core Data 取出的對象默認都是 NSManagedObject,其工作模式類似 NSDictionary,通過鍵-值對存取實體屬性:setValue:forKey: 存儲,valueForKey: 獲取。

Core Data 主要對象:

搭建 Core Data 上下文環境——從應用程序包加載模型文件:
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];
傳入模型,初始化 NSPersistentStoreCoordinator:
NSPersistentStoreCoordinator *psc = [[[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model] autorelease];
構建 SQLite 文件路徑:
NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];
添加持久化存儲庫(使用 SQLite):
NSError *error = nil; NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:url options:nil error:&error]; if (store == nil) { // 直接拋異常 [NSException raise:@"添加數據庫錯誤" format:@"%@", [error localizedDescription]]; }
初始化上下文並設置 persistentStoreCoordinator:
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] init]; context.persistentStoreCoordinator = psc; // 用完之後,還是要[context release];
添加數據——創建 Person 實體並設置屬性:
NSManagedObject *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context]; [person setValue:@"hosea" forKey:@"name"]; [person setValue:[NSNumber numberWithInt:22] forKey:@"age"];
創建 Card 實體並設置關聯:
NSManagedObject *card = [NSEntityDescription insertNewObjectForEntityForName:@"Card" inManagedObjectContext:context]; [card setValue:@"4414241933432" forKey:@"no"]; [person setValue:card forKey:@"card"];
利用上下文將數據同步到持久化存儲庫:
NSError *error = nil; BOOL success = [context save:&error]; if (!success) { [NSException raise:@"訪問數據庫錯誤" format:@"%@", [error localizedDescription]]; } // 更新操作:更改實體屬性後調用[context save:&error]即可同步
查詢數據——初始化查詢請求並設置實體、排序與條件過濾:
NSFetchRequest *request = [[[NSFetchRequest alloc] init] autorelease]; NSEntityDescription *desc = [NSEntityDescription entityForName:@"Person" inManagedObjectContext:context]; NSSortDescriptor *sort = [NSSortDescriptor sortDescriptorWithKey:@"age" ascending:NO]; request.sortDescriptors = [NSArray arrayWithObject:sort]; NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name like %@", @"*hosea-1*"]; request.predicate = predicate;
執行請求並遍歷數據:
NSError *error = nil; NSArray *objs = [context executeFetchRequest:request error:&error]; if (error) { [NSException raise:@"查詢錯誤" format:@"%@", [error localizedDescription]]; } for (NSManagedObject *obj in objs) { NSLog(@"name=%@", [obj valueForKey:@"name"]); }
刪除數據:
[context deleteObject:managedObject]; NSError *error = nil; [context save:&error]; if (error) { [NSException raise:@"刪除錯誤" format:@"%@", [error localizedDescription]]; }
Core Data 的延遲加載:取出 Person 實體時不會立即查詢關聯的 Card,只有在真正需要用到 Card 時才會加載。
創建 NSManagedObject 的子類:默認取出的實體是 NSManagedObject 類型,若需在存取數據之外添加業務方法,則必須創建其子類。

選擇模型文件:

選擇需要創建子類的實體:


生成 Person 實體對象時即可直接點擊屬性:
Person *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context]; person.name = @"hosea"; person.age = [NSNumber numberWithInt:22]; Card *card = [NSEntityDescription insertNewObjectForEntityForName:@"Card" inManagedObjectContext:context]; card.no = @"4414245465656"; person.card = card;