NSUserDefaults简介及如何使用 NSUserDefaults 存储自定义对象

一、NSUserDefaults简介

        NSUserDefaults是一个单例,在整个程序中只有一个实例对象,他可以用于数据的永久保存,而且简单实用,这是它可以让数据自由传递的一个前提,也是大家喜欢用它保存简单数据的一个主要原因。     

       其实NSUserDefaults存储的数据是一个plist文件 存储在沙盒的Library/Preference 里,并且是按照bundleID来命名的

适用场景:适用于基本数据类型(NSUserDefaults支持的数据类型有:NSNumber(NSInteger、float、double),NSString,NSDate,NSArray,NSDictionary,BOOL),不适用存储大量的数据

写(存储): 设置key + 选择不同方法   ——> /Library/Preferences/xxx.plist  setObject/setFloat等等

读(读取): 根据key + 选择不同方法              arrayForKey/FloatForKey等

   //存储
- (IBAction)saveData:(id)sender {
   
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];

    [defaults setBool:YES forKey:@"logIn"];
    [defaults setInteger:1 forKey:@"count"];
   
    //写入的过程:除了bool/数据格式,其他都是属于object
    NSArray *array = @[@"Maggie", @"Jonny"];
    [defaults setObject:array forKey:@"userArray"];
    //NSUserDefaults是定时把缓存中的数据写入磁盘的,而不是即时写入 (强制写入),调用此句,即时写入
    [defaults synchronize];
}
 //读取
- (IBAction)loadData:(id)sender {
    //读取数据
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    //不同的对象,从文件中获取数据需要不同的方法
    NSString *content = [NSString stringWithFormat:@"array: %@; login: %d; count: %ld;",
                        [defaults  arrayForKey:@"userArray"],
                        [defaults  boolForKey:@"logIn"],
                        (long)[defaults  integerForKey:@"count"]];   
    self.textView.text = content;
}
 //删除
- (IBAction)deleteData:(id)sender {
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults removeObjectForKey:@"userArray"];
    [defaults removeObjectForKey:@"logIn"];
    [defaults removeObjectForKey:@"count"];
}

值得注意的是

        NSUserDefaults 存储的对象全是不可变的这一点非常关键,弄错的话程序会出bug),例如,如果我想要存储一个 NSMutableArray 对象,我必须先创建一个不可变数组(NSArray)再将它存入NSUserDefaults中去,代码如下:

  NSMutableArray *mutableArray = [NSMutableArray arrayWithObjects:@"123",@"234", nil];
    NSArray * array = [NSArray arrayWithArray:mutableArray];
    
    NSUserDefaults *user = [NSUserDefaults standardUserDefaults];
    [user setObject:array forKey:@"记住存放的一定是不可变的"];

取出数据是一样的,想要用NSUserDefaults中的数据给可变数组赋值

先给出一个错误的写法:

  /*-------------------------错误的赋值方法-------------------*/
    NSUserDefaults *user = [NSUserDefaults standardUserDefaults];
    
    //这样写后,mutableArray 就变成了不可变数组了,如果你要在数组中添加或删除数据就会出现bug
    NSMutableArray *mutableArray = [user objectForKey:@"记住存放的一定是不可变的"];

正确的方法:

 /*-------------------------正确的赋值方法-------------------*/
    NSUserDefaults *user = [NSUserDefaults standardUserDefaults];
    
    //可以用alloc 方法代替
    NSMutableArray *mutableArray = [NSMutableArray arrayWithArray:[user objectForKey:@"记住存放的一定是不可变的"]];

二、使用 NSUserDefaults 存储自定义对象

1、将自定义类型转换为NSData类型

      当数据重复而且多的时候(例如想存储全班同学的学号,姓名,性别(这个数据量可能太大了 )),如果不用SQLite 存储 (多数据最好还是用这个),你可以选择使用归档,再将文件写入本地,但是归档与 NSUserDefaults 比起来麻烦多了,NSUserDefaults 本身不支持自定义对象的存储,不过它支持NSData的类型,可以先将对象转成NSData,再存储。

   (1)我们先建立一个叫Person的类,这个类里有三个属性,注意遵守NSCoding协议

@interface Person : NSObject <NSCoding>
@property (nonatomic,strong) NSString *name;
@property (nonatomic,assign) NSInteger age;
@end

在Person.m里重写

-(id)initWithCoder:(NSCoder *)aDecoder 和 -(void)encodeWithCoder:(NSCoder *)aCoder 方法(必须遵守 NSCoding协议才可以用归档方式

#import "Person.h"

@implementation Person

// 当从文件中读取一个对象的时候就会调用该方法
// 在该方法中说明如何读取保存在文件中的对象
// 也就是说在该方法中说清楚怎么读取文件中的对象
-(id)initWithCoder:(NSCoder *)aDecoder
{
    if (self = [super init]) {
        self.name = [aDecoder decodeObjectForKey:@"name"];
        self.age = [aDecoder decodeIntegerForKey:@"age"];
    }
    return self;
}


// 当将一个自定义对象保存到文件的时候就会调用该方法
// 在该方法中说明如何存储自定义对象的属性
// 也就说在该方法中说清楚存储自定义对象的哪些属性
-(void)encodeWithCoder:(NSCoder *)aCoder
{
    [aCoder encodeObject:self.name forKey:@"name"];
    [aCoder encodeInteger:self.age forKey:@"age"];
}

@end

这样做就可以将自定义类型转变为NSData类型了

2、将自定义类型数据存入 NSUserDefaults 中

2.1 保存单个自定义对象

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  
    //存储
    Person *pp = [[Person alloc]init];
    pp.name = @"qinting";
    pp.age = 10;
    [self saveCustomObject:pp];
   
    //读取出来
      Person *p = [self loadCustomObjectWithKey:@"person"];
      NSLog(@"%@---%ld",p.name,p.age);

}

- (void)saveCustomObject:(Person *)person
{
    NSData *myEncodedObject = [NSKeyedArchiver archivedDataWithRootObject:person];
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    [defaults setObject:myEncodedObject forKey:@"person"];
}
- (Person *)loadCustomObjectWithKey:(NSString *)key
{
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    NSData *myEncodedObject = [defaults objectForKey:key];
    Person *person = (Person *)[NSKeyedUnarchiver unarchiveObjectWithData: myEncodedObject];
    return person;
}

@end

2.2保存多个自定义对象

     //存储
    NSMutableArray* array = [[NSMutableArray alloc] init];
    for(int i=0; i<3; i++)
    {
        Person *person = [[Person alloc]init];
        person.age = 100 + i;
        person.name = [NSString stringWithFormat:@"qinting--%d", i];
        [array addObject:person];
    }
    [[NSUserDefaults standardUserDefaults] setObject:[NSKeyedArchiver archivedDataWithRootObject:array] forKey:@"myArray"];
    
    
     //读取出来
    NSData* data  = [[NSUserDefaults standardUserDefaults] objectForKey:@"myarray"];
    NSArray *oldSavedArray = [NSKeyedUnarchiver unarchiveObjectWithData:data];
    for(Person* person in oldSavedArray)
    {
        NSLog(@"名字:%@,年龄:%ld",person.name,person.age);
    }

注意点:1.NSUserDefaults存储的是不可变的对象(NSData也是不可变的对象)

           2.保证每个key都是唯一的

           3.自定义对象,转换成NSData,就可以存储,比如 

NSData *myEncodedObject = [NSKeyedArchiver archivedDataWithRootObject:person];

读取时先读为NSData,再转换为对象

     NSData *myEncodedObject = [defaults objectForKey:key];
    Person *person = (Person *)[NSKeyedUnarchiver unarchiveObjectWithData: myEncodedObject];


你可能感兴趣的:(NSUserDefaults,存储自定义对象)