
作者:@翁呀偉呀 授權本站轉載
概論
所謂持久化,就是把數據保存到硬盤中,使得應用程序或機器重啟後仍能訪問之前保存的數據。在 iOS 開發中,數據持久化的方案有很多,接下來我將嘗試介紹 5 種:
plist 文件(屬性列表)
preference(偏好設置)
NSKeyedArchiver(歸檔)
SQLite 3
CoreData
沙盒
在介紹各種存儲方法之前,有必要先說說沙盒機制。iOS 程序默認情況下只能訪問自己程序所屬的目錄,這個目錄被稱為「沙盒」。
1. 結構
既然沙盒就是一個文件夾,那就看看裡面有什麼。沙盒的目錄結構如下:
"應用程序包"
Documents
Library
Caches
Preferences
tmp2. 目錄特性
沙盒裡雖然有這麼多文件夾,但它們並不完全相同,各有特性。所以在選擇存放目錄時,一定要認真挑選合適的那個。
「應用程序包」:存放應用程序的源文件,包括資源文件和可執行文件。
NSString *path = [[NSBundle mainBundle] bundlePath];
NSLog(@"%@", path);Documents:最常用的目錄,iTunes 同步該應用時會同步此文件夾的內容,適合存儲重要數據。
NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
NSLog(@"%@", path);Library/Caches:iTunes 不會同步此文件夾,適合存儲體積大、不需要備份的非重要數據。
NSString *path = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject;
NSLog(@"%@", path);Library/Preferences:iTunes 同步該應用時會同步此文件夾的內容,通常用來保存應用的設置信息。
tmp:iTunes 不會同步此文件夾,系統可能在應用沒運行時就刪除該目錄下的文件,因此適合保存一些用完即刪的臨時文件。
NSString *path = NSTemporaryDirectory();
NSLog(@"%@", path);plist 文件
plist 文件是把某些特定的類,透過 XML 文件的方式保存在目錄中。可以被序列化的類型只有以下幾種:
NSArray; NSMutableArray; NSDictionary; NSMutableDictionary; NSData; NSMutableData; NSString; NSMutableString; NSNumber; NSDate;
1. 獲得文件路徑
NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
NSString *fileName = [path stringByAppendingPathComponent:@"123.plist"];2. 存儲
NSArray *array = @[@"123", @"456", @"789"]; [array writeToFile:fileName atomically:YES];
3. 讀取
NSArray *result = [NSArray arrayWithContentsOfFile:fileName]; NSLog(@"%@", result);
4. 注意
只有以上列出的類型才能用 plist 文件存儲。
存儲時使用 writeToFile: atomically: 方法,其中 atomically 表示是否先寫入一個輔助文件,再把它拷貝到目標文件地址——這是更安全的寫入方式,一般都寫 YES。
讀取時使用 arrayWithContentsOfFile: 方法。
Preference
1. 使用方法
//1.獲得 NSUserDefaults 文件 NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults]; //2.向文件中寫入內容 [userDefaults setObject:@"AAA" forKey:@"a"]; [userDefaults setBool:YES forKey:@"sex"]; [userDefaults setInteger:21 forKey:@"age"]; //2.1 立即同步 [userDefaults synchronize]; //3.讀取文件 NSString *name = [userDefaults objectForKey:@"a"]; BOOL sex = [userDefaults boolForKey:@"sex"]; NSInteger age = [userDefaults integerForKey:@"age"]; NSLog(@"%@, %d, %ld", name, sex, age);
2. 注意
偏好設置專門用來保存應用程序的配置信息,一般不要在裡面保存其他數據。
若沒調用 synchronize 方法,系統會根據 I/O 情況不定時地保存到文件;因此需要立即寫入時,必須調用 synchronize。
偏好設置會把所有數據保存到同一個文件中,即 preference 目錄下以此應用包名命名的 plist 文件。
NSKeyedArchiver
歸檔在 iOS 中是另一種形式的序列化,只要遵循了 NSCoding 協議的對象,都能透過它實現序列化。由於絕大多數支援存儲數據的 Foundation 和 Cocoa Touch 類都遵循了 NSCoding 協議,因此對大多數類來說,歸檔相對容易實現。
1. 遵循 NSCoding 協議
NSCoding 協議聲明了兩個必須實現的方法:一個說明如何把對象編碼到歸檔中,另一個說明如何解檔以獲得新對象。
遵循協議並設置屬性
//1.遵循 NSCoding 協議
@interface Person : NSObject
//2.設置屬性
@property (strong, nonatomic) UIImage *avatar;
@property (copy, nonatomic) NSString *name;
@property (assign, nonatomic) NSInteger age;
@end實現協議方法
//解檔
- (id)initWithCoder:(NSCoder *)aDecoder {
if ([super init]) {
self.avatar = [aDecoder decodeObjectForKey:@"avatar"];
self.name = [aDecoder decodeObjectForKey:@"name"];
self.age = [aDecoder decodeIntegerForKey:@"age"];
}
return self;
}
//歸檔
- (void)encodeWithCoder:(NSCoder *)aCoder {
[aCoder encodeObject:self.avatar forKey:@"avatar"];
[aCoder encodeObject:self.name forKey:@"name"];
[aCoder encodeInteger:self.age forKey:@"age"];
}特別注意
如果需要歸檔的類是某個自定義類的子類,就需要在歸檔和解檔前先調用父類的歸檔、解檔方法,即 [super encodeWithCoder:aCoder] 與 [super initWithCoder:aDecoder]。
2. 使用
需要把對象歸檔時,調用 NSKeyedArchiver 的工廠方法 archiveRootObject: toFile:。
NSString *file = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"person.data"];
Person *person = [[Person alloc] init];
person.avatar = self.avatarView.image;
person.name = self.nameField.text;
person.age = [self.ageField.text integerValue];
[NSKeyedArchiver archiveRootObject:person toFile:file];需要從文件中解檔對象時,調用 NSKeyedUnarchiver 的工廠方法 unarchiveObjectWithFile: 即可。
NSString *file = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"person.data"];
Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:file];
if (person) {
self.avatarView.image = person.avatar;
self.nameField.text = person.name;
self.ageField.text = [NSString stringWithFormat:@"%ld", person.age];
}3. 注意:
必須遵循並實現 NSCoding 協議。
保存文件的擴展名可任意指定。
繼承時必須先調用父類的歸檔、解檔方法。
SQLite3
之前的所有存儲方法都是「覆蓋存儲」——想增加一條數據,就得把整個文件讀出來,修改後再把全部內容覆蓋寫入,因此它們都不適合存儲大量內容。
1. 字段類型
表面上 SQLite 把數據分為以下幾種類型:
integer:整數
real:實數(浮點數)
text:文本字符串
blob:二進制數據,比如文件、圖片之類
實際上 SQLite 是無類型的,即不管創表時指定的字段類型是什麼,存儲時依然可以存任意類型的數據,甚至創表時也可以不指定字段類型。SQLite 之所以保留類型,是為了良好的編程規範和方便開發人員交流,所以平時最好設置正確的字段類型!主鍵必須設置成 integer。
2. 准備工作
准備工作就是導入依賴庫。要在 iOS 中使用 SQLite3,需添加庫文件 libsqlite3.dylib 並導入主頭文件。這是一個 C 語言庫,所以直接使用 SQLite3 還是比較麻煩的。
3. 使用
創建數據庫並打開
操作數據庫前必須先指定數據庫文件和要操作的表,所以使用 SQLite3 首先要打開數據庫文件,然後指定或創建一張表。
/**
* 打開數據庫並創建一個表
*/
- (void)openDatabase {
//1.設置文件名
NSString *filename = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"person.db"];
//2.打開數據庫文件,如果沒有會自動創建一個文件
NSInteger result = sqlite3_open(filename.UTF8String, _sqlite3);
if (result == SQLITE_OK) {
NSLog(@"打開數據庫成功!");
//3.創建一個數據庫表
char *errmsg = NULL;
sqlite3_exec(_sqlite3, "CREATE TABLE IF NOT EXISTS t_person(id integer primary key autoincrement, name text, age integer)", NULL, NULL, &errmsg);
if (errmsg) {
NSLog(@"錯誤:%s", errmsg);
} else {
NSLog(@"創表成功!");
}
} else {
NSLog(@"打開數據庫失敗!");
}
}執行指令
用 sqlite3_exec() 方法可以執行任何 SQL 語句,比如創表、更新、插入和刪除。但一般不用它執行查詢語句,因為它不會返回查詢到的數據。
/**
* 往表中插入 1000 條數據
*/
- (void)insertData {
NSString *nameStr;
NSInteger age;
for (NSInteger i = 0; i < 1000; i++) {
nameStr = [NSString stringWithFormat:@"Bourne-%d", arc4random_uniform(10000)];
age = arc4random_uniform(80) + 20;
NSString *sql = [NSString stringWithFormat:@"INSERT INTO t_person (name, age) VALUES('%@', '%ld')", nameStr, age];
char *errmsg = NULL;
sqlite3_exec(_sqlite3, sql.UTF8String, NULL, NULL, &errmsg);
if (errmsg) {
NSLog(@"錯誤:%s", errmsg);
}
}
NSLog(@"插入完畢!");
}查詢指令
前面說過,一般不用 sqlite3_exec() 查詢數據。因為查詢需要獲得結果,所以相對麻煩,涉及以下幾個步驟:
sqlite3_prepare_v2():檢查 sql 的合法性。
sqlite3_step():逐行獲取查詢結果,不斷重複,直到最後一條記錄。
sqlite3_column_xxx():獲取對應類型的內容,iCol 對應 SQL 語句中字段的順序(從 0 開始),依實際查詢字段的屬性使用對應方法取值即可。
sqlite3_finalize():釋放 stmt。
/**
* 從表中讀取數據到數組中
*/
- (void)readData {
NSMutableArray *mArray = [NSMutableArray arrayWithCapacity:1000];
char *sql = "select name, age from t_person;";
sqlite3_stmt *stmt;
NSInteger result = sqlite3_prepare_v2(_sqlite3, sql, -1, &stmt, NULL);
if (result == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
char *name = (char *)sqlite3_column_text(stmt, 0);
NSInteger age = sqlite3_column_int(stmt, 1);
//創建對象
Person *person = [Person personWithName:[NSString stringWithUTF8String:name] Age:age];
[mArray addObject:person];
}
self.dataList = mArray;
}
sqlite3_finalize(stmt);
}4. 總結
總的來說,SQLite3 的使用還是比較麻煩的,因為都是些 C 語言函數,理解起來有些困難。不過在一般開發中,我們用的都是第三方開源庫 FMDB,它封裝了這些基本的 C 語言方法,讓使用更直觀、開發效率更高。
FMDB
1. 簡介
FMDB 是 iOS 平台的 SQLite 數據庫框架,以 OC 的方式封裝了 SQLite 的 C 語言 API。相比 cocoa 自帶的 C 語言框架,它有如下優點:
使用更面向對象,省去了大量麻煩、冗余的 C 語言代碼;
對比蘋果自帶的 Core Data 框架,更輕量級也更靈活;
提供了多線程安全的數據庫操作方法,有效防止數據混亂。
注:FMDB 的 gitHub 地址。
2. 核心類
FMDB 有三個主要類:
FMDatabase
一個 FMDatabase 對象代表一個單獨的 SQLite 數據庫,用來執行 SQL 語句。
FMResultSet
使用 FMDatabase 執行查詢後的結果集。
FMDatabaseQueue
用於在多線程中執行多個查詢或更新,它是線程安全的。
3. 打開數據庫
和 C 語言框架一樣,FMDB 透過指定 SQLite 數據庫文件路徑來創建 FMDatabase 對象,但更易理解、更易使用,使用前一樣需要導入 sqlite3.dylib。打開數據庫的方法如下:
NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"person.db"];
FMDatabase *database = [FMDatabase databaseWithPath:path];
if (![database open]) {
NSLog(@"數據庫打開失敗!");
}值得注意的是,Path 可傳入以下三種情況:
具體文件路徑,若不存在會自動創建。
空字符串 @"",會在臨時目錄創建一個空的數據庫,當 FMDatabase 連接關閉時,數據庫文件也被刪除。
nil,會創建一個內存中臨時數據庫,當 FMDatabase 連接關閉時,數據庫會被銷毀。
4. 更新
在 FMDB 中,除查詢以外的所有操作都稱為「更新」,如 create、drop、insert、update、delete 等,使用 executeUpdate: 方法執行:
//常用方法有以下 3 種: - (BOOL)executeUpdate:(NSString*)sql, ... - (BOOL)executeUpdateWithFormat:(NSString*)format, ... - (BOOL)executeUpdate:(NSString *)sql withArgumentsInArray:(NSArray *)arguments //示例 [database executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person(id integer primary key autoincrement, name text, age integer)"]; //或者 [database executeUpdate:@"INSERT INTO t_person(name, age) VALUES(?, ?)", @"Bourne", [NSNumber numberWithInt:42]];
5. 查詢
查詢方法也有 3 種,用起來相當簡單:
- (FMResultSet *)executeQuery:(NSString*)sql, ... - (FMResultSet *)executeQueryWithFormat:(NSString*)format, ... - (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments
查詢示例:
//1.執行查詢
FMResultSet *result = [database executeQuery:@"SELECT * FROM t_person"];
//2.遍歷結果集
while ([result next]) {
NSString *name = [result stringForColumn:@"name"];
int age = [result intForColumn:@"age"];
}6. 線程安全
在多個線程中同時使用同一個 FMDatabase 實例是不明智的——它無法在多線程中同時使用,否則會造成數據混亂等問題。所以請使用 FMDatabaseQueue,它是線程安全的。使用方法如下:
創建隊列。
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];
使用隊列。
[queue inDatabase:^(FMDatabase *database) {
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_1", [NSNumber numberWithInt:1]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_2", [NSNumber numberWithInt:2]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_3", [NSNumber numberWithInt:3]];
FMResultSet *result = [database executeQuery:@"select * from t_person"];
while([result next]) {
}
}];而且可以輕鬆地把簡單任務包裝到事務裡:
[queue inTransaction:^(FMDatabase *database, BOOL *rollback) {
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_1", [NSNumber numberWithInt:1]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_2", [NSNumber numberWithInt:2]];
[database executeUpdate:@"INSERT INTO t_person(name, age) VALUES (?, ?)", @"Bourne_3", [NSNumber numberWithInt:3]];
FMResultSet *result = [database executeQuery:@"select * from t_person"];
while([result next]) {
}
//回滾
*rollback = YES;
}];FMDatabaseQueue 後台會建立一個系列化的 GCD 隊列,並執行你傳給它的塊。這意味著,即使你從多線程同時調用方法,GCD 也會按接收塊的先後順序依次執行。
CoreData
詳見我的另一篇筆記:我要娶你做我的 CoreData!
聲明:
以上內容屬於本人整理的筆記,如有錯誤之處,希望能告訴我,大家共同進步。
以上內容有些段落或語句可能是本人從其他地方 Copy 而來,如有侵權,請及時告訴我。