一,NSUserDefaults 介绍
NSUserDefaults iOS系统提供的一个单例类(iOS提供了若干个单例类),通过类方法 standardUserDefaults可以获取NSUserDefaults单例。是
NSUserDefaults *defaults = [NSUserDefaults standarUserDefaults];
NSUserDefaults 单例是以key-value的形式储存类似用户的配置等数据,key是名称,value是相应的值,存/取数据时可以使用方法 objectForKey: 和setObject:forKey:
// 存数据 NSSTring类型
NSSTring * userNameStr = @"我是账号";
NSUserDefaults *defaults = [NSUserDefaults standarUserDefaults];
[defaults setObject:userNameStr forKey:@"userName"];
[defaults synchronize];
// 取数据
NSUserDefaults *defaults = [NSUserDefaults standarUserDefaults];
NSSTring *userName = [defaults objectForKey:@"userName"];
注意: 对相同的key赋值相当于覆盖,要保证每一个key的唯一性
NSUserDefaults适合存储轻量级的本地数据,一些简单的数据,例如用户名,密码,如果我们定义的是一个对象,这时候就不能直接用NSUserDefaults来存储了
支持的数据类型:
- NSString
- NSNumber
- NSData
- NSArray
- NSDictionary
- BOOL
- NSInteger
- NSFloat
二、使用 NSUserDefaults 存储自定义对象
需要将自定义对象归档成 NSData 的类型,然后储存,不然程序会报错。
自定义对象需要遵守NSCoding协议,实现以下方法
- (void)encodeWithCoder:(NSCoder *)aCoder
- (instancetype)initWithCoder:(NSCoder *)aDecoder
// .h 文件
@interface Person : NSObject <NSCoding>
@property (nonatomic ,copy) NSString * name;
@property (nonatomic ,copy) NSString * sex;
@property (nonatomic ,assign) int age;
@end
// .m 文件
@implementation Person
- (void)encodeWithCoder:(NSCoder *)aCoder
{
[aCoder encodeObject:self.name forKey:@"name"];
[aCoder encodeObject:self.sex forKey:@"sex"];
[aCoder encodeInt:self.age forKey:@"age"];
}
- (instancetype)initWithCoder:(NSCoder *)aDecoder
{
if (self = [super init]) {
self.name = [aDecoder decodeObjectForKey:@"name"];
self.sex = [aDecoder decodeObjectForKey:@"sex"];
self.age = [aDecoder decodeIntForKey:@"age"];
}
return self;
}
@end
单个对象保存数据
// 单个数据保存 (自定义对象)
- (void)singleDataSave
{
// 创建person对象
Person *person = [[Person alloc] init];
person.name = @"我是";
person.sex = @"男";
person.age = 20;
// 转换成NSData的格式(归档)
NSData * data = [NSKeyedArchiver archivedDataWithRootObject:person];
// 保存
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults] ;
[defaults setObject:data forKey:@"singleDataSave"];
// 立即保存
[defaults synchronize];
}
单个对象读取数据
// 单个数据读取 (自定义对象)
- (void)singleDataRead
{
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults] ;
NSData * data = [defaults objectForKey:@"singleDataSave"];
// 转换成Person的数据(解档)
Person * p = [NSKeyedUnarchiver unarchiveObjectWithData:data];
NSLog(@"------------- %@ --------------",p.name);
}
单个对象删除数据
// 单个数据删除 (自定义对象)
- (void)singleDataDelete
{
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
[defaults removeObjectForKey:@"singleDataSave"];
[defaults synchronize];
}
三、NSUserDefaults 域
user defaults数据库中其实是由多个层级的域组成的,当你读取一个键值的数据时,NSUserDefaults 从上到下透过域的层级寻找正确的值,不同的域有不同的功能,有些域是可持久的,有些域则不行。
- 应用域 (application domain)是最重要的域,它存储着你app通过NSUserDefaults set...forKey添加的设置。
- 注册域(registration domain)仅有较低的优先权,只有在应用域没有找到值时才从注册域去寻找
- 全局域(global domain)则存储着系统的设置
- 语言域(language-specific domains)则包括地区、日期等
- 参数域(argument domain)有最高优先权
四、通过 UIImangeJPERepresentation 方法把 image 转化为NSData 存储
UIImage *image = [UIImage imageNamed:@"123.jpg"];
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
[defaults setObject: UIImageJPEGRepresentation(image, 0.5) forKey:@"我是图片"];
[defaults synchronize];
五、注意点
注意 1、如果要存放自定义对象(比如自定义的类对象),则必须将其转化成NSData类型
注意 2、NSUserDefaults 存储的对象全是不可变的(弄错的话程序会出现BUG),例如,如果我想要存储一个NSMutableArray 对象,我必须先创建一个不可变数组(NSArray)再将他保存到 NSUserDefaults 中
// 存放不可变数据
NSMutableArray *mutableArray = [NSMutableArray arrayWithObjects:@"1",@"2",@"3",nil];
NSArray *array = [NSArray arrayWithArray:mutableArray];
NSUserDefaults *defaults = [NSUserDefaults standarUserDefaults];
[defaults setObject:array forKey:@"存放的一定是不可变得"];
[defaults synchronize];
// 取出不可变数据
NSUserDefaults *defaults = [NSUserDefaults standarUserDefaults];
NSArray *array = [defaults objectForKey:@"存放的一定是不可变得"];
// 如果想要数据可变,如下
NSMutableArray *mutableArray = [NSMutableArray arrayWithArray:array];
注意 3、synchronize 方法如果不调用,系统会每隔一段时间自动保存
注意 4、boolForKey 如果数据库没有这个key的默认值时,将返回NO,这就会造成无法区分 NO 和 NO value 同样 integerForKey 如果没有这个key的默认值时,将返回0,这就会造成无法区分是你自己存储的0 还是 系统默认设置的0,解决方式:使用registerDefaults:方法,用一个字典,或者plist文件
BOOL isShow = [[NSUserDefaults standardUserDefaults] boolForKey:@"isShow"];
NSInteger number =[[NSUserDefaults standardUserDefaults] integerForkey:@"我没有key值"];
// 通过字典注册
NSUserDefaults *defaults = [[NSUserDefaults standardUserDefaults] ];
NSDictionary *dict = [NSDictionary dictionaryWithObjectsAndKeys:@"true",@"test",@"3",@"inter", nil];
[defaults registerDefaults:dict];
// 通过plist文件注册
NSURL *defaultPrefsFile = [[NSBundle mainBundle]
URLForResource:@"DefaultPreferences" withExtension:@"plist"];
NSDictionary *defaultPrefs = [NSDictionary dictionaryWithContentsOfURL:defaultPrefsFile];
[[NSUserDefaults standardUserDefaults] registerDefaults:defaultPrefs];
注意需要在每次启动app并且没有在user defaules中读取数据的时候调用以上方法,因为registerDefaults:不能把这些默认数据存储到硬盘上,所以application:didFinishLaunchingWithOptions是最合适的地方。
这样做的原因是:默认情况下,应用域是空的,没见键也没有值。当应用第一次设置某项用户偏好设置的值时,相应的值会通过指定的键加入应用域。当通过NSUserDefaults获取某项用户偏好设置的值时,NSUserDefaults会先在应用域中查找,如果找到了值,NSUserDefaults就会返回这个值。如果没有找到,NSUserDefaults就会在注册域中查找并返回默认值