plist 是 iOS 最直覺的輕量資料格式,適合存放設定、少量結構化資料。本文示範如何在一個簡單的單頁應用中完成 plist 的建立、寫入與讀回。
畫面上放一個 textInput 作為輸入、一個 displayLabel 作為輸出,再加一顆「保存」按鈕觸發 triggerStorage 方法。按下按鈕時,把輸入框內容顯示到標籤上,同時寫入 Documents 目錄下的 test.plist。
- (void)triggerStorage {
displayLabel.text = textInput.text;
// 取得 Documents 目錄
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *path = [paths objectAtIndex:0];
NSString *filename = [path stringByAppendingPathComponent:@"test.plist"];
// 先讀一次現有內容
NSDictionary *dic2 = [NSDictionary dictionaryWithContentsOfFile:filename];
NSLog(@"dic2 is:%@", dic2);
// 組裝要寫入的資料
NSDictionary *dic = [NSDictionary dictionaryWithObjectsAndKeys:displayLabel.text, @"IP", nil];
[dic writeToFile:filename atomically:YES];
}
viewDidLoad 中先嘗試讀檔:檔案不存在就用 NSFileManager 建一個空的 plist;檔案存在就取出 "IP" 鍵的值填回標籤。最後在navigation bar 右側掛上一顆保存按鈕。
- (void)viewDidLoad {
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *path = [paths objectAtIndex:0];
NSLog(@"path = %@", path);
NSString *filename = [path stringByAppendingPathComponent:@"test.plist"];
NSDictionary *dic2 = [NSDictionary dictionaryWithContentsOfFile:filename];
if (dic2 == nil) {
// 檔案不存在,建立一個空的 plist
NSFileManager *fm = [NSFileManager defaultManager];
[fm createFileAtPath:filename contents:nil attributes:nil];
} else {
NSString *resultData = [dic2 objectForKey:@"IP"];
if ([dic2 count] > 0) {
displayLabel.text = resultData;
} else {
displayLabel.text = @" ";
}
}
self.navigationItem.rightBarButtonItem =
[[[UIBarButtonItem alloc] initWithTitle:@"保存"
style:UIBarButtonItemStylePlain
target:self
action:@selector(triggerStorage)] autorelease];
[super viewDidLoad];
}
如果只想快速驗證流程,這段獨立程式碼就足夠:
// 1. 建立 plist 檔
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *path = [paths objectAtIndex:0];
NSString *filename = [path stringByAppendingPathComponent:@"test.plist"];
NSFileManager *fm = [NSFileManager defaultManager];
[fm createFileAtPath:filename contents:nil attributes:nil];
// 2. 寫入
NSDictionary *dic = [NSDictionary dictionaryWithObjectsAndKeys:@"sina", @"1", @"163", @"2", nil];
[dic writeToFile:filename atomically:YES];
// 3. 讀回
NSDictionary *dic2 = [NSDictionary dictionaryWithContentsOfFile:filename];
NSLog(@"dic is:%@", dic2);
plist 只能存放 Foundation 的基本型別(NSString、NSNumber、NSData、NSDate、Array、Dictionary),自訂物件需先透過 NSCoding 轉成 NSData。另外,plist 讀寫是全檔重寫,資料量大時成本很高,若只是幾個設定值,NSUserDefaults 會更合適;真正的海量資料則該考慮 Core Data 或 SQLite。