数据归档与恢复 NSKeyedArchiver

归档与恢复归档

归档，英文Archiver[‘ɑrkɪvə]，这里指的是将OC的对象存储为一个文件或者网络上的一个数据块。 
恢复归档，英文UnArchiver，指的是将一个来自文件或网络的归档数据块恢复成内存中的一个OC对象。 
归档和恢复主要用于对自定义类型对象进行存储，在程序暂停或关闭前保存自定义数据，在程序重新恢复状态或启动后读取存储的自定义数据。 
支持归档和恢复的类必须实现NSCoding协议，再由NSKeyedArchiver和NSKeyedUnarchiver类进行转换，将对象转换为数据流 
其它语言，如java/.net 将此技术称为序列化。

归档集合类型

IOS 很多内置类型都默认实现了归档功能，如NSNumber,NSArray,NSDictionary,NSString,NSData等。
定义NSArray或NSDicitionary类型，初始化数据后，调用NSKeyedArchiver 类的archiveRootObject 传入file路径，即可将当前NSArray对象完好的保存到文件系统中。
读取归档数据，使用NSKeydUnarchiver类unarchiveObjectWithFile方法可以直接从文件读回数据，并返回NSArray对象
NSKeyedArchiver和NSKeyedUnarchiver类都是将对象属性和值以key|value的方式顺序存储和读取的。

很多时候我们需要归档和恢复自定义对象，因此需要让自定义对象实现归档功能 
实现归档只需要遵循（实现）NSCoding协议或是NSCoding的子协议。

NSKeyedArchiver

如果对象是NSString、NSDictionary、NSArray、NSData、NSNumber等类型，可以直接用NSKeyedArchiver进行归档和恢复 
不是所有的对象都可以直接用这种方法进行归档，只有遵守了NSCoding协议的对象才可以 
NSCoding协议有2个方法： 
encodeWithCoder: 
每次归档对象时，都会调用这个方法。一般在这个方法里面指定如何归档对象中的每个实例变量，可以使用encodeObject:forKey:方法归档实例变量 
initWithCoder: 
每次从文件中恢复(解码)对象时，都会调用这个方法。一般在这个方法里面指定如何解码文件中的数据为对象的实例变量，可以使用decodeObject:forKey方法解码实例变量

有时需要将多个对象归档到一个文件，此时我们需要使用NSMutableData作为缓冲存储对象。 
先将对象归档到NSData中，再将NSData写入到文件中。

NSKeyedArchiver-归档NSArray

归档一个NSArray对象到Documents/array.archive
NSArray *array = [NSArray arrayWithObjects:@”a”,@”b”,nil];
[NSKeyedArchiver archiveRootObject:array toFile:path];

恢复(解码)NSArray对象
NSArray *array = [NSKeyedUnarchiver unarchiveObjectWithFile:path]

NSKeyedArchiver-归档Person对象（Person.h）

@interface Person : NSObject<NSCoding>
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) int age;
@property (nonatomic, assign) float height;
@end

NSKeyedArchiver-归档Person对象（Person.m）

@implementation Person
- (void)encodeWithCoder:(NSCoder *)encoder {
    [encoder encodeObject:self.name forKey:@"name"];
    [encoder encodeInt:self.age forKey:@"age"];
    [encoder encodeFloat:self.height forKey:@"height"];
}
- (id)initWithCoder:(NSCoder *)decoder {
    self.name = [decoder decodeObjectForKey:@"name"];
    self.age = [decoder decodeIntForKey:@"age"];
    self.height = [decoder decodeFloatForKey:@"height"];
    return self;
}
- (void)dealloc {
    [super dealloc];
    [_name release];
}
@end

NSKeyedArchiver-归档Person对象（编码和解码）

//归档(编码)
Person *person = [[[Person alloc] init] autorelease];
person.name = @"wangzhaolu";
person.age = 26;
person.height = 1.78f;
[NSKeyedArchiver archiveRootObject:person toFile:path];
//恢复(解码)
Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path];

NSKeyedArchiver-归档对象的注意

如果父类也遵守了NSCoding协议，请注意：
应该在encodeWithCoder:方法中加上一句
[super encodeWithCode:encode];
确保继承的实例变量也能被编码，即也能被归档
应该在initWithCoder:方法中加上一句
self = [super initWithCoder:decoder];
确保继承的实例变量也能被解码，即也能被恢复

NSData

使用archiveRootObject:toFile:方法可以将一个对象直接写入到一个文件中，但有时候可能想将多个对象写入到同一个文件中，那么就要使用NSData来进行归档对象 
NSData可以为一些数据提供临时存储空间，以便随后写入文件，或者存放从磁盘读取的文件内容。可以使用[NSMutableData data]创建可变数据空间 

NSData-归档2个Person对象到同一文件中

//归档（编码）
// 新建一块可变数据区
NSMutableData *data = [NSMutableData data];
// 将数据区连接到一个NSKeyedArchiver对象
NSKeyedArchiver *archiver = [[[NSKeyedArchiver alloc] initForWritingWithMutableData:data] autorelease];
// 开始存档对象，存档的数据都会存储到NSMutableData中
[archiver encodeObject:person1 forKey:@"person1"];
[archiver encodeObject:person2 forKey:@"person2"];
// 存档完毕(一定要调用这个方法)
[archiver finishEncoding];
// 将存档的数据写入文件
[data writeToFile:path atomically:YES];

NSData-从同一文件中恢复2个Person对象

恢复（解码）
// 从文件中读取数据
NSData *data = [NSData dataWithContentsOfFile:path];
// 根据数据，解析成一个NSKeyedUnarchiver对象
NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
Person *person1 = [unarchiver decodeObjectForKey:@"person1"];
Person *person2 = [unarchiver decodeObjectForKey:@"person2"];
// 恢复完毕
[unarchiver finishDecoding];

归档的封装

#import <Foundation/Foundation.h>
@interface NSObject (Addition)


+(BOOL)keyedArchiver:(id)obj key:(NSString *)key;

+(BOOL)keyedArchiver:(id)obj key:(NSString *)key path:(NSString *)path;

+(id)keyedUnarchiver:(NSString *)key;

+(id)keyedUnarchiver:(NSString *)key path:(NSString *)path;

@end

#define DefaultKeyedArchiverPath [NSString stringWithFormat:@"%@/Documents/DefaultKeyedArchiver.data", NSHomeDirectory()]

@implementation NSObject (Addition)

/**
 *  归档
 *
 *  @param obj 需要归档的类
 *  @param key 归档key
 *
 *  @return YES表示成功，NO表示失败
 */
+(BOOL)keyedArchiver:(id)obj key:(NSString *)key
{
    return [self keyedArchiver:obj key:key path:DefaultKeyedArchiverPath];
}

/**
 *  归档
 *
 *  @param obj  需要归档的类
 *  @param key  归档key
 *  @param path 归档路劲
 *
 *  @return YES表示归档成功，NO表示归档失败
 */
+(BOOL)keyedArchiver:(id)obj key:(NSString *)key path:(NSString *)path
{
    NSMutableData *tpData = [NSMutableData data];
    NSKeyedArchiver *keyedArchiver = [[NSKeyedArchiver alloc]initForWritingWithMutableData:tpData];
    [keyedArchiver encodeObject:obj forKey:key];
    [keyedArchiver finishEncoding];
    return [tpData writeToFile:path atomically:YES];
}

/**
 *  解档
 *
 *  @param key key
 *
 *  @return 解析的结果
 */
+(id)keyedUnarchiver:(NSString *)key
{
    return [self keyedUnarchiver:key path:DefaultKeyedArchiverPath];
}

/**
 *  解档
 *
 *  @param key  解挡key
 *  @param path 解挡路径
 *
 *  @return 解析的结果
 */
+(id)keyedUnarchiver:(NSString *)key path:(NSString *)path
{
    NSMutableData *tpData = [NSMutableData dataWithContentsOfFile:path];
    NSKeyedUnarchiver *keyedUnarchiver = [[NSKeyedUnarchiver alloc]initForReadingWithData:tpData];
    return [keyedUnarchiver decodeObjectForKey:key];
}

@end