在iOS開發過程中,進行數據本地存儲是主要的模塊之一,在進行數據存儲的時候有多種情況,有些時候需要大型的數據存儲,毋容置疑需要用FMDB等數據庫存儲方法;但是有些時候存儲一些輕量級的數據,僅僅是存儲一些用戶的信息(用戶ID、賬號、密碼、昵稱等)簡單數據,使用NSUserDefaults是首選,它是一個單例類,通過鍵值對的方式記錄設置,用于數據的本地永久化存儲,而且NSUserDefaults使用起來非常簡單方便。那么本篇文章就來深入的探討一下NSUserDefaults的使用。
一、NSUserDefaults的基本概念
簡單來說,NSUserDefaults是iOS系統提供的一個單例類,在整個程序中只有一個實例對象,通過類方法standardUserDefaults可以獲取NSUserDefaults單例。eg:NSUserDefaults? *userDefaults = [NSUserDefaults standardUserDefaults];
NSUserDefaults單例是以key-value的形式存儲了一系列的偏好設置或者一些設置的記錄,key是鍵名稱,value是對應的數據。存/取數據時可以使用方法objectForKey:和setObject:forKey:來把對象存儲到相應的plist文件中,或者讀取。既然是plist文件,那么對象的類型則必須是plist文件可以存儲的類型。
使用NSUserDefaults存儲自定義對象需要注意的是,NSUserDefaults只支持以下數據類型的存儲:NSString,NSDate,NSNumber(NSInteger、float、double),NSArray,NSDictionary,BOOL. 如果想要存儲其他類型的數據,需要轉換為前面的類型,才能用NSUserDefaults存儲。注意:對相同的Key賦值約等于一次覆蓋,要保證每一個Key的唯一性。
可是還需要注意一點:如果把一個自定義的類存到一個NSArray里,然后再存到NSUserDefaults里也是不能操作成功的。NSUserDefaults存儲的對象全是不可變的(這一點非常重要),eg:如果我想存儲一個NSMutableArray對象,我必須先創建一個不可變數組NSArray,再將它存入NSUserDefaults中去;eg:如果設置一個可變的字符串值作為"StringDefault”你日后檢索字符串使用,stringForKey:會是一成不變的。
如果需要存儲plist文件不支持的類型,比如圖片,可以先將其歸檔為NSData類型,再存入plist文件,可是需要注意的是:即使對象是NSArray或NSDictionary,他們存儲的類型也應該是以上范圍所包括的。
二、NSUserDefaults的基本用法
1、NSUserDefaults的保存數據:
NSUserDefaults *userDefaults =[NSUserDefaults standardUserDefaults];
[userDefaults setObject:firstName forKey:@”kUserDefaultNameKey“];
NSInteger age = [defaults integerForKey:@“kUserDefaultAgeKey”]; //這里的NSInteger沒有星號,是因為NSInteger是根據系統是64位還是32位來判斷自身是long還是int的類型,并且它不是一個標準的Objective-C對象
?//UIImage做本地存儲的步驟,圖片是通過歸檔為NSData的方式進行存儲的
UIImage *image=[[UIImage alloc]initWithContentsOfFile:@"photo.jpg"];
NSData *imageData = UIImageJPEGRepresentation(image, 100); //把UIImage對象轉換成NSData
[userDefaults synchronize]; //用synchronize方法把數據持久化到standardUserDefaults數據庫
2、NSUserDefaults的讀取數據:
NSUserDefaults *userDefaults =[NSUserDefaults standardUserDefaults];
NSString *name = [userDefaults objectForKey:@"name"]; //根據鍵值取出name
NSData *imageData = [userDefaults dataForKey:@"image"];
UIImage *Image = [UIImage imageWithData:imageData]; //將NSData轉換為UIImage
3、NSUserDefaults的清理數據:
//方法一:
[[NSUserDefaults standardUserDefaults] removeObjectForKey:key];
[[NSUserDefaults standardUserDefaults]synchronize];
//方法二:
// 先將本地存儲轉化為字典,然后用for in遍歷刪除即可
?NSUserDefaults?*userDefaults = [NSUserDefaults?standardUserDefaults];
?NSDictionary?*dictionary = [userDefaults?dictionaryRepresentation];
?for(NSString?*key?in?[dictionary?allKeys]){
? ? ? [userDefaults?removeObjectForKey:key];
? ? ? [userDefaults?synchronize];
? }
4、不同類型數據存取不同
NSUserDefaults提供了若干簡便方法可以存儲某些常用類型的值,eg:
- setBool:forKey:
- setFloat:forKey:
- setInteger:forKey:
- setDouble:forKey:
- setURL:forKey:
三、NSUserDefaults的相關類方法
// 同步對共享對象的任何的更改默認用戶和從內存中釋放它
resetStandardUserDefaults
// 返回共享默認對象
+ (NSUserDefaults *)standardUserDefaultsaddSuiteNamed:
// 插入到接收器的搜索列表中指定的域名
- (void)addSuiteNamed:( NSString *) suiteName
// 返回布爾值與指定鍵相關聯
- (BOOL)boolForKey:( NSString *) defaultName
// 返回與指定鍵相關聯的數組
- ( NSArray *)arrayForKey:( NSString *) defaultName
// 返回數據對象與指定鍵相關聯
- ( NSData *)dataForKey:( NSString *) defaultName
// 返回Dictionary對象與指定鍵相關聯
- ( NSDictionary *)dictionaryForKey:( NSString *) defaultName
// 返回一個字典,它包含在搜索列表中的域的所有鍵值對聯合( NSData , NSString , NSNumber , NSDate ,NSArray,或者NSDictionary )
- ( NSDictionary *)dictionaryRepresentation
// 消除了在標準應用程序域指定的默認鍵值
- (void)removeObjectForKey:( NSString *) defaultName
// 刪除指定的從用戶的默認持久域的內容
- (void)removePersistentDomainForName:( NSString *) domainName
// 設置指定的默認鍵到指定的布爾值
- (void)setBool:(BOOL) value forKey:( NSString *) defaultName
// 設置為指定的字典持久域
- (void)setPersistentDomain:( NSDictionary *) domain forName:( NSString *) domainName
// 設置指定的默認鍵到指定的URL值
- (void)setURL:( NSURL *) url forKey:( NSString *) defaultName
// 設置為指定的字典揮發性域
- (void)setVolatileDomain:( NSDictionary *) domain forName:( NSString *) domainName
// 返回與指定鍵關聯的字符串數組
- ( NSArray *)stringArrayForKey:( NSString *) defaultName
// 返回與指定鍵關聯的字符串
- ( NSString *)stringForKey:( NSString *) defaultName
//返回NSURL實例與指定鍵相關聯
- ( NSURL *)URLForKey:( NSString *) defaultName?
// 返回double值與指定鍵相關聯
- (double)doubleForKey:( NSString *) defaultName
// 返回浮點值與指定鍵相關聯
- (float)floatForKey:( NSString *) defaultName
// 返回NSUserDefaults對象初始化的用戶帳戶的默認為指定的
- (id)initWithUser:( NSString *) username
// 返回整數值與指定鍵關聯
- ( NSInteger NSInteger )integerForKey:( NSString *) defaultName
// 判斷這個key是否存在
- (BOOL)objectIsForcedForKey:( NSString *) key
// 返回與指定默認的第一個發生關聯的對象
- (id)objectForKey:( NSString *) defaultName
四、NSUserDefaults的域
BOOL showTutorialOnLaunch = [[NSUserDefaults standardUserDefaults] boolForKey:@"ShowTutorial"];
這種情況下,當key值@“ShowTutorial”已經設置后就會運行正確,但如果默認數據庫沒有這個key的默認值時,就返回NO,這或許就不一定是需要的值了,因為系統無法區分NO和no value。
以上解決方式:使用registerDefaults:方法
首先創建一個包含用戶偏好設置信息的DefaultPreferences.plist文件,添加到target中。在運行時,App就可加載這個文件并且把內容傳到registerDefaults :
NSURL *defaultPrefsFile = [[NSBundle mainBundle]
URLForResource:@"DefaultPreferences" withExtension:@"plist"];
NSDictionary *defaultPrefs = [NSDictionary dictionaryWithContentsOfURL:defaultPrefsFile];
[[NSUserDefaults standardUserDefaults] registerDefaults:defaultPrefs];
注意:需要在每次啟動app并且沒有在defaules中讀取數據的時候調用以上方法,因為registerDefaults:不能把這些默認數據存儲到硬盤上,所以方法application:didFinishLaunchingWithOptions是最合適的位置。
這樣做法的原因:默認情況下,應用域是空的,沒見鍵也沒有值。當應用第一次設置某項用戶偏好設置的值時,相應的值會通過指定的鍵加入應用域。當通過NSUserDefaults獲取某項用戶偏好設置的值時,NSUserDefaults會先在應用域中查找,如果找到了值,NSUserDefaults就會返回這個值。如果沒找到,NSUserDefaults就會在注冊域中查找并返回默認值。
域:
user defaults數據庫之中其實是由多個層級的域組成的,當你讀取一個鍵值的數據時,NSUserDefaults從上到下透過域的層級尋找正確的值,不同的域有不同的功能,有些域是可持久的,有些域則不行。
應用域(application domain)是最重要的域,它存儲著App通過NSUserDefaults set...forKey添加的設置;
注冊域(registration domain)僅有較低的優先權,只有在應用域沒有找到值時才從注冊域去尋找;
全局域(global domain)是存儲著系統的設置;
語言域(language-specific domains)包括地區、日期等;
參數域( argument domain)有最高優先權。