資料持久化是每個 iOS 開發者繞不開的基本功。從最簡單的 plist 寫檔,到需要 ORM 的 Core Data,蘋果其實給了五套工具,各有適用場景。本文把它們的原理、適用範圍和實作要點一次講透。
每個 App 都被關在自己的沙盒目錄裡,彼此無法互相訪問。模擬器上的沙盒根路徑大致長這樣(apple 為用戶名,6.0 為模擬器版本):
/Users/apple/Library/Application Support/iPhone Simulator/6.0/Applications
或者:
/Users/用戶名/資源庫/Application Support/iPhone Simulator/6.1/Applications
默認情況下模擬器目錄是隱藏的,想看到它,在 Mac 終端執行:
顯示隱藏檔案:defaults write com.apple.finder AppleShowAllFiles YES
隱藏隱藏檔案:defaults write com.apple.finder AppleShowAllFiles NO
沙盒根路徑:
NSString *home = NSHomeDirectory();
Documents 有兩種取法。硬拼接字串雖然直觀,但新系統一旦改目錄名就會翻車:
NSString *home = NSHomeDirectory(); NSString *documents = [home stringByAppendingPathComponent:@"Documents"]; // 不建議采用,因為新版本的操作系統可能會修改目錄名
更推薦的是讓系統告訴你:
// NSUserDomainMask 代表從用戶文件夾下找 // YES 代表展開路徑中的波浪字符“~” NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, NO); // 在iOS中,只有一個目錄跟傳入的參數匹配,所以這個集合裡面只有一個元素 NSString *documents = [array objectAtIndex:0];
tmp 目錄:
NSString *tmp= NSTemporaryDirectory();
Caches 的取法與 Documents 同理,拼接 "Catches" 或把 NSSearchPathForDirectoriesInDomains 的第一個參數換成 NSCachesDirectory 即可。Preference 目錄則不建議直接碰路徑,交給 NSUserDefaults 處理。
本質上就是一個 XML 檔案,副檔名為 plist。只要物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 這幾類,就能用 writeToFile:atomically: 直接落地。
寫入一个字典:
// 將數據封裝成字典 NSMutableDictionary *dict = [NSMutableDictionary dictionary]; [dict setObject:@"15013141314" forKey:@"phone"]; [dict setObject:@"27" forKey:@"age"]; // 將字典持久化到Documents/stu.plist文件中 [dict writeToFile:path atomically:YES];
讀回來更簡單:
// 讀取Documents/stu.plist的內容,實例化NSDictionary NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path]; NSLog(@"phone:%@", [dict objectForKey:@"phone"]); NSLog(@"age:%@", [dict objectForKey:@"age"]);
記住用戶名、字級大小、是否自動登入這類輕量配置,用 NSUserDefaults 最合適,它是系統提供的標準方案。
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; [defaults setObject:@"Cat" forKey:@"username"]; [defaults setFloat:14.0f forKey:@"text_size"]; [defaults setBool:YES forKey:@"auto_login"];
取值時用對應的型別方法:
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; NSString *username = [defaults stringForKey:@"username"]; float textSize = [defaults floatForKey:@"text_size"]; BOOL autoLogin = [defaults boolForKey:@"auto_login"];
一個容易踩的坑:UserDefaults 並非即時寫入磁碟,而是依時間戳週期性把快取刷到本地。所以 setObject 之後 App 若立刻被終止,資料可能還沒落盤。關鍵節點建議手動強制寫入:
[defaults synchornize];
系統自帶型別可以直接歸檔,自訂物件則必須遵守 NSCoding 協議。協議只有兩個方法:
encodeObject:forKey:。decodeObject:forKey: 把資料還原成屬性。歸檔一個陣列:
NSString *path = [NSString stringWithFormat:@"Documents/array.archive"]; NSArray *array = [NSArray arrayWithObjects:@"a",@"b",nil]; [NSKeyedArchiver archiveRootObject:array toFile:path];
還原:
NSArray *array = [NSKeyedUnarchiver unarchiveObjectWithFile:path];
自訂 Person 的宣告:
@interface Person : NSObject <NSCoding> @property(nonatomic,copy) NSString *name; @property(nonatomic,assign) int age; @property(nonatomic,assign) float height;@end
實作:
@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; } // 歸檔(編碼) Person *person = [[Person alloc] init]; person.name = @"JN"; person.age = 22; person.height = 1.63f; [NSKeyedArchiver archiveRootObject:person toFile:path]; // 恢復(解碼) Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path]; @end
繼承場景下的兩條鐵律:父類若也遵守了 NSCoding,別忘了在 encodeWithCoder: 裡補上 [super encodeWithCode:encode];,在 initWithCoder: 裡補上 self = [super initWithCoder:decoder];,否則繼承來的屬性會靜默丟失。
archiveRootObject:toFile: 一次只能處理一個根物件。若想把多個物件打包進同一檔案,就得借 NSMutableData 當緩衝區。
歸檔:
// 新建一塊可變數據區 NSMutableData *data = [NSMutableData data]; // 將數據區連接到一個NSKeyedArchiver對象 NSKeyedArchiver *archiver = [[[NSKeyedArchiver alloc] initForWritingWithMutableData:data] autorelease]; // 開始存檔對象,存檔的數據都會存儲到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];
順帶一提,歸檔還能實現深拷貝——先編碼成 NSData,再解碼出新物件,地址自然不同:
// 臨時存儲person1的數據 NSData *data = [NSKeyedArchiver archivedDataWithRootObject:person1]; // 解析data,生成一個新的Person對象 Student *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data]; // 分別打印內存地址 NSLog(@"person1:%@", person1); // person1:0x8d3ed10> NSLog(@"person2:%@", person2); // person2:0x8d3e2f0>
開源嵌入式關聯式資料庫,可移植性強、記憶體開銷小。它有個特別之處:無型別,也就是說同一欄位可以塞任何型別的資料。常用型別只有四種:text、integer、real、blob。
使用前記得加入 libsqlite3.dylib 並引入 #import <sqlite3.h>。
SQL 語句不區分大小寫,但每條必須以分號結尾。select、insert、update、delete、from、create、where、order by、group by 等都是關鍵字,表名與欄位名不可使用關鍵字。語句大致分三類:DDL(create/drop)、DML(insert/update/delete)、DQL(select)。
建表與刪表:
create table if not exists t_student (id integer, name text, age inetger, score real) ;
drop table if exists t_student;
插入(字串務必用單引號包起來):
insert into t_student (name, age) values ('JN', 22) ;
更新——注意這條會把整張表的 name 全部改掉:
pupdate t_student set name = 'jack', age = 20 ;
刪除同理,不加條件就是清空全表:
delete from t_student;
實戰中幾乎總要帶條件:
// 將t_student表中年齡大於10 並且 姓名不等於jack的記錄,年齡都改為 5 update t_student set age = 5 where age > 10 and name != ‘jack' ; // 刪除t_student表中年齡小於等於10 或者 年齡大於30的記錄 delete from t_student where age <= 10 or age > 30 ;
查詢:
select * from t_student where age > 10 ; // 條件查詢條件語句:
主鍵與外鍵:主鍵(Primary Key)唯一標識一行記錄,相當於身份證,可以是單欄位也可以是多欄位組合;外鍵則用來建立表與表之間的關聯,典型形式是一張表的某欄位引用另一張表的主鍵。
打開資料庫:
// path為:~/Documents/person.db sqlite3 *db;int result = sqlite3_open([path UTF8String], &db);
幾個要點:路徑必須是 C 字串而非 NSString;檔案不存在時會自動新建;result 等於 SQLITE_OK 代表成功;用完記得 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 幾乎能跑任何語句,但不適合查詢,因為它不回傳資料。它也很常用來控事務:begain transaction 開啟、rollback 回滾、commit 提交。
常用 API 一覽:
1.打開數據庫 int sqlite3_open( const char *filename, // 數據庫的文件路徑 sqlite3 **ppDb // 數據庫實例 ); 2.執行任何SQL語句 int sqlite3_exec( sqlite3*, // 一個打開的數據庫實例 const char *sql, // 需要執行的SQL語句 int (*callback)(void*,int,char**,char**), // SQL語句執行完畢後的回調 void *, // 回調函數的第1個參數 char **errmsg // 錯誤信息 ); 3.檢查SQL語句的合法性(查詢前的准備) int sqlite3_prepare_v2( sqlite3 *db, // 數據庫實例 const char *zSql, // 需要檢查的SQL語句 int nByte, // SQL語句的最大字節長度 sqlite3_stmt **ppStmt, // sqlite3_stmt實例,用來獲得數據庫數據 const char **pzTail ); 4.查詢一行數據 int sqlite3_step( sqlite3_stmt*); // 如果查詢到一行數據,就會返回SQLITE_ROW 5.利用stmt獲得某一字段的值(字段的下標從0開始) double sqlite3_column_double(sqlite3_stmt*, int iCol); // 浮點數據 int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型數據 sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 長整型數據 const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // 二進制文本數據 const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol); // 字符串數據
Core Data 提供物件—關聯映射(ORM)能力:OC 物件自動轉成資料存進 SQLite 檔,讀出來時再還原成物件,全程不用寫一行 SQL。使用前提是加入 CoreData.framework 並引入 <CoreData/CoreData.h>。需要映射的物件稱為實體(entity),由模型檔描述。
取出的物件預設是 NSManagedObject,操作風格類似 NSDictionary:setValue:forkey: 存、valueForKey: 取。
四個核心角色分工明確:NSManagedObjectContext 負責 CRUD 與資料庫互動;NSPersistentStoreCoordinator 掛載持久化存儲庫;NSManagedObjectModel 代表模型檔;NSEntityDescription 描述實體。
搭建上下文環境:
// 從應用程序包中加載模型文件 NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil]; // 傳入模型,初始化 NSPersistentStoreCoordinator NSPersistentStoreCoordinator *psc = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model]; // 構建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]; /*持久化存儲庫的類型:NSSQLiteStoreType SQLite數據庫 NSBinaryStoreType 二進制平面文件 NSInMemoryStoreType 內存庫,無法永久保存數據 雖然這3種類型的性能從速度上來說都差不多,但從數據模型中保留下來的信息卻不一樣 在幾乎所有的情景中,都應該采用默認設置,使用SQLite作為持久化存儲庫 */
新增資料,並建立實體之間的關聯:
// 傳入上下文,創建一個Person實體對象 NSManagedObject *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context]; // 設置簡單屬性 [person setValue:@"JN" forKey:@"name"]; [person setValue:[NSNumber numberWithInt:22] forKey:@"age"]; // 傳入上下文,創建一個Card實體對象 NSManagedObject *card = [NSEntityDescription insertNewObjectForEntityForName:@"Card" inManagedObjectContext:context]; [card setValue:@"447640819" forKey:@"no"]; // 設置Person和Card之間的關聯關系 [person setValue:card forKey:@"card"]; // 利用上下文對象,將數據同步到持久化存儲庫 NSError *error = nil;BOOL success = [context save:&error]; if (!success) { [NSException raise:@"訪問數據庫錯誤" format:@"%@", [error localizedDescription]]; } // 如果是想做更新操作:只要在更改了實體對象的屬性後調用[context save:&error],就能將更改的數據同步到數據庫
查詢則靠 NSFetchRequest 搭配排序與謂詞:
// 初始化一個查詢請求 NSFetchRequest *request = [[NSFetchRequest alloc] init]; // 設置要查詢的實體 NSEntityDescription *desc = [NSEntityDescription entityForName:@"Person" inManagedObjectContext:context]; // 設置排序(按照age降序) NSSortDescriptor *sort = [NSSortDescriptor sortDescriptorWithKey:@"age" ascending:NO]; request.sortDescriptors = [NSArray arrayWithObject:sort]; // 設置條件過濾(name like '%JN-1%') NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name like %@", @"*JN-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 的子類,此後程式碼會乾淨很多:
// 那麼生成一個Person實體對象就應該這樣寫 Person *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person" inManagedObjectContext:context]; person.name = @"JN";person.age = [NSNumber numberWithInt:24]; Card *card = [NSEntityDescription insertNewObjectForEntityForName:@”Card" inManagedObjectContext:context]; card.no = @”447640819"; person.card = card;
選型建議:輕量配置用 NSUserDefaults,小結構資料用 plist,自訂物件用 NSKeyedArchiver,需要複雜查詢與大量資料用 SQLite 或 Core Data。沒有最強的方案,只有最合適的場景。