您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 資料存取完整指南:沙盒、plist、偏好設定、归档、SQLite3 與 Core Data

編輯:iOS 開發綜合

一、iOS 常用的資料儲存方式

plist 屬性列表、Preference 偏好設定、NSKeyedArchiver 归档(NSCoding)、SQLite3、Core Data。

二、應用程式沙盒(Sandbox)

每個 iOS App 都有屬於自己的沙盒,也就是一個獨立目錄,與其他 App 完全隔離。App 只能在自己的沙盒內活動,無法存取別人的資料。

假設 App 名稱為 Layer,其沙盒目錄結構大致如下:

Documents:存放重要資料與使用者可見的檔案,iTunes 備份時會一併保存。

tmp:暫存檔,系統在 App 未執行時可能隨時清除。

Library/Caches:快取資料,不會被 iTunes 備份,系統在儲存空間不足時可能刪除。

Library/Preference:偏好設定,透過 NSUserDefaults 存取。

取得沙盒路徑

不建議直接拼接 Documents 字串,因為新版本系統可能調整目錄名稱。正確做法是用 NSHomeDirectory() 搭配 NSSearchPathForDirectoriesInDomains:

// 取得 Documents 目錄
NSString *home = NSHomeDirectory();
NSString *documents = [home stringByAppendingPathComponent:@"Documents"];

// 建議寫法
// NSUserDomainMask 代表從使用者目錄下尋找,YES 代表展開路徑中的 ~ 字元
NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
// 在 iOS 中只有一個目錄會符合條件,因此集合裡只有一個元素
NSString *documents = [array objectAtIndex:0];

其他目錄的取得方式

tmp:NSString *tmp = NSTemporaryDirectory();

Library/Caches:用沙盒根目錄拼接 "Caches",或把 NSSearchPathForDirectoriesInDomains 的第二個參數改成 NSCachesDirectory。

Library/Preference:透過 NSUserDefaults 類存取其中的設定資訊。

三、屬性列表(plist)

屬性列表是一種 XML 格式的檔案,副檔名為 plist。若物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 等型別,可以直接用 writeToFile:atomically: 寫入。

归档 NSDictionary

// 將資料封裝成字典
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];

讀回 NSDictionary

NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path];
NSLog(@"name:%@",  [dict objectForKey:@"name"]);
NSLog(@"phone:%@", [dict objectForKey:@"phone"]);
NSLog(@"age:%@",   [dict objectForKey:@"age"]);

四、偏好設定 NSUserDefaults

很多 App 需要儲存使用者名稱、密碼、字型大小等設定,iOS 提供了標準方案。每個 App 都有一個 NSUserDefaults 單例用來存取偏好設定。

寫入

NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
[defaults setObject:@"itcast" forKey:@"username"];
[defaults setFloat:18.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 方法後,資料有可能還沒寫入就結束程式。若需要確保立即寫入,請呼叫 [defaults synchronize];(新版的系統已大幅改善這個問題,但仍建議保留)。

五、NSKeyedArchiver 归档

若物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 等型別,可以直接用 NSKeyedArchiver 归档與還原。自訂類別則必須先遵守 NSCoding 協議。

NSCoding 有兩個方法:

encodeWithCoder: 每次归档物件時呼叫,在裡面指定如何归档每個實例變數,用 encodeObject:forKey: 處理。

initWithCoder: 每次從檔案還原物件時呼叫,在裡面指定如何解碼,用 decodeObjectForKey: 處理。

归档 NSArray

Person 類的宣告(Person.h)

@interface Person : NSObject <NSCoding>
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) int age;
@property (nonatomic, assign) float height;
@end

Person 類的實作(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];
person.name   = @"MJ";
person.age    = 27;
person.height = 1.83f;
[NSKeyedArchiver archiveRootObject:person toFile:path];

// 還原(解碼)
Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path];

繼承時要注意

若父類別也遵守了 NSCoding 協議,請務必:

在 encodeWithCoder: 中加上 [super encodeWithCoder:encoder];,確保繼承而來的實例變數也被編碼。

在 initWithCoder: 中加上 self = [super initWithCoder:decoder];,確保繼承而來的實例變數也能被解碼。

六、用 NSData 归档多個物件到同一檔案

archiveRootObject:toFile: 一次只能寫一個物件。若要把多個物件存進同一個檔案,就要用 NSData 作為暫存空間。

編碼

// 建立一塊可變資料區
NSMutableData *data = [NSMutableData data];

// 把資料區接到 NSKeyedArchiver
NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
[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];
// 解析 data,得到一個全新的物件
Person *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data];

NSLog(@"person1:%p", person1);   // person1:0x7177a60
NSLog(@"person2:%p", person2);   // person2:0x7177cf0

兩者記憶體位址不同,代表是完全獨立的兩個物件,這正是深拷貝的效果。

七、SQLite3

SQLite3 是一套開源的嵌入式關聯式資料庫,可攜性佳、易使用、記憶體開銷小。它是「無型別」的,也就是說你可以把任何型別的資料存進任意表、任意欄位。以下建表語句是合法的:

create table t_person(name, age);

但為了可讀性,建議還是把欄位型別標上:

create table t_person(name text, age integer);

常用的五種資料型別:text、integer、float、boolean、blob。

在 iOS 中使用 SQLite3,第一步是加入 libsqlite3.dylib(新版為 libsqlite3.tbd)並導入 <sqlite3.h>。

開啟與關閉資料庫

sqlite3 *db;
int result = sqlite3_open([path UTF8String], &db);

sqlite3_open() 會依路徑開啟資料庫,若檔案不存在則建立新的。result 等於 SQLITE_OK 代表成功。注意路徑必須以 C 字串傳入,而不是 NSString。

sqlite3_close(db);

執行不傳回結果的 SQL

char *errorMsg = NULL;
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() 等綁定函式的參數:第一個是 statement,第二個是佔位符位置(從 1 開始,不是 0),第三個是要綁定的值,第四個是資料長度(C 字串可傳 -1),第五個是可選的回呼,通常用於語句執行後的記憶體清理。

sqlite3_step() 執行語句,傳回 SQLITE_DONE 代表成功。

sqlite3_finalize() 銷毀 statement 物件。

查詢資料

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

Core Data 不是資料庫,而是一套物件圖管理框架,底層預設使用 SQLite 作為持久化存儲。

模型檔(xcdatamodeld)

NSManagedObject

透過 Core Data 取出的物件預設都是 NSManagedObject。它的操作方式有點像 NSDictionary,用「鍵—值」對來存取所有實體屬性:

setValue:forKey: 設定屬性值(屬性名為 key)。

valueForKey: 取得屬性值(屬性名為 key)。

Core Data 的主要角色

NSManagedObjectModel 是模型;NSPersistentStoreCoordinator 是持久化存儲協調者;NSManagedObjectContext 是操作上下文;NSPersistentStore 是實際的存儲庫。

建立 Core Data 環境

// 1. 從 App bundle 載入模型檔
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];

// 2. 傳入模型,初始化持久化存儲協調者
NSPersistentStoreCoordinator *psc =
    [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];

// 3. 建立 SQLite 檔案路徑
NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];

// 4. 加入持久化存儲庫
NSError *error = nil;
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType
                                            configuration:nil
                                                      URL:url
                                                  options:nil
                                                   error:&error];
if (store == nil) {
    [NSException raise:@"添加資料庫錯誤" format:@"%@", [error localizedDescription]];
}

// 5. 建立上下文並指定 coordinator
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] init];
context.persistentStoreCoordinator = psc;

新增資料

// 建立 Person 實體
NSManagedObject *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person"
                                                     inManagedObjectContext:context];
[person setValue:@"MJ" forKey:@"name"];
[person setValue:[NSNumber numberWithInt:27] 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];

// 指定要查詢的實體
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 %@", @"*Itcast-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]];
}

開啟 SQL 日誌

在 App 啟動參數或 scheme 的 launch arguments 中加入 -com.apple.CoreData.SQLDebug 1,即可在 console 看到 Core Data 實際送出的 SQL 語句,對排查效能問題非常有幫助。

九、Core Data 的延遲載入

Core Data 不會依關聯關係立即抓取相關物件。例如取出 Person 實體時,並不會馬上去查關聯的 Card;直到應用真的存取 Card,才會向資料庫發查詢並載入。這就是所謂的 fault(缺省)機制,能有效降低初始載入成本,但也意味著若在物件離開上下文後才存取關聯,可能導致 crash。

十、建立 NSManagedObject 的子類

預設取出的實體都是 NSManagedObject,能用鍵—值對存取資料。但若需要在存取資料之外加上業務方法,就必須自訂子類。在 Xcode 中選中實體,於 Data Model Inspector 把 Class 欄位改成自訂類別名稱,再選 Editor → Create NSManagedObject Subclass 即可產生程式碼。

該怎麼選

少量、結構簡單的設定資料用 NSUserDefaults 或 plist 就夠了;需要應付自訂類別的複雜物件圖,用 NSKeyedArchiver 归档;資料量大、需要複雜查詢與關聯,選 SQLite3 或 Core Data。Core Data 開發效率高、能自動處理物件圖與版本遷移,但抽象層較厚;SQLite3 直接可控、效能可預期,卻要自己寫所有 SQL 與表格對應。團隊若已有 SQL 經驗,兩者搭配使用也是常見做法。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved