第十二章 归档

第十二章 归档

归档是指用某种格式来保存一个或多个对象,以便以后还原这些对象的过程。即包括将多个对象写入 文件,以便以后读回该对象。

  两种归档的方法:属性列表和带键值的编码

若对象是 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> int main(int argc ,char *argv[])
{

NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init ]; NSDictionary *glossary1 =

[NSDictionary. dictionaryWithObjectsAndKeys:
@"A class defined so other classes can inhert",@"abstract @"Toimplement all the method defined in a protocol",@"adopt", @"Storing an object for later use",@"archiving",

nil ];

if ([glossary writeToFile: @"glossary "atomically : YES] == NO) NSLog(@"Save to file failed !");

NSDictionary *glossary2 = [NSDictionary dictionaryWithContentOfFile:"glossary"]; for (NSString *key in glossary2)

NSLog(@"%@:%@",key,[glossaryobjectForKey:key]); [pool drain] ;
return 0 ;

} //*****************************************************************************

glossary 文件里保存的数据格式是<key>...</key> <string>...</string>

要读回数据使用 dataWithContentOfFile:方法
要读回字符串对象使用 stringWithContentOfFile:方法 要读回根据字典创建的属性列表使用 dictionaryWithContentOfFile:方法或者

arrayWithContentOfFile:方法 注:属性列表可以来自任何的源,可以来自文本编辑器或者Property List Editor 程序来

class",

创建的属性列表。 NSKeyedArchiver 类

使用 NSKeyedArchiver 类创建带键的档案,在带键的档案中,每个归档的字段都有一个名称。归档某 个对象的时候,会为他提供一个名称,即键。从归档中检索该对象的时候,是根据这个键来检索它的。这 样,可以按照任意的顺序将对象写入归档并进行检索。另外,如果向类添加了新的实例变量或删除了实例 变量,程序也可以进行处理。

NSKeyedArchiver 类中的 archiveRootObject:toFile:方法将数据对象存储到磁盘上。 例如:
NSDictionary *glossary = [...];
[NSKeyedArchiver archiveRootObject:glossary toFile:@"file"];

通过 NSKeyedUnarchiver 类中的 unArchiveObjectWithFile:方法将创建的归档文件读入执行的程序中。 例如:
NSDictionary *glossary = [NSKeyedUnarchiver unArchiveObjectWithFile:@“file”] //将指定的文件打开并读取文件的内容。该文件必须是前面归档操作的结果。可以为文件指定完整路径名 或相对路径名。

编码方法和解码方法:

按照<NSCoding>协议,在类定义中添加编码方法 encodeWithCoder:方法和解码方法 initWithCoder: 方法实现的。

对于基本 objective-C 类(NSString、NSArray、NSDictionary、NSSet、NSDate、NSNumber、NSData) 使用 encodeObject:forKey:编码方法和 decodeObjectt: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:

若要确保继承的实例变量也被编码:

[super encodeWithCoder:encoder];

若要确保继承的实例变量也被解码:

[super initWithCoder:encoder]; encodeObject:forKey:方法可以用于任何在其类中实现对encodeWithCoder:方法的对象。同样

decodeObject:forKey:方法传递在编码时用的相同的键,就可以解码每个实例。 注:

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

forKey:归档它,反向使用 decodeInt:forKey:可以恢复它,最后将其赋值给 short int 的数据。 示例:
//*****************************************************************************
# import<Foundation/NSObject.h>

# import<Foundation/NSString.h>
# import<Foundation/NSKeyedArchiver.h>
@interface AddressCard:NSObject<NSCoding,NSCopying> {

NSString *name;

NSString *email; }

@property (copy,nonatomic)NSString *name,*email ; -(void)setName:(NSString *)theName andEmail:(NSString *)theEmail; ...
@end

//下面是添加到其中的编码和解码的方法 -(void)encodeWithCoder: (NSCoder*)encoder {

[encoder encodeObject:name forKey:@"AddressCardName"];

[encoder encodeObject:email forKey:@"AddressCardEmail"]; }

-(id)initWithCoder: (NSCoder*)decoder {

name = [[decoder decodeObjectforKey:@"AddressCardName"]retain];

email = [[decoder decodeObjectforKey:@"AddressCardEmail"]retain]; }

//*****************************************************************************

使用 NSData 创建自定义档案:
NSMutableData *dataArea = [NSMutableData data]; NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc]

initForWritingWithMutableData:dataArea]; //以指定要写入归档数据的存储空间,即dataArea。此时就可以向archiver 发送编码消息,以归档程序中的

对象。所有编码消息在收到 finishEncoding 消息之前都被归档并存储在指定的数据空间中。
最后向 dataArea 发送 writeToFile:atomically:消息。请求它把它的数据写到指定的文件中(若文件名

为 file)
[dataArea writeToFile:@"file" atomically:YES];

相反若要从档案文件中恢复数据和归档工作相反:首先,分配一个数据空间。然后,把档案中的数据 读入该空间,接着创建一个 NSKeyedUnarchiver 对象,告知它从空间解码数据。必须调用解码方法来提取 和解码归档的对象,做完以后,向 NSKeyedUnarchiver 对象发送一条 finishEncoding 消息。

使用归档文件复制对象(深复制) :
使用 Foundation 的归档能力来创建对象的深复制。在归档和解归档的过程中产生的字符串的新副本。

需要生成一个对象(或不支持 NSCopying 协议的对象)的深复制时,记住使用这项技术。 例如:

实现复制

NSMutableArray *dataArray = [...];
NSMutableArray *dataArray2;
NSData *data = [NSKeyedArchiver archivedDataWithRootObject:dataArray]; dataArray2 = [NSKeyedUnarchiver unarchivedObjectWithData:data];

  甚至可以避免中间赋值即,

NSMutableArray *dataArray2 = [NSKeyedUnarchiver unarchivedObjectWithData: [NSKeyedArchiver archivedDataWithRootObject:dataArray]];

示例: //***************************************************************************** # import<Foundation/NSObject.h>
# import<Foundation/NSString.h>
# import<Foundation/NSArray.h>
# import<Foundation/NSAutoreleasePool.h>
# import<Foundation/NSKeyedArchiver.h>
int main(int argc ,char *argv[])
{

NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init ]; NSData *data ;
NSMutableArray *dataArray = [ NSMutableArray arrayWithObjects :

[ NSMutableArray stringWithString : @"one"] , [ NSMutableArray stringWithString : @"two"] , [ NSMutableArray stringWithString : @"three"] , nil

]; NSMutableArray *dataArray2 ;

NSMutableString *mStr ;
data = [NSKeyedArchiver archivedDataWithRootObject:dataArray]; dataArray2 = [NSKeyedUnarchiver unarchivedObjectWithData:data]; mStr = [dataArray2 objectAnIndex : 0] ;
[mStr appendString :@"ONE"] ;
NSLog(@"dataArray:");
for(NSString *elem in dataArray)

NSLog(@"%@",elem); NSLog(@"\ndataArray2:"); for(NSString *elem in dataArray2)

NSLog(@"%@",elem); [pool drain] ;
return 0;

} //***************************************************************************** 结果如下:

//------------------------------------------------------------------------------------------------------------------- dataArray:
one
two

three

dataArray2:
oneONE
two
Three //-------------------------------------------------------------------------------------------------------------------