IOS 数据存储（NSKeyedArchiver 归档篇）

2023-08-14 08:25:52

什么是归档

当遇到有结构有组织的数据时，比如字典，数组，自定义的对象等在存储时需要转换为字节流NSData类型数据，再通过写入文件来进行存储。

归档的作用

之前将数据存储到本地，只能是字符串、数组、字典、NSNuber、BOOL等容器类对象，不能将自定义对象进行保存，而通过归档能将所有的对象转化为二进制数据存储到文件中。

归档的缺点

归档保存数据，只能一次性归档保存以及一次性解压。所以只能针对小量数据，而且对数据操作比较笨拙，即如果想改动数据的某一小部分，还是需要解压整个数据或者归档整个数据。

归档的使用场景

1.有些应用支持一个离线缓存，也就是说当手机没联网时，可以将手机有网时的数据存放在本地，当手机没网时，从本地中取出来这些数据展示。

2.电商场景中，可以缓存用户搜索历史记录。

归档的三种方式

1.对Foundation框架的系统对象进行归档
2.对自定义的对象进行归档
3.同时对不同类型的多个对象进行归档

//将数据对象归档到指定目录

+ (BOOL)archiveRootObject:(id)rootObject toFile:(NSString *)path;

这个方法可以对基本数据类型进行归档，比如字符串，NSNumber，常用的是对NSArray、NSDictionary进行归档。返回值标志着是否归档成功，YES为成功，NO为失败。

//通过文件路径创建解归档对象

+ (nullable id)unarchiveObjectWithFile:(NSString *)path;

使用例子

归档

NSDictionary *personDict=@{@"name":@"xiaoBai",@"age":@"",@"sex":@"man"};

NSArray *array = @[@"数据1",@"数据2",@"数据3",@"数据4"];

//获取沙盒中Documents的路径

NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];

//设置对象归档的路径及归档文件名

NSString *dictPath =[docPath stringByAppendingPathComponent:@"person.archiver"];//后缀名可以随意命名

//将对象归档到指定路径

BOOL flag1 = [NSKeyedArchiver archiveRootObject:array toFile:dictPath];

NSString *arrayPath =[docPath stringByAppendingPathComponent:@"data.archiver"];

BOOL flag2 = [NSKeyedArchiver archiveRootObject:dic toFile:arrayPath];

反归档

//获取沙盒中Documents的路径

NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];

//设置对象归档的路径及归档文件名

NSString *dictPath =[docPath stringByAppendingPathComponent:@"person.archiver"];//后缀名可以随意命名

NSDictionary *dic = [NSKeyedUnarchiver unarchiveObjectWithFile:dictPath];

NSArray *array = [NSKeyedUnarchiver unarchiveObjectWithFile:arrayPath];

2.对自定义的对象进行归档

除了字典和数组等系统对象外，开发中往往需要自定义一些对象，如：定义一个person类。

person.h

#import <Foundation/Foundation.h>

// 归档自定义对象该对象必须实现nscoding 协议

@interface person : NSObject<NSCoding>

@property (nonatomic,copy) NSString *name;

@property (nonatomic,assign) NSInteger age;

@property (nonatomic,assign) double height;

@end

person.m

需要重写两个协议方法

-(void)encodeWithCoder:(NSCoder *)aCoder方法：
-(id)initWithCoder:(NSCoder *)aDecoder方法：

#import "person.h"

@implementation person

// 当将一个自定义对象保存到文件的时候就会调用该方法

// 在该方法中说明如何存储自定义对象的属性

// 也就说在该方法中说清楚存储自定义对象的哪些属性

-(void)encodeWithCoder:(NSCoder *)aCoder

{

         NSLog(@"调用了encodeWithCoder:方法");

         [aCoder encodeObject:self.name forKey:@"name"];

         [aCoder encodeInteger:self.age forKey:@"age"];

         [aCoder encodeDouble:self.height forKey:@"height"];

}

// 当从文件中读取一个对象的时候就会调用该方法

// 在该方法中说明如何读取保存在文件中的对象

// 也就是说在该方法中说清楚怎么读取文件中的对象

-(id)initWithCoder:(NSCoder *)aDecoder

{

     NSLog(@"调用了initWithCoder:方法");

     //注意：在构造方法中需要先初始化父类的方法

     if (self=[super init]) {

             self.name=[aDecoder decodeObjectForKey:@"name"];

             self.age=[aDecoder decodeIntegerForKey:@"age"];

             self.height=[aDecoder decodeDoubleForKey:@"height"];

         }

     return self;

 }

@end

对person对象进行归档

- (void)archiveObjectAction{

    person *xiaoBai = [[person alloc] init];

    xiaoBai.name = @"小白";

    xiaoBai.age = ;

    xiaoBai.height = ;

    // 获取文件路径

    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];

    NSString *path = [docPath stringByAppendingPathComponent:@"person.archiver"];

    // 保存自定义对象

    [NSKeyedArchiver archiveRootObject:xiaoBai toFile:path];

}

- (void)unarchiveOjectAction{

        // 获取文件路径

    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];

    NSString *path = [docPath stringByAppendingPathComponent:@"person.archiver"];

    person *personObj = [NSKeyedUnarchiver unarchiveObjectWithFile:path];

    NSLog(@"%@,%d,%.1fcm",personObj.name,personObj.age,personObj.height);

}

3.同时对不同类型的多个对象进行归档

方法介绍

//对多个对象进行归档（可以是不同类型的对象）

- (instancetype)initForWritingWithMutableData:(NSMutableData *)data;

归档：

// NSKeyedArchiver 可以对多种类型数据进行归档

CGPoint point = CGPointMake(, );

NSString *name = @"xiaoBai";

NSInteger age = ;

//获取沙盒中Documents的路径

NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];

//指定归档路径

NSString *path = [docPath stringByAppendingPathComponent:@"multiData.archiver"];

//实例化归档对象

NSMutableData *data = [[NSMutableData alloc] init];

NSKeyedArchiver *archvier = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];

//将对象进行编码（将数据对象转换为字节流数据）

[archvier encodeCGPoint:point forKey:@"point"];

[archvier encodeObject:name forKey:@"name"];

[archvier encodeInteger:age forKey:@"age"];

//结束编码

[archvier finishEncoding];

//将字节流写入指定路径的文件

[data writeToFile:path atomically:YES];

//获取沙盒中Documents的路径

NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];

//指定归档路径

NSString *path = [docPath stringByAppendingPathComponent:@"multiData.archiver"];

//实例化反归档对象

NSMutableData *data = [[NSMutableData alloc] initWithContentsOfFile:path];

NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];

//解码（将字节流转换为数据对象）

CGPoint pointR = [unarchiver decodeCGPointForKey:@"point"];

NSString *nameR = [unarchiver decodeObjectForKey:@"name"];

NSInteger ageR = [unarchiver decodeIntegerForKey:@"age"];

//结束解码

[unarchiver finishDecoding];

NSLog(@"%f,%f,%@,%d",pointR.x,pointR.y,nameR,ageR);

码农公寓