iOS archive（归档）

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

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

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

归档：

1. NSString *homeDictionary = NSHomeDirectory();//获取根目录
2. NSString *homePath  = [homeDictionary stringByAppendingPathComponent:@"atany.archiver"];//添加储存的文件名
3. BOOL flag = [NSKeyedArchiver archiveRootObject:@”归档” toFile:homePath];//归档一个字符串

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

接档：

1. [NSKeyedUnarchiver unarchiveObjectWithFile:homePath]

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

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

二、对多个对象的归档

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

归档：写入数据

1. //准备数据
2. CGPoint point = CGPointMake(1.0, 2.0);
3. NSString *info = @"坐标原点";
4. NSInteger value = 10;
5. NSString *multiHomePath = [NSHomeDirectory() stringByAppendingPathComponent:@"multi.archiver"];
6. NSMutableData *data = [[NSMutableData alloc]init];
7. NSKeyedArchiver *archvier = [[NSKeyedArchiver alloc]initForWritingWithMutableData:data];
8. //对多个对象进行归档
9. [archvier encodeCGPoint:point forKey:@"kPoint"];
10. [archvier encodeObject:info forKey:@"kInfo"];
11. [archvier encodeInteger:value forKey:@"kValue"];
12. [archvier finishEncoding];
13. [data writeToFile:multiHomePath atomically:YES];

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

1. NSMutableData *dataR = [[NSMutableData alloc]initWithContentsOfFile:multiHomePath];
2. NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc]initForReadingWithData:dateR];
3. CGPoint pointR = [unarchiver decodeCGPointForKey:@"kPoint"];
4. NSString *infoR = [unarchiver decodeObjectForKey:@"kInfo"];
5. NSInteger valueR = [unarchiver decodeIntegerForKey:@"kValue"];
6. [unarchiver finishDecoding];
7. NSLog(@"%f,%f,%@,%d",pointR.x,pointR.y,infoR,valueR);

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

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

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

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

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

Archive.h

1. #import <Foundation/Foundation.h>
2. @interface Archive : NSObject
3. @property (copy,nonatomic) NSString *name;
4. @property NSInteger age;
5. @property (copy,nonatomic) NSString *address;
6. @property (copy,nonatomic) UIImage *photo;
7. @end

Archive.m

1. #import "Archive.h"
2. #define kNameKey @"NameKey"
3. #define kAgeKey @"AgeKey"
4. #define kAddress @"AddressKey"
5. #define kPhotoKey @"PhotoKey"
6. @implementation Archive
7. @synthesize name = _name;
8. @synthesize age = _age;
9. @synthesize address = _address;
10. @synthesize photo = _photo;
11. #pragma mark - NSCoding
12. - (void)encodeWithCoder:(NSCoder *)aCoder {
13. [aCoder encodeObject:_name forKey:kNameKey];
14. [aCoder encodeInteger:_age forKey:kAgeKey];
15. [aCoder encodeObject:_address forKey:kAddress];
16. [aCoder encodeObject:_photo forKey:kPhotoKey];
17. }
18. - (id)initWithCoder:(NSCoder *)aDecoder {
19. if (self = [super init]) {
20. _name = [aDecoder decodeObjectForKey:kNameKey];
21. _age = [aDecoder decodeIntegerForKey:kAgeKey];
22. _address = [aDecoder decodeObjectForKey:kAddress];
23. _photo = [aDecoder decodeObjectForKey:kPhotoKey];
24. }
25. return self;
26. }
27. #pragma mark - NSCoping
28. - (id)copyWithZone:(NSZone *)zone {
29. Archive *copy = [[[self class] allocWithZone:zone] init];
30. copy.name = [self.name copyWithZone:zone];
31. copy.age = self.age;
32. copy.address = [self.address copyWithZone:zone];
33. copy.photo = self.photo;
34. return copy;
35. }
36. @end

Archive类有四个字段（名字、年纪、地址、头像），除了年纪为整型之外，其他的都看作Object。

【注】：要将一个自定义的类进行归档，那么类里面的每个属性都必须是可以被归档的，如果是不能归档的类型，我们可以把他转化为NSValue进行归档，然后在读出来的时候在转化为相应的类。

Archive实现了三个委托方法1）encodeWithCoder: 2）initWithCoder:  3）copyWithZone:

1)encodeWithCoder

Encodes the receiverusing a given archiver

通过一个给定的archiver把消息接收者进行编码。

当接收到encodeObject消息的时候，类终端encodeWithCoder方法被调用。

2)initWithCoder

Returns an objectinitialized from data in a given unarchiver. (required)

从一个给定unarchiver的数据中返回一个初始化对象。

3）copyWithZone

Returnsa new instance that’s a copy of the receiver

返回消息接收者的一个复制的新实例。

SDK的概念就是这样，下面看看这个自定义类归档的具体代码，其实和多个对象的归档是一样的。。。

归档：

1. //保存图片与归档
2. - (IBAction)save:(id)sender {
3. //准备数据
4. NSString *name = @"小杨在玩iOS";
5. NSInteger age = 22;
6. NSString *address = @"你猜我在哪~";
7. UIImage *photo = [UIImage imageNamed:@"loginman.jpg"];
8. //存储数据到类
9. Archive *archivingData = [[Archive alloc] init];
10. archivingData.name = name;
11. archivingData.age = age;
12. archivingData.address = address;
13. archivingData.photo = photo;
14. //归档
15. NSMutableData *data = [[NSMutableData alloc] init];
16. NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
17. [archiver encodeObject:archivingData forKey:kArchivingDataKey]; // archivingDate的encodeWithCoder
18. 方法被调用
19. [archiver finishEncoding];
20. //写入文件
21. [data writeToFile:self.archivingFilePath atomically:YES];
22. }

接档：

1. - (IBAction)loadArchive:(id)sender {
2. NSData *data = [[NSMutableData alloc] initWithContentsOfFile:self.archivingFilePath];
3. NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
4. //获得类
5. Archive *archivingData = [unarchiver decodeObjectForKey:kArchivingDataKey];// initWithCoder方法被调用
6. [unarchiver finishDecoding];
7. //读取的数据
8. NSString *name = archivingData.name;
9. NSInteger age = archivingData.age;
10. NSString *address = archivingData.address;
11. self.imageView.image = archivingData.photo;
12. NSLog(@"%@||%d||%@",name,age,address);
13. }

我们save之后loadArchive一次

打出结果为：

2013-11-04 19:29:41.743TestArchives[16708:c07]小杨在玩iOS||22||你猜我在哪~

获取成功。