NSUserDefaults 存储

一，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 


@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就会在注册域中查找并返回默认值

GitHub代码会尽快更新