第十二章 归档
归档是指用某种格式来保存一个或多个对象,以便以后还原这些对象的过程。即包括将多个对象写入 文件,以便以后读回该对象。
两种归档的方法:属性列表和带键值的编码
若对象是 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
//-------------------------------------------------------------------------------------------------------------------
