iOS数据持久化存储之归档NSKeyedArchiver

归档是一种很常用的文件储存方法，几乎任何类型的对象都能够被归档储存（实际上是一种文件保存的形式），收集了网上的一些资料并结合自己的一些经验，总结如下。

一、使用archiveRootObject进行简单的归档

使用NSKeyedArichiver进行归档、NSKeyedUnarchiver进行接档，这种方式会在写入、读出数据之前对数据进行序列化、反序列化操作。

归档：

　　 //1.获取文件路径　　

　　NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0]; 　　

　　//2、添加储存的文件名

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

　　//3、将一个对象保存到文件中

　　BOOL flag = [NSKeyedArchiver archiveRootObject:@”归档” toFile:path]; 　　

这种方式可以对字符串、数字等进行归档，当然也可以对NSArray与NSDictionary进行归档。返回值Flag标志着是否归档成功，YES为成功，NO为失败。

接档：

　　

　　//1.获取文件路径

　　NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];

　　NSString *path=[docPath stringByAppendingPathComponent:@"person.yangyang"]; NSLog(@"path=%@",path);

　　//2.从文件中读取对象

　　[NSKeyedUnarchiver unarchiveObjectWithFile:path]

使用NSKeyedUnarchiver进行接档（反序列化）。

这种归档的方式存在一个缺点：只能把一个对象归档进一个文件中，那么怎么对多个对象进行归档呢？

二、对多个对象的归档

同样是使用NSKeyedArchiver进行归档，不同的是同时归档多个对象，这里我们举例放入了一个CGPoint点、字符串、整数（当然很多类型都可以的，例如UIImage、float等等），使用encodeXXX方法进行归档，最后通过writeToFile方法写入文件。

归档：写入数据

　　//准备数据

　　CGPoint point = CGPointMake(1.0, 2.0);

　　NSString *info = @"坐标原点";

　　NSInteger value = 10;

　　NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];

　　NSString *multiHomePath = [docPath stringByAppendingPathComponent:@"multi.archiver"];

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

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

　　//对多个对象进行归档

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

　　[archvier encodeObject:info forKey:@"kInfo"];

　　[archvier encodeInteger:value forKey:@"kValue"];

　　[archvier finishEncoding];

　　[data writeToFile:multiHomePath atomically:YES];

接档：从路径中获得数据构造NSKeyedUnarchiver实例，使用decodeXXXForKey方法获得文件中的对象。

　　NSMutableData *dataR = [[NSMutableData alloc] initWithContentsOfFile:multiHomePath];

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

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

　　NSString *infoR = [unarchiver decodeObjectForKey:@"kInfo"];

　　NSInteger valueR = [unarchiver decodeIntegerForKey:@"kValue"];

　　[unarchiver finishDecoding];

　　NSLog(@"%f,%f,%@,%d",pointR.x,pointR.y,infoR,valueR);

可以看出对多个对象进行归档还是挺方便的，这里又出现一个问题，这里的对象都是基本类型数据，那么怎么对自己定义类生成的实例对象进行归档呢？

三、对自定义对象进行归档

自定义对象，应用范围很广，因为它对应着MVC中的Model层，即实体类。在程序中，我们会在Model层定义很多的entity，例如User，Teacher。。

那么对自定义对象的归档显得重要的多，因为很多情况下我们需要在Home键之后保存数据，在程序恢复时重新加载，那么，归档便是一个好的选择。

首先我们需要，自定义一个实体类。

//  YYViewController.m

#import "YYViewController.h"
#import "YYPerson.h"

@interface YYViewController ()
- (IBAction)saveBtnOnclick:(id)sender;
- (IBAction)readBtnOnclick:(id)sender;

@end

@implementation YYViewController

- (void)viewDidLoad
{
[super viewDidLoad];
}

- (IBAction)saveBtnOnclick:(id)sender {
//1.创建对象
YYPerson *p=[[YYPerson alloc]init];
p.name=@"圆圆";
p.age=23;
p.height=1.7;

//2.获取文件路径
NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];
NSString *path=[docPath stringByAppendingPathComponent:@"person.yangyang"];
NSLog(@"path=%@",path);

//3.将自定义的对象保存到文件中
[NSKeyedArchiver archiveRootObject:p toFile:path];

}

- (IBAction)readBtnOnclick:(id)sender {
//1.获取文件路径
NSString *docPath=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];
NSString *path=[docPath stringByAppendingPathComponent:@"person.yangyang"];
NSLog(@"path=%@",path);

//2.从文件中读取对象
YYPerson *p=[NSKeyedUnarchiver unarchiveObjectWithFile:path];
NSLog(@"%@,%d,%.1f",p.name,p.age,p.height);
}
@end

//  YYPerson.h

#import <Foundation/Foundation.h>

// 如果想将一个自定义对象保存到文件中必须实现NSCoding协议
@interface YYPerson : NSObject<NSCoding>

//姓名
@property(nonatomic,copy)NSString *name;
//年龄
@property(nonatomic,assign)int age;
//身高
@property(nonatomic,assign)double height;
@end

//  YYPerson.m

#import "YYPerson.h"

@implementation YYPerson

// 当将一个自定义对象保存到文件的时候就会调用该方法
// 在该方法中说明如何存储自定义对象的属性
// 也就说在该方法中说清楚存储自定义对象的哪些属性
-(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

基于归档创建一个用于本地数据存储的类如下：

#import <Foundation/Foundation.h>

@interface LocalArchiverManager : NSObject

/**单例模式，获取请求管理类
*\param        param:   无
*\returns      return:     无
*/
+ (LocalArchiverManager *)shareManagement;

/**清除本地的序列化的文件
*\param        param:   无
*\returns      return:     无
*/
- (void)clearArchiverData;

/**保存缓存数据
*\param        obj:   数据源
*\param        key:     接口的名称
*\returns      无
*/
- (void)saveDataArchiver:(id)obj andAPIKey:(NSString *)key;

/**回去缓存数据
*\param        obj:   api的key
*\returns      id:     返回的数据源
*/
- (id)archiverQueryAPIKey:(NSString *)key;
@end

LocalArchiverManager.m 文件

#import "LocalArchiverManager.h"

static LocalArchiverManager *m_localArchiverMana;
#define Document [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0]
#define ArchiverFile    [Document stringByAppendingPathComponent:@"Archiver"]

@interface LocalArchiverManager()

@property(nonatomic,retain)NSFileManager *fileManager;

@end

@implementation LocalArchiverManager+ (LocalArchiverManager *)shareManagement
{
static dispatch_once_t onceTocken;
dispatch_once(&onceTocken, ^
{
m_localArchiverMana = [[LocalArchiverManager alloc] init];
});
return m_localArchiverMana;
}

- (id)init
{
self = [super init];
if(self)
{
self.fileManager = [NSFileManager defaultManager];
}
return self;
}

#pragma mark private methods

- (BOOL)checkPathIsExist:(NSString *)path
{
return [_fileManager fileExistsAtPath:path isDirectory:nil];
}

- (void)createArchiverFile
{
if (![self checkPathIsExist:ArchiverFile])
{
[self addNewFolder:ArchiverFile];
}
}

//新建目录,path为目录路径(包含目录名)
- (void)addNewFolder:(NSString *)path
{
[_fileManager createDirectoryAtPath:path
withIntermediateDirectories:YES
attributes:nil
error:nil];
}

#pragma mark -
#pragma mark public methods

- (void)clearArchiverData
{
NSError *error;
if([m_fileManager removeItemAtPath:ArchiverFile error:&error])
{

}else{
DLOG(@"清除本地序列化的文件失败....:%@",error);
}
}

- (void)saveDataArchiver:(id)obj andAPIKey:(NSString *)key
{
NSMutableData *data = [[NSMutableData alloc] init];
NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
[archiver encodeObject:obj forKey:key];
[archiver finishEncoding];
[self createArchiverFile];
key = [key stringByReplacingOccurrencesOfString:@"/" withString:@"_"];
NSString *path = [ArchiverFile stringByAppendingPathComponent:[NSString stringWithFormat:@"%@.text",key]];　　　
　BOOL isSuc = [data writeToFile:path atomically:YES];
if(!isSuc) {
DLOG(@"本地序列化失败key....:%@",key);
}
}
- (id)archiverQueryAPIKey:(NSString *)key
{
NSString *str = [key stringByReplacingOccurrencesOfString:@"/" withString:@"_"];
NSString *path = [ArchiverFile stringByAppendingPathComponent:[NSString stringWithFormat:@"%@.text",str]];
NSMutableData *data = [[NSMutableData alloc] initWithContentsOfFile:path];
NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
id content = [unarchiver decodeObjectForKey:key];
[unarchiver finishDecoding];
DLOG(@"content.....:%@",content);
return content;
}