NSUserDefaults類概述
NSUserDefaults類爲和默認的系統進行交互提供了一個系統編程接口。默認的系統允許一個應用來定製它的行爲以適應用戶的喜好。例如,你可以允許用戶去決定你的應用程序顯示什麼樣的計量單位或者文件多少時間自動保存。應用程序在用戶默認的數據庫裏分配記錄的參數值。這些參數被作爲默認值,因爲他們通常用於確定一個用用程序在啓動時的默認狀態或者默認狀態的作用方式。
在運行時,你可以使用NSUserDefaults對象讀取你的應用程序的從一個用戶默認數據庫使用的默認數據。NSUerDefaults緩存信息,以避免每次獲取一個默認值都需要打開用戶默認的數據庫。同步方法,他會每隔一段時間自動調用,使內存中緩存的信息與用戶默認數據庫中的信息同步。
NSUserDefaults類爲訪問普通類型的變量提供便利的方法,這些類型有floats,doubles,integers,booleans和URLs。一個默認的對象必須是一個屬性列表,是NSData,NSString,NSNumber,NSDate,NSArray或者NSDictionary的實例。如果你想存儲其它類型的對象,你應當將其轉換成一個NSData的實例。
從NSUserDefaults返回的值都是不可變的。即使你設置了一個可變的值。例如,你設置了一個可變的字符串作爲“MyStringDefault”的值,你用stringForKey:獲取到的字符串將是不可變的。
默認數據庫是爲用戶自動創建的。NSUserDefaults目前不支持per-host的偏好(設置)。要做到這一點,你必須使用CFPreferences API.然而,NSUserDefaults正確的讀取per-host的偏好,所以你可以安全地混合CFPreferences與NSUserDefaults的代碼。
如果你的應用程序支持管理的環境,你可以使用一個NSUserDefaults對象去決定哪些對用戶有利的喜好是由管理員管理的。受管理的環境中對應的計算機實驗室或教室管理員或教師肯能需要以一種特定的方式配置系統。在這種情況下,教師會建立一組默認的偏好設置並且強制對用戶使用。如果以這種方式管理偏好設置,應用程序應該防止用戶編輯,禁用任何適當的控制。
NSUserDefaults類是線程安全的。
NSURL的持久性和文件引用的URLs
當使用NSURL實例參考文件內的過程中,重要的是要基於位置的跟蹤與文件系統的身份跟蹤之間的區別。當堅持一個NSURL,你應該考慮採取這種行爲。如果你的應用程序跟蹤位於其身份的資源,那麼當用戶移動文件的時候你可以發覺到,那麼你應該明確的解NSURL的書籤數據或者對文件引用的URL進行編碼。
如果你想通過文件的引用跟蹤文件,但是當解析時你需要顯式控制,你需要關心的把書籤數據寫到NSUserDefaults中,而不是依靠[NSUserDefaults setURL:forKey:],當你知道你的應用程序將能夠處理潛在的I/O所需的用戶界面交互時允許你調用[NSURL URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:]
沙盒注意事項
一個沙盒應用不能訪問和修改其他應用的偏好設置。例如,如果你使用addSuiteNamed:方法添加另一個應用程序,但是你不會獲得該應用程序的偏好設置。
嘗試去訪問或者修改另一個應用的偏好設置不會導致錯誤,但是當你你做的時候,世紀上OS X讀取和寫入位於應用程序容器內的文件,而不是其他應用程序的偏好設置文件。
獲取公有的NSUserDefaults實例
- + (NSUserDefaults *)standardUserDefaults;
- 單例模式,獲取NSUserDefaults的一個實例,默認Key值如下:
- AppleLanguages,
- AppleKeyboardsExpanded,
- AppleITunesStoreItemKinds,
- AppleLocale,
- AppleKeyboards,
- NSLanguages,
- NSInterfaceStyle
- + (void)resetStandardUserDefaults;
- - (id)init;
- - (id)initWithUser:(NSString *)username;
- init是初始化一個公有的defaults對象
- initWithUser是初始化一個針對username的對象
註冊一個defaults
- - (void)registerDefaults:(NSDictionary *)registrationDictionary;
- 註冊的內容(registrationDictionary裏的)不寫入磁盤
獲取Defaults的值
- - (NSArray *)arrayForKey:(NSString *)defaultName;
- - (BOOL)boolForKey:(NSString *)defaultName;
- 返回一個和defaultName關聯的bool值,如果不存在defaultName的話返回NO
- - (NSData *)dataForKey:(NSString *)defaultName
- 返回defaultName所對應的NSData數據,如果defaultName不存在或者返回的數據不是NSData類型的都會返回nil
- 返回的數據是不可變類型的
- - (NSDictionary *)dictionaryForKey:(NSString *)defaultName
- 同dataForKey
- - (float)floatForKey:(NSString *)defaultName
- 同dataForKey
- 如果defaultName不存在返回0
- - (NSInteger)integerForKey:(NSString *)defaultName
- 同floatForKey
- 如果defaultName不存在返回0
- - (id)objectForKey:(NSString *)defaultName
- 同dataForKey
- - (NSArray *)stringArrayForKey:(NSString *)defaultName
- 同dataForKey
- 如果defaultName不存在,或者defaultName所對應的不是一個數組,或者數組包含的不是NSString對象都會返回nil
- - (NSString *)stringForKey:(NSString *)defaultName
- 同dataForKey
- - (double)doubleForKey:(NSString *)defaultName
- 同floatForKey
- - (NSURL *)URLForKey:(NSString *)defaultName
- 同dataForKey
- 當調用[NSUserDefaults URLForKey:]時,有以下3種情況:
- 1.如果值是NSData,NSData可以作爲[NSKeyedUnarchiver unarchiveObjectWithData:]的參數。如果NSData可以作爲NSURL存檔就返回一個NSURL,否則返回nil
- 2.如果值是一個文件引用的URL,那麼這個文件引用的URL將會被創建,但是它的書籤數據不會被解決直到以後使用NSURL實例
- 3.如果值是一個一~開頭的字符串,這個字符串將會用[NSString stringByExpandingTildeInPath]擴展,文件將會以NSURL創建
設置Defaults值
- – setBool:forKey:
- – setFloat:forKey:
- – setInteger:forKey:
- – setDouble:forKey:
- – setObject:forKey:
- 對象參數只能是屬性列表對象:NSData,NSString,NSNumber,NSDate,NSArray,NSDictionary
- – setURL:forKey:
移除Defaults值
- - (void)removeObjectForKey:(NSString *)defaultName
維護持久域
- - (BOOL)synchronize
- 把持久域中的任何改變寫到磁盤並且更新磁盤上的任何沒有修改的持久域
- 如果返回YES表明成功保存到磁盤,相反返回NO
- 這個方法是以一定週期間隔自動調用的,如果你不想等待自動調用就可以調用這個方法來同步。(例如,如果你的應用要退出時,或者你想更新磁盤上的defaults即使你沒有做任何改變)
- - (NSDictionary *)persistentDomainForName:(NSString *)domainName
- 返回一個特定持久域的鍵值對
- - (NSArray *)persistentDomainNames
- 返回當前的持久域的名稱
- - (void)removePersistentDomainForName:(NSString *)domainName
- 移除對應domainName的持久域
- - (void)setPersistentDomain:(NSDictionary *)domain forName:(NSString *)domainName
- 設置持久域
- domainName
- This value should be equal to your application's bundle identifier.
訪問管理的環境值
- - (BOOL)objectIsForcedForKey:(NSString *)key
- - (BOOL)objectIsForcedForKey:(NSString *)key inDomain:(NSString *)domain
管理搜索列表
- – removeVolatileDomainForName:
- – setVolatileDomain:forName:
- – volatileDomainForName:
- – volatileDomainNames
維護套件
- - (void)addSuiteNamed:(NSString *)suiteName
- 一個套件可以在不同的應用之間使用
- - (void)removeSuiteNamed:(NSString *)suiteName
- 移除套件
NSUserDefaults適合存儲輕量級的本地數據,比如要保存一個登陸界面的數據,用戶名、密碼之類的,個人覺得使用NSUserDefaults是首選。下次再登陸的時候就可以直接從NSUserDefaults裏面讀取上次登陸的信息咯。
因爲如果使用自己建立的plist文件什麼的,還得自己顯示創建文件,讀取文件,很麻煩,而是用NSUserDefaults則不用管這些東西,就像讀字符串一樣,直接讀取就可以了。
NSUserDefaults支持的數據格式有:NSNumber(Integer、Float、Double),NSString,NSDate,NSArray,NSDictionary,BOOL類型。
- #import <UIKit/UIKit.h>
- @interface ViewController : UIViewController
- {
- IBOutlet UILabel *txtInteger;
- IBOutlet UILabel *txtFloat;
- IBOutlet UILabel *txtDouble;
- IBOutlet UILabel *txtNSString;
- IBOutlet UILabel *txtNSDate;
- IBOutlet UILabel *txtNSArray;
- IBOutlet UILabel *txtNSDictionary;
- }
- @end
saveNSUserDefaults:用於將各種類型數據保存到NSUserDefaults中
readNSUserDefautls:用於從NSUserDefaults中讀取各種類型的數據。在viewDidLoad中調用這兩個方法就可以看出結果咯
- #import "ViewController.h"
- @interface ViewController ()
- @end
- @implementation ViewController
- - (void)viewDidLoad
- {
- [super viewDidLoad];
- [self saveNSUserDefaults]; //調用此方法將各種數據存儲到NSUserDefautls中,在下面定義
- [self readNSUserDefaults]; //調用此方法從NSUserDefautls中讀取各種數據,在下面定義
- }
- - (void)viewDidUnload
- {
- [txtNSString release];
- txtNSString = nil;
- [txtNSDate release];
- txtNSDate = nil;
- [txtNSArray release];
- txtNSArray = nil;
- [txtNSDictionary release];
- txtNSDictionary = nil;
- [txtInteger release];
- txtInteger = nil;
- [txtFloat release];
- txtFloat = nil;
- [txtDouble release];
- txtDouble = nil;
- [super viewDidUnload];
- // Release any retained subviews of the main view.
- }
- - (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
- {
- return (interfaceOrientation != UIInterfaceOrientationPortraitUpsideDown);
- }
- - (void)dealloc {
- [txtNSString release];
- [txtNSDate release];
- [txtNSArray release];
- [txtNSDictionary release];
- [txtInteger release];
- [txtFloat release];
- [txtDouble release];
- [super dealloc];
- }
- //保存數據到NSUserDefaults
- -(void)saveNSUserDefaults
- {
- NSString *myString = @"enuola";
- int myInteger = 100;
- float myFloat = 50.0f;
- double myDouble = 20.0;
- NSDate *myDate = [NSDate date];
- NSArray *myArray = [NSArray arrayWithObjects:@"hello", @"world", nil];
- NSDictionary *myDictionary = [NSDictionary dictionaryWithObjects:[NSArray arrayWithObjects:@"enuo", @"20", nil] forKeys:[NSArray arrayWithObjects:@"name", @"age", nil]];
- //將上述數據全部存儲到NSUserDefaults中
- NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];
- //存儲時,除NSNumber類型使用對應的類型意外,其他的都是使用setObject:forKey:
- [userDefaults setInteger:myInteger forKey:@"myInteger"];
- [userDefaults setFloat:myFloat forKey:@"myFloat"];
- [userDefaults setDouble:myDouble forKey:@"myDouble"];
- [userDefaults setObject:myString forKey:@"myString"];
- [userDefaults setObject:myDate forKey:@"myDate"];
- [userDefaults setObject:myArray forKey:@"myArray"];
- [userDefaults setObject:myDictionary forKey:@"myDictionary"];
- //這裏建議同步存儲到磁盤中,但是不是必須的
- [userDefaults synchronize];
- }
- //從NSUserDefaults中讀取數據
- -(void)readNSUserDefaults
- {
- NSUserDefaults *userDefaultes = [NSUserDefaults standardUserDefaults];
- //讀取數據到各個label中
- //讀取整型int類型的數據
- NSInteger myInteger = [userDefaultes integerForKey:@"myInteger"];
- txtInteger.text = [NSString stringWithFormat:@"%d",myInteger];
- //讀取浮點型float類型的數據
- float myFloat = [userDefaultes floatForKey:@"myFloat"];
- txtFloat.text = [NSString stringWithFormat:@"%f",myFloat];
- //讀取double類型的數據
- double myDouble = [userDefaultes doubleForKey:@"myDouble"];
- txtDouble.text = [NSString stringWithFormat:@"%f",myDouble];
- //讀取NSString類型的數據
- NSString *myString = [userDefaultes stringForKey:@"myString"];
- txtNSString.text = myString;
- //讀取NSDate日期類型的數據
- NSDate *myDate = [userDefaultes valueForKey:@"myDate"];
- NSDateFormatter *df = [[NSDateFormatter alloc] init];
- [df setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
- txtNSDate.text = [NSString stringWithFormat:@"%@",[df stringFromDate:myDate]];
- //讀取數組NSArray類型的數據
- NSArray *myArray = [userDefaultes arrayForKey:@"myArray"];
- NSString *myArrayString = [[NSString alloc] init];
- for(NSString *str in myArray)
- {
- NSLog(@"str= %@",str);
- myArrayString = [NSString stringWithFormat:@"%@ %@", myArrayString, str];
- [myArrayString stringByAppendingString:str];
- // [myArrayString stringByAppendingFormat:@"%@",str];
- NSLog(@"myArrayString=%@",myArrayString);
- }
- txtNSArray.text = myArrayString;
- //讀取字典類型NSDictionary類型的數據
- NSDictionary *myDictionary = [userDefaultes dictionaryForKey:@"myDictionary"];
- NSString *myDicString = [NSString stringWithFormat:@"name:%@, age:%d",[myDictionary valueForKey:@"name"], [[myDictionary valueForKey:@"age"] integerValue]];
- txtNSDictionary.text = myDicString;
- }
- @end
好了,運行一下,可以看到xib文件中的各種數據已經綁定上了吧?
再次運行的時候,可以把viewDidLoad中的 [self saveNSUserDefaults]; 這一行註釋掉,讓程序直接讀取而不存儲數據,發現以前保存的數據仍然可以讀取到界面上。
嘻嘻,很簡單吧,就這樣就可以是實現數據的存儲了。
下面講一下原理:
你可能會問一個問題:NSUserDefautls將數據存儲在什麼地方了???我都沒有顯示的指定路徑???很疑惑吧。。。。
用NSUserDefaults存儲的數據下次程序運行的時候依然存在,它把數據存儲在什麼地方了?如何能夠清除?
其實它存儲在應用程序內置的一個plist文件裏,這個可以根據路徑看到。
比如說這個是你的程序沙盒位置
/UsersLibrary/Application Support/iPhoneSimulator/4.1/Applicati*****/29788E40-AF47-45A0-8E92-3AC0F501B7F4/,(這個是應用程序對應在mac上的位置)
這個下面有/Library/Prefereces,裏面有個plist文件,存儲的就是你的userDefaults
想要刪掉的話,用removeObjectForKey或者刪掉沙盒,也就是你的應用程序然後重新安裝
/UsersLibrary/Application Support/iPhoneSimulator/4.1/Applicati*****/29788E40-AF47-45A0-8E92-3AC0F501B7F4/,(這個是應用程序對應在mac上的位置)
這個下面有/Library/Prefereces,裏面有個plist文件,存儲的就是你的userDefaults
想要刪掉的話,用removeObjectForKey或者刪掉沙盒,也就是你的應用程序然後重新安裝