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 = ;  

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

  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=;
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;
}
上一篇:iptables详解--转


下一篇:ios数据存储——对象归档