iOS 常見的資料儲存方式
1、XML 屬性列表(plist)歸檔。
2、Preference(偏好設定)。
3、NSKeyedArchiver 歸檔。
4、SQLite3。
5、Core Data。
應用程式沙盒
每個 iOS App 都有自己的沙盒(一個檔案系統目錄),與其他檔案系統隔離。App 只能在自己的沙盒裡活動,其他 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
沙盒結構分析
Documents:儲存 App 執行期產生、需要持久的資料,iTunes 同步裝置時會備份此目錄。例如遊戲存檔。
temp:儲存執行期暫時需要的資料,用完即刪。App 未執行時系統也可能主動清理。iTunes 不會備份此目錄。
Library/Caches:儲存需要持久但不重要的資料,iTunes 不會備份。適合體積大、可重新產生的內容。
Library/Preference:儲存所有偏好設定,iOS 的「設定」App 會在此查找 App 的設定項目。iTunes 會備份此目錄。
取得沙盒路徑的常見寫法
沙盒根路徑:
NSString *home = NSHomeDirectory();
Documents(兩種方式):
利用根路徑拼接字串:
NSString *home = NSHomeDirectory(); NSString *documents = [home stringByAppendingPathComponent:@"Documents"]; // 不建議採用,因為新版本系統可能修改目錄名稱
利用 NSSearchPathForDirectoriesInDomains:
// NSUserDomainMask 代表從使用者資料夾下尋找 // YES 代表展開路徑中的波浪符號「~」 NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, NO); // iOS 中只有一個目錄符合條件,所以集合裡只有一個元素 NSString *documents = [array objectAtIndex:0];
tmp:
NSString *tmp = NSTemporaryDirectory();
Library/Caches:寫法與 Documents 類似,用拼接字串或把 NSSearchPathForDirectoriesInDomains 的第一個參數改為 NSCachesDirectory。
Library/Preference:透過 NSUserDefaults 存取。
屬性列表是一種 XML 格式的檔案,副檔名為 plist。如果物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 等型別,就能直接用 writeToFile:atomically: 寫入。
歸檔 NSDictionary:
// 封裝成字典 NSMutableDictionary *dict = [NSMutableDictionary dictionary]; [dict setObject:@"15013141314" forKey:@"phone"]; [dict setObject:@"27" forKey:@"age"]; // 寫入 Documents/stu.plist [dict writeToFile:path atomically:YES];
讀回 NSDictionary:
NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path]; NSLog(@"phone:%@", [dict objectForKey:@"phone"]); NSLog(@"age:%@", [dict objectForKey:@"age"]);
很多 App 都支援偏好設定,例如記住使用者名稱、密碼、是否自動登入。iOS 提供了一套標準方案,每個 App 都有一個 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"];
注意:NSUserDefaults 寫入時不是立刻落盤,而是依時間戳週期性地把快取內容寫入。所以呼叫 set 之後若 App 立刻結束,資料可能還沒寫入。需要確保立即寫入時,呼叫 synchronize:
[defaults synchronize];
只有遵守了 NSCoding 協定的物件才能用這種方式歸檔。協定有兩個方法:
encodeWithCoder: 每次歸檔時呼叫,在裡面指定每個實例變數如何編碼,通常用 encodeObject:forKey:。
initWithCoder: 每次還原時呼叫,通常用 decodeObjectForKey: 解碼。
歸檔 NSArray:
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 物件,Person.h:
@interface Person : NSObject <NSCoding> @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;
}
// 歸檔(編碼)
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 encodeWithCoder:encoder];,並在 initWithCoder: 中加上 self = [super initWithCoder:decoder];,否則繼承而來的實例變數不會被編碼與還原。
archiveRootObject:toFile: 一次只能寫入一個物件。若要把多個物件寫進同一個檔案,就得用 NSData 作為暫存空間。
歸檔:
// 建立可變資料區 NSMutableData *data = [NSMutableData data]; // 讓資料區接到 NSKeyedArchiver NSKeyedArchiver *archiver = [[[NSKeyedArchiver alloc] initForWritingWithMutableData:data] autorelease]; [archiver encodeObject:person1 forKey:@"person1"]; [archiver encodeObject:person2 forKey:@"person2"]; // 一定要呼叫,否則資料不完整 [archiver finishEncoding]; // 寫入檔案 [data writeToFile:path atomically:YES];
還原:
NSData *data = [NSData dataWithContentsOfFile:path]; NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data]; Person *person1 = [unarchiver decodeObjectForKey:@"person1"]; Person *person2 = [unarchiver decodeObjectForKey:@"person2"]; [unarchiver finishDecoding];
順帶一提,這個技巧也很常用來做深拷貝:
// 先把 person1 編碼成資料 NSData *data = [NSKeyedArchiver archivedDataWithRootObject:person1]; // 再由資料還原成新物件 Student *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data]; NSLog(@"person1:%@", person1); // person1:0x8d3ed10> NSLog(@"person2:%@", person2); // person2:0x8d3e2f0>
兩者的記憶體位址不同,代表是兩個獨立物件。
1、SQLite3 是開源的嵌入式關聯式資料庫,可攜性佳、易使用、記憶體開銷小。
2、它是無型別的,代表你可以把任何型別的資料存進任意表格的任意欄位。
3、常用四種資料型別:text(文字)、integer(整數)、real(浮點數)、blob(二進位資料)。
在 iOS 中使用,要先加入 libsqlite3.dylib 並引入 #import <sqlite3.h>。
SQL 語法特點:不區分大小寫;每條語句必須以分號結尾。
常用關鍵字:select、insert、update、delete、from、create、where、desc、order、by、group、table、alter、view、index 等。資料表與欄位不可使用關鍵字命名。
語句分類:DDL(create、drop 等定義操作)、DML(insert、update、delete 等資料操作)、DQL(select 等查詢操作,其中 where、order by、group by、having 最常用)。
建表:
create table if not exists t_student (id integer, name text, age integer, score real);
刪表:
drop table if exists t_student;
插入:
insert into t_student (name, age) values ('JN', 22);
注意:字串內容要用單引號括住。
更新:
update t_student set name = 'jack', age = 20;
注意:這樣會把整張表的所有記錄都改掉。
刪除:
delete from t_student;
同樣會刪掉全部記錄。若只想動到特定資料,必須加上條件:
// 年齡大於 10 且姓名不為 jack 的,年齡改為 5 update t_student set age = 5 where age > 10 and name != 'jack'; // 刪除年齡小於等於 10 或大於 30 的記錄 delete from t_student where age <= 10 or age > 30;
查詢:
select * from t_student where age > 10;
主鍵約束:每張表都應有一個主鍵,用來唯一標識記錄,相當於身份證。主鍵可以是單一或多個欄位。
外鍵約束:用來建立表與表之間的關聯,通常是某張表的某個欄位參照另一張表的主鍵。
開啟與關閉資料庫
// path 為 ~/Documents/person.db sqlite3 *db; int result = sqlite3_open([path UTF8String], &db);
說明:sqlite3_open() 會依路徑開啟資料庫,若不存在則新建。result 等於 SQLITE_OK 代表成功。sqlite *db 是開啟後的實例。路徑必須以 C 字串傳入,而非 NSString。
關閉: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。
SQLite 常用函式
// 1. 開啟資料庫 int sqlite3_open( const char *filename, // 資料庫檔案路徑 sqlite3 **ppDb // 資料庫實例 ); // 2. 執行任何 SQL 語句 int sqlite3_exec( sqlite3*, // 已開啟的實例 const char *sql, // 要執行的語句 int (*callback)(void*, int, char**, char**), // 執行完畢的回呼 void *, // 回呼的第一個參數 char **errmsg // 錯誤訊息 ); // 3. 檢查 SQL 語句合法性(查詢前的準備) int sqlite3_prepare_v2( sqlite3 *db, // 資料庫實例 const char *zSql, // 要檢查的語句 int nByte, // 語句最大位元組長度 sqlite3_stmt **ppStmt, // 用來取得資料的 statement const char **pzTail ); // 4. 逐列取值,查到一筆回傳 SQLITE_ROW int sqlite3_step(sqlite3_stmt*); // 5. 依欄位索引取值(索引從 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); // 字串
實務上要提醒的是,字串若直接拼接進 SQL 語句會有 SQL Injection 風險,正確做法是使用 sqlite3_prepare_v2 搭配 sqlite3_bind_text 綁定參數。
Core Data 框架提供物件-關聯對應(ORM)功能:能把 Objective-C 物件轉成資料存進 SQLite 檔案,也能把資料還原成物件,整個過程不需要撰寫任何 SQL 語句。
使用方式是加入 CoreData.framework 並引入 <CoreData/CoreData.h>。
模型檔:需要對應的物件稱為「實體(entity)」,並以 Core Data 的模型檔描述所有實體與其屬性。
NSManagedObject
從資料庫取出的物件預設都是 NSManagedObject。它的操作方式類似 NSDictionary,以鍵值對存取實體屬性:setValue:forKey: 寫入、valueForKey: 讀取。
四大核心物件
NSManagedObjectContext:負責資料與資料庫之間的互動(CRUD)。
NSPersistentStoreCoordinator:加入持久化儲存庫,例如 SQLite。
NSManagedObjectModel:代表模型檔。
NSEntityDescription:描述實體。
建立上下文環境
// 從 App 套件載入模型檔
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];
// 以模型初始化 coordinator
NSPersistentStoreCoordinator *psc = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];
// 建立 SQLite 檔案路徑
NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];
// 加入持久化儲存庫
NSError *error = nil;
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:url options:nil error:&error];
if (store == nil) {
[NSException raise:@"加入資料庫失敗" format:@"%@", [error localizedDescription]];
}
// 初始化 context 並設定 coordinator
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] init];
context.persistentStoreCoordinator = psc;
// 用完記得 [context release];
/* 持久化儲存庫的類型:
NSSQLiteStoreType SQLite 資料庫
NSBinaryStoreType 二進位平面檔
NSInMemoryStoreType 記憶體庫,無法永久保存
三者速度差異不大,但保留下來的資訊不同。
幾乎所有情境都應使用預設的 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 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];
// 指定要查詢的實體
NSEntityDescription *desc = [NSEntityDescription entityForName:@"Person" inManagedObjectContext:context];
request.entity = desc;
// 排序(依 age 遞減)
NSSortDescriptor *sort = [NSSortDescriptor sortDescriptorWithKey:@"age" ascending:NO];
request.sortDescriptors = [NSArray arrayWithObject:sort];
// 條件過濾
// 注意:這裡的 % 要用 * 代替
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 的延遲載入
Core Data 不會依關聯關係立刻抓取對應物件。例如取出 Person 時不會馬上去查 Card,直到你真的存取 Card,才會查詢資料庫並載入。這個特性在大資料量下能省下可觀的 I/O,但也意味著若在背景執行緒存取時處理不當,容易出現效能尖峰。
建立 NSManagedObject 的子類
預設取出的實體都是 NSManagedObject,只能靠鍵值對存取。若除了存取資料之外還需要加上業務方法,就必須建立子類。建立完成後,寫法會直觀許多:
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;資料量大、需要複雜查詢與關聯時用 SQLite3;若團隊希望以物件導向的方式操作、不想寫 SQL,就用 Core Data。
以上就是 iOS 常用資料儲存方式的完整整理,涵蓋 plist 歸檔、偏好設定、NSKeyedArchiver、SQLite3 與 Core Data,並附上實作範例與注意事項,希望對大家學習 iOS 開發有所幫助。