12 归档 [Objective-C基础教程]

归档是指用某种格式来保存一个或多个对象，以便以后还原这些对象的过程。即包括将多个对象写入
文件，以便以后读回该对象。
两种归档的方法：属性列表和带键值的编码
若对象是NSString、NSDictionary、NSArray、NSData、NSNumber对象时，可以使用writeToFile：
atomically：方法将数据写到文件中，是以属性列表的形式写到文件中的。
参数atomically为YES，表示先将数据写到临时备份文件中，一旦成功，再转移到文件中。
示例：
//*****************************************************************************
#import<Foundation/NSObject.h>
#import<Foundation/NSString.h>
#import<Foundation/NSDictionary.h>
#import<Foundation/NSAutoreleasePool.h>
intmain(intargc,char*argv[])
{
NSAutoreleasePool*pool=[[NSAutoreleasePoolalloc]init];
NSDictionary*glossary1=
[NSDictionary. dictionaryWithObjectsAndKeys:
@"Aclassdefinedsootherclassescaninhert",@"abstract class",
@"Toimplementallthemethoddefinedinaprotocol",@"adopt",
@"Storinganobjectforlateruse",@"archiving",
nil
];
if([glossarywriteToFile:@"glossary "atomically:YES]==NO)
NSLog(@"Savetofilefailed!");
NSDictionary*glossary2=[NSDictionarydictionaryWithContentOfFile:"glossary"];
for(NSString*keyinglossary2)
NSLog(@"%@:%@",key,[glossaryobjectForKey:key]);
[pooldrain];
return 0;
}

//*****************************************************************************
glossary文件里保存的数据格式是<key>...</key><string>...</string>
要读回数据使用dataWithContentOfFile：方法
要读回字符串对象使用stringWithContentOfFile：方法
要读回根据字典创建的属性列表使用dictionaryWithContentOfFile：方法或者
arrayWithContentOfFile：方法
注：属性列表可以来自任何的源，可以来自文本编辑器或者PropertyListEditor程序来创建的属性列表。

NSKeyedArchiver类
使用NSKeyedArchiver类创建带键的档案，在带键的档案中，每个归档的字段都有一个名称。归档某
个对象的时候，会为他提供一个名称，即键。从归档中检索该对象的时候，是根据这个键来检索它的。这
样，可以按照任意的顺序将对象写入归档并进行检索。另外，如果向类添加了新的实例变量或删除了实例
变量，程序也可以进行处理。
NSKeyedArchiver类中的archiveRootObject：toFile：方法将数据对象存储到磁盘上。
例如：
NSDictionary*glossary=[...];
[NSKeyedArchiverarchiveRootObject:glossarytoFile:@"file"];
通过NSKeyedUnarchiver类中的unArchiveObjectWithFile:方法将创建的归档文件读入执行的程序中。
例如：
NSDictionary*glossary=[NSKeyedUnarchiverunArchiveObjectWithFile:@“file”]
//将指定的文件打开并读取文件的内容。该文件必须是前面归档操作的结果。可以为文件指定完整路径名
或相对路径名。

编码方法和解码方法：
按照<NSCoding>协议，在类定义中添加编码方法encodeWithCoder：方法和解码方法initWithCoder：
方法实现的。
对于基本objective-C类（NSString、NSArray、NSDictionary、NSSet、NSDate、NSNumber、NSData）
使用encodeObject：forKey：编码方法和decodeObjectt：forKey：解码方法
若要确保继承的实例变量也被编码：
[superencodeWithCoder:encoder];
若要确保继承的实例变量也被解码：
[superinitWithCoder:encoder];
encodeObject：forKey：方法可以用于任何在其类中实现对encodeWithCoder：方法的对象。同样
decodeObject：forKey：方法传递在编码时用的相同的键，就可以解码每个实例。
在带键的档案中编码和解码基本数据类型
编码方法 解码方法
encodeBool：forKey： decodeBool：forKey：
encodeInt：forKey： decodeInt：forKey：
encodeInt32：forKey： decodeInt32：forKey
encodeInt64：forKey： decodeInt64：forKey：
encodeFloat：forKey： decodeFloat：forKey：
encodeDouble：forKey： decodeDouble：forKey：

注：
还有一些基本数据类型，如（char、short、long、longlong）在上表中没有列出，此时你必须确定数据
对象的大小并使用相应的例程。例如：要归档shortint的数据，首先将其保存在int中，然后使用encodeInt：

forKey：归档它，反向使用decodeInt：forKey：可以恢复它，最后将其赋值给shortint的数据。
示例:
//*****************************************************************************
#import<Foundation/NSObject.h>
#import<Foundation/NSString.h>
#import<Foundation/NSKeyedArchiver.h>
@interfaceAddressCard：NSObject<NSCoding,NSCopying>
{
NSString*name;
NSString*email;
}
@property(copy,nonatomic)NSString*name,*email;
-(void)setName:(NSString*)theNameandEmail:(NSString*)theEmail;
...
@end
//下面是添加到其中的编码和解码的方法
-（void）encodeWithCoder：（NSCoder*）encoder
{
[encoder encodeObject:nameforKey:@"AddressCardName"];
[encoder encodeObject:emailforKey:@"AddressCardEmail"];
}
-（id）initWithCoder：（NSCoder*）decoder
{
name=[[decoder decodeObjectforKey:@"AddressCardName"]retain];
email=[[decoder decodeObjectforKey:@"AddressCardEmail"]retain];
}
//*****************************************************************************

使用NSData创建自定义档案：
NSMutableData*dataArea=[NSMutableDatadata];
NSKeyedArchiver*archiver=[[NSKeyedArchiveralloc]
initForWritingWithMutableData：dataArea];
//以指定要写入归档数据的存储空间，即dataArea。此时就可以向archiver发送编码消息，以归档程序中的
对象。所有编码消息在收到finishEncoding消息之前都被归档并存储在指定的数据空间中。
最后向dataArea发送writeToFile：atomically：消息。请求它把它的数据写到指定的文件中（若文件名
为file）
[dataAreawriteToFile：@"file"atomically：YES];
相反若要从档案文件中恢复数据和归档工作相反：首先，分配一个数据空间。然后，把档案中的数据
读入该空间，接着创建一个NSKeyedUnarchiver对象，告知它从空间解码数据。必须调用解码方法来提取
和解码归档的对象，做完以后，向NSKeyedUnarchiver对象发送一条finishEncoding消息。
使用归档文件复制对象（深复制）：
使用Foundation的归档能力来创建对象的深复制。在归档和解归档的过程中产生的字符串的新副本。

需要生成一个对象（或不支持NSCopying协议的对象）的深复制时，记住使用这项技术。
例如：
实现复制
NSMutableArray*dataArray=[...];
NSMutableArray*dataArray2;
NSData*data=[NSKeyedArchiverarchivedDataWithRootObject:dataArray];
dataArray2= [NSKeyedUnarchiverunarchivedObjectWithData:data];
甚至可以避免中间赋值即，
NSMutableArray*dataArray2= [NSKeyedUnarchiverunarchivedObjectWithData:
[NSKeyedArchiverarchivedDataWithRootObject:dataArray]];
示例:

//*****************************************************************************
#import<Foundation/NSObject.h>
#import<Foundation/NSString.h>
#import<Foundation/NSArray.h>
#import<Foundation/NSAutoreleasePool.h>
#import<Foundation/NSKeyedArchiver.h>
intmain(intargc,char*argv[])
{
NSAutoreleasePool*pool=[[NSAutoreleasePoolalloc]init];
NSData*data;
NSMutableArray*dataArray=[NSMutableArrayarrayWithObjects:
[NSMutableArraystringWithString:@"one"],
[NSMutableArraystringWithString:@"two"],
[NSMutableArraystringWithString:@"three"],
nil
];
NSMutableArray*dataArray2;
NSMutableString*mStr;
data=[NSKeyedArchiverarchivedDataWithRootObject:dataArray];
dataArray2=[NSKeyedUnarchiverunarchivedObjectWithData:data];
mStr=[dataArray2objectAnIndex:0];
[mStrappendString:@"ONE"];
NSLog(@"dataArray:");
for(NSString*elemindataArray)
NSLog(@"%@",elem);
NSLog(@"\ndataArray2:");
for(NSString*elemindataArray2)
NSLog(@"%@",elem);
[pooldrain];
return0;
}
//*****************************************************************************

结果如下：

//-------------------------------------------------------------------------------------------------------------------
dataArray：
one
two
three
dataArray2：
oneONE
two
Three
//-------------------------------------------------------------------------------------------------------------------