Property List Programming Guide

Posted 2023-02-20 题材新颖

本篇是最基础的属性列表的教程，会很简单地讲一下属性列表的基本用法。在本篇中会涉及到一个小程序，当它加载的时候，会从 XML 属性列表中读取并将之转化为对象，然后把这些对象存在实例变量中。加载完毕之后程序会把数据显示在界面上，然后当用户退出程序的时候，会将修改后的属性保存为 XML。

创建属性列表

在 Xcode 中，创建一个简单的 Cocoa 应用项目，取名为 PropertyListExample。(OS X 应用) 然后选择项目的根文件夹，新建一个文件，在 Resource 中找到 Property List，取名为 Data.plist。

单击 Data.plist 后就可以编辑数据了：

当然，也可以打开编辑器界面，然后用文本格式来编辑 xml 文件。访问 plist 的时候，我们可以应用的 main bundle 中获取。

从属性列表中读取内容

在读取属性列表的时候，可以直接从用户的 Documents 目录下读取，也可以从应用的 main bundle 中获取。一旦我们获取到了属性列表，我们就可以将相应的元素转换成对象。

- (id) init 

    self = [super init];
    if (self) 
        NSString *errorDesc = nil;
        NSPropertyListFormat format;
        NSString *plistPath;
        NSString *rootPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
           NSUserDomainMask, YES) objectAtIndex:0];
        plistPath = [rootPath stringByAppendingPathComponent:@"Data.plist"];
        if (![[NSFileManager defaultManager] fileExistsAtPath:plistPath]) 
            plistPath = [[NSBundle mainBundle] pathForResource:@"Data" ofType:@"plist"];
        
        NSData *plistXML = [[NSFileManager defaultManager] contentsAtPath:plistPath];
        NSDictionary *temp = (NSDictionary *)[NSPropertyListSerialization
            propertyListFromData:plistXML
            mutabilityOption:NSPropertyListMutableContainersAndLeaves
            format:&format
            errorDescription:&errorDesc];
        if (!temp) 
            NSLog(@"Error reading plist: %@, format: %d", errorDesc, format);
        
        self.personName = [temp objectForKey:@"Name"];
        self.phoneNumbers = [NSMutableArray arrayWithArray:[temp objectForKey:@"Phones"]];

    
    return self;

上面的代码先获取了属性列表文件所在的路径，然后通过 NSFileManager 读取了属性列表中的内容，最后利用 propertyListFromData 将属性列表中的内容转换为对象。

将属性列表写入文件

文件的写入主要也是路径的获取，一旦获取成功，就可以直接写入：

 -(NSApplicationTerminateReply)applicationShouldTerminate:(NSApplication *)sender 
    NSString *error;
    NSString *rootPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
    NSString *plistPath = [rootPath stringByAppendingPathComponent:@"Data.plist"];
    NSDictionary *plistDict = [NSDictionary dictionaryWithObjects:
            [NSArray arrayWithObjects: personName, phoneNumbers, nil]
            forKeys:[NSArray arrayWithObjects: @"Name", @"Phones", nil]];
    NSData *plistData = [NSPropertyListSerialization dataFromPropertyList:plistDict
                            format:NSPropertyListXMLFormat_v1_0
                            errorDescription:&error];
    if(plistData) 
        [plistData writeToFile:plistPath atomically:YES];
    
    else 
        NSLog(error);
        [error release];
    
    return NSTerminateNow;