iOS - OC PList 数据存储

前言

• 直接将数据写在代码里面，不是一种合理的做法。如果数据经常改，就要经常翻开对应的代码进行修改，造成代码扩展性低。因此，可以考虑将经常变的数据放在文件中进行存储，程序启动后从文件中读取最新的数据。如果要变动数据，直接修改数据文件即可，不用修改代码。一般可以使用属性列表文件存储 NSArray 或者 NSDictionary 之类的数据，这种 “属性列表文件” 的扩展名是 plist，因此也称为 “plist 文件”。 plist 是以 xml 文件形式存储的。

• 如果对象是 NSString、NSArray、NSDictionary、NSData 和 NSNumber 类型，可以用这些类中实现的 writeToFile: atomically: 方法将数据写到文件中。

• 当根据字典创建属性列表时，字典中的键必须都是 NSString 对象。数组中的元素或字典中的值可以是 NSString、NSArray、NSDictionary、NSData、NSDate 和 NSNumber 对象。

• iOS 实现的序列化方式的两种：NSKeyedArchiver，NSPropertyListSerialization。在这两种序列化方式中，NSData 都是序列化的目标。两种方式的不同点在于 NSPropertyListSerialization 是针对数组和字典类型的，而 NSKeyedArchiver 是针对对象的。

1、Write 写入方式

• 永久保存在磁盘中。具体方法为：

  • 第一步：获得文件即将保存的路径：

    • 使用 C 函数 NSSearchPathForDirectoriesInDomains 来获得沙盒中目录的全路径。该函数有三个参数，目录类型、domain mask、布尔值。其中布尔值表示是否需要通过 ～ 扩展路径。而且第一个参数是不变的，即为 NSSearchPathDirectory 。在 iOS 中后两个参数也是不变的，即为：NSUserDomainMask 和 YES。

      	NSString *documentPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];
      

    • 还有一种方法是使用 NSHomeDirectory 函数获得 sandbox 的路径，但是不能在 sandbox 的本文件层上写文件也不能创建目录，而应该是此基础上创建一个新的可写的目录，例如 Documents, Library 或者 temp 。具体的用法为：

      	// 将 Documents 添加到 sandbox 路径上
      	NSString *documentPath = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"];
      

    
    - 这两者的区别就是：使用 NSSearchPathForDirectoriesInDomains 比在 NSHomeDirectory 后面添加 Documents 更加安全。因为该文件目录可能在未来发送的系统上发生改变。
    
    

  • 第二步：生成在该路径下的文件：

    	// fileName 就是保存文件的文件名
    	NSString *FileName = [documentPath stringByAppendingPathComponent:@"fileName"];
    

  • 第三步：往文件中写入数据：

    	// 将 NSData 类型对象 data 写入文件，文件名为 FileName
    	[data writeToFile:FileName atomically:YES];
    

  • 第四步：从文件中读出数据：

    	// 从 FileName 中读取出数据
    	NSData *data = [NSData dataWithContentsOfFile:FileName options:0 error:NULL];
    

2、Plist 文件的读写

	NSString *arrayPath = [NSHomeDirectory() stringByAppendingString:@"/Desktop/arrayToPList.plist"];
	NSString *dictionaryPath = [NSHomeDirectory() stringByAppendingString:@"/Desktop/dictionaryToPList.plist"];
	    
	// 待写入数据
	NSArray *array = @[@"bei", @"jing", @"huan", @"ying", @"nin"];
	    
	// 待写入数据
	NSDictionary *dictionary = @{@"name":@"chen chao", @"age":@"18", @"info":@"Good Teacher"};
	    
	// 写 Plist 文件
	    
		// 数组写入 plist 文件
		BOOL bl1 = [array writeToFile:arrayPath atomically:YES];
		    
		// 字典写入 plist 文件
		BOOL bl2 = [dictionary writeToFile:dictionaryPath atomically:YES];
	    
	// 读 Plist 文件
	
		NSArray *arrayFromPlist = [NSArray arrayWithContentsOfFile:arrayPath];
		NSDictionary *dicFromPList = [NSDictionary dictionaryWithContentsOfFile:dictionaryPath];

3、Plist 序列化

	NSString *arrayPath = [NSHomeDirectory() stringByAppendingString:@"/Desktop/arrayPropertyList.plist"];
	NSString *dictionaryPath = [NSHomeDirectory() stringByAppendingString:@"/Desktop/dictionaryPropertyList.plist"];
	    
	// 待写入数据
	NSArray *array = @[@"bei", @"jing", @"huan", @"ying", @"nin"];                                                  
	    
	// 待写入数据
	NSDictionary *dictionary = @{@"name":@"chen chao", @"age":@"18", @"info":@"Good Teacher"};                      
	    
	// 序列化，将数据转换成 XML 格式的文件
	
		NSData *arrayData = [NSPropertyListSerialization dataWithPropertyList:array 
		                                                               format:NSPropertyListXMLFormat_v1_0 
		                                                              options:1 
		                                                                error:nil];
		                                                              
		NSData *dictionaryData = [NSPropertyListSerialization dataWithPropertyList:dictionary 
		                                                                    format:NSPropertyListXMLFormat_v1_0 
		                                                                   options:1 
		                                                                     error:nil];
		    
		// 输出到 .txt 格式文件中
		BOOL bl1 = [arrayData writeToFile:arrayPath atomically:YES];                                                	
		BOOL bl2 = [dictionaryData writeToFile:dictionaryPath atomically:YES];
	    
	// 反序列化
	
		NSArray *arrayFromeFile = [NSArray arrayWithContentsOfFile:arrayPath];
		NSDictionary *dicitionaryFromeFile = [NSDictionary dictionaryWithContentsOfFile:dictionaryPath];

4、Plist 文件的使用

4.1 Plist 文件的创建

4.2 Plist 文件的解析

	// 获得 Plist 文件的全路径
	NSString *path = [[NSBundle mainBundle] pathForResource:@"shops" ofType:@"plist"];

	// 加载 plist 文件
	NSArray *shops = [NSArray arrayWithContentsOfFile:path];

4.3 Plist 文件的解析过程

4.4 Plist 的使用注意

• plist 的文件名不能叫做 “info”、“Info” 之类的。

• 添加 plist 等文件资源的时候，一定要勾选下面的选项。