归档的作用
之前将数据存储到本地,只能是字符串、数组、字典、NSNuber、BOOL等容器类对象,不能将自定义对象进行保存,而通过归档能将所有的对象转化为二进制数据存储到文件中。
什么是归档
当遇到有结构有组织的数据时,比如字典,数组,自定义的对象等在存储时需要转换为字节流NSData类型数据,再通过写入文件来进行存储。
什么是反归档
字节流转换为字典,数组,自定义的类等
归档的缺点
归档保存数据,只能一次性归档保存以及一次性解压。所以只能针对小量数据,而且对数据操作比较笨拙,即如果想改动数据的某一小部分,还是需要解压整个数据或者归档整个数据。
归档的使用场景
1.有些应用支持一个离线缓存,也就是说当手机没联网时,可以将手机有网时的数据存放在本地,当手机没网时,从本地中取出来这些数据展示。
2.电商场景中,可以缓存用户搜索历史记录。
归档的三种方式
1.对Foundation框架的系统对象进行归档
2.对自定义的对象进行归档
3.同时对不同类型的多个对象进行归档
注意:所以使用归档和反归档的对象都必须遵循NSCoding协议
1.对Foundation框架的系统对象进行归档
方法介绍
//将数据对象归档到指定目录
+ (BOOL)archiveRootObject:(id)rootObject toFile:(NSString *)path;
这个方法可以对基本数据类型进行归档,比如字符串,NSNumber,常用的是对NSArray、NSDictionary进行归档。返回值标志着是否归档成功,YES为成功,NO为失败。
//通过文件路径创建解归档对象
+ (nullable id)unarchiveObjectWithFile:(NSString *)path;
使用例子:
归档:
NSDictionary *personDict=@{@"name":@"xiaoBai",@"age":@"25",@"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 = 25;
xiaoBai.height = 180;
// 获取文件路径
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(10, 20);
NSString *name = @"xiaoBai";
NSInteger age = 25;
//获取沙盒中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);