基本数据持久性(一) 使用plist保存和读取数据
-
想保存成绩、记录得分、保存账号密码等等？数据持久性可以做到这一点！这篇文章通过简单的程序，来分享一下如何使用plist来保存和读取数据，以供大家参考学习。
一、程序的主要功能
1. xib文件如图1所示。
图 1
2. 通过“保存”按钮将4个textField(ID、Name、Age、Class后面的输入框)的内容保存到plist文件中。
3.通过“读取”按钮将plist中的内容分别读取到4个textField中。
二、实现步骤
1.先创建一个Single ViewController的视图，命名为“使用plist保存和读取数据”。然后对xib文件进行操作，分别放置上4个Label、4个textField和2个Button，如图1所示。
2.对4个textField分别设置IBOutlet属性，对2个Button分别设置IBAction方法，并将其与xib文件相对应的控件关联。
3.在“ViewController.h”文件中，添加一个UITextFieldDelegate，以调用该协议中的“- (BOOL)textFieldShouldReturn:(UITextField *)textField”方法通过点击键盘的返回键来隐藏键盘(注：因为这个程序比较简单，该步骤不是必须的，可根据需要添加。因为在程序中，还会通过一个“- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event”的方法，使得点击屏幕时隐藏键盘)。做完2、3步骤以后的程序应该与下面的程序代码类似：
01.#import <UIKit/UIKit.h>02.@interface ViewController : UIViewController<UITextFieldDelegate>03.//输入学生ID04.@property (retain, nonatomic) IBOutlet UITextField *stuID;05.//输入学生Name06.@property (retain, nonatomic) IBOutlet UITextField *stuName;07.//输入学生Age08.@property (retain, nonatomic) IBOutlet UITextField *stuAge;09.//输入学生Class10.@property (retain, nonatomic) IBOutlet UITextField *stuClass;11.//点击“保存”按钮时触发的操作12.- (IBAction)saveData:(id)sender;13.//点击“读取”按钮时触发的操作14.- (IBAction)loadData:(id)sender;15.@end4.因为有textField，所以一般接下来我是先在“ViewController.m”文件里面写隐藏键盘的方法，以免忘记而在测试程序时因为键盘未隐藏而耽误事。在这里有两个方法来隐藏键盘，上面已经叙述过。如果采用“- (BOOL)textFieldShouldReturn:(UITextField *)textField”的方法来隐藏键盘，需要先在“- (void)viewDidLoad”方法里面设置代理，程序代码如下：
01.- (void)viewDidLoad02.{03.[super viewDidLoad];04.//对4个textField设置代理05._stuID.delegate = self;06._stuName.delegate = self;07._stuAge.delegate = self;08._stuClass.delegate = self;09.//对4个textField设置代理的工作完成10.}接下来就可以完成“- (BOOL)textFieldShouldReturn:(UITextField *)textField”的方法来隐藏键盘，代码如下：
01.- (BOOL) textFieldShouldReturn:(UITextField *)textField02.{03.//因为xib文件中的4个输入框均为textField，04.//所以只要使该方法的参数textField取消第一响应状态05.//即可满足该项目中的所有textField当点击回车按钮时都取消第一响应状态06.[textField resignFirstResponder];07.//取消textField的第一响应状态，键盘隐藏08.returnYES;09.}另外一种隐藏键盘的方法是当触摸屏幕时(非textField区域和键盘区域)键盘隐藏，因此可以使用“- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event”方法，代码如下：
1.//点击非textField和键盘的屏幕后隐藏键盘2.- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event3.{4.[_stuID resignFirstResponder];5.[_stuName resignFirstResponder];6.[_stuAge resignFirstResponder];7.[_stuClass resignFirstResponder];8.}5.以上的工作做完后，那么接下来要干什么呢？既然是要永久的保存数据，那么是否应该有一个永久保存数据的位置呢？是的，接下来我们要做的工作就是创建一个.plist的文件，并得到保存该.plist的文件的位置，以供我们保存和读取数据时候找到该路径。为此，我们创建一个方法，该方法返回一个NSString类型的值(文件的路径是一串字符串，这个很好理解吧？)，当我们点击“保存”或者“读取”按钮时，能够读到这个路径下的数据。我写的这个方法名叫“- (NSString*)dataFilePath”，详细代码如下所示：
01.//获取文件的路径02.- (NSString*)dataFilePath03.{04.//1.获取文件路径数组，这个是因为考虑到为mac编写代码的原因05.NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);//注意，括号里面的第一个元素是NSDocumentDirectory，而不是NSDocumentationDirectory06.//2.获取文件路径数组的第一个元素，因为我们只需要这一个07.NSString *documentPath = [paths objectAtIndex:0];08.//3.获取第2步得到的元素的字符串，并创建一个名为data.plist的.plist文件用于保存数据09.NSString *fileName = [documentPath stringByAppendingPathComponent:@"data.plist"];10.returnfileName;11.}6.接下来，就是对数据的保存了。为此，需要在点击“保存”按钮的方法里面填写一些内容。该方法我命名为“- (IBAction)saveData:(id)sender”。首先，我们先尝试打开一下我们创建的plist文件，看看里面都有什么内容，也好与保存完数据后的做比较。为此，我们需要先在“- (IBAction)saveData:(id)sender”的方法里面获得一下保存文件的路径，并测试文件是否存在。如果文件存在，则输出文件的路径地址，以便我们查找.plist文件。详细代码如下：
01.//点击保存按钮时触发的操作02.- (IBAction)saveData:(id)sender03.{04.//1.首先获取文件的存取路径05.NSString *pathStr = [self dataFilePath];06.//如果路径没有找到，则弹出来一个警告对话框07.if(pathStr == nil)08.{09.UIAlertView *alert = [[UIAlertView alloc]initWithTitle:@"警告"message:@"当前路径没有找到"delegate:nil cancelButtonTitle:@"取消"otherButtonTitles: nil];10.[alert show];11.[alert release];//因为我写这个程序没有采用ARC，所以必须要释放alert12.}13.else//如果路径不为空14.{15.NSLog(@"pathStr: %@", pathStr);//输出路径的地址16.}17.//2.获得路径后，定义一个可变数组用来保存数据18.//用数组是因为.plist文件的root下的值的tepy只能是数组或者字典19.NSMutableArray *data = [[NSMutableArray alloc]init];20.//3.将4个textField里面写入的值放到data里面21.[data addObject:self.stuID.text];22.[data addObject:self.stuName.text];23.[data addObject:self.stuAge.text];24.[data addObject:self.stuClass.text];25.//4.将可变数组里面的数据按照路径写入文件26.[data writeToFile:pathStr atomically:YES];27.[data release];//因为我写这个程序没有采用ARC，所以必须要释放data28.}写好后，运行程序，当模拟器将程序加载完成后，不要填写任何textField里面的内容，直接点击“保存”按钮，此时我的程序得到的NSLog的值为：“2013-09-15 22:21:47.430 使用plist保存和读取数据[1293:c07] pathStr: /Users/apple/Library/Application Support/iPhone Simulator/6.1/Applications/656AB286-6184-4400-AB72-A1437DC52328/Documents/data.plist”。复制这句话里面的“/Users/apple/Library/Application Support/iPhone Simulator/6.1/Applications/656AB286-6184-4400-AB72-A1437DC52328/Documents/data.plist”，在电脑显示桌面的情况下，选择上面标签中的“前往——前往文件夹”，然后把刚才复制的那句话粘贴到里面，即可找到我们创建的“data.plist”文件，打开它，应该和图2所示的内容很像：
图 2
看到第2行的第二列的值了么？那是一个Array，你点击一下它，可以看到它只有两个值：Array和Dictionary。root下有4个属性，那是因为我们创建了一个保存4个textField的值的数组。此时Value一列中还没有值，因为我们还没有对textField做任何操作。接下来，就是完成这一步的工作了。
7.重新运行程序，当iOS模拟器加载程序成功后，如图3所示的内容分别填写4个textField，完成后点击“保存”按钮(我在xib里面把4个textField的字体都设置为居中了，这个不影响最终的结果的，可根据个人喜好等自定)：
图 3
此时，再按照第6步所示的方法，找到保存完数据后的data.plist文件，打开它，此时它应该与图4所示的内容类似：
图 4
8.数据已经保存了，那么是否可以读取呢？为此，我们先编写完成“读取”按钮的方法。我在程序里面给它命名为“- (IBAction)loadData:(id)sender”。首先，还是需要先把保存数据的路径给找出来，然后把该路径里面的内容分别赋值给4个textField。详细代码如下所示：
01.//点击读取按钮时触发的操作02.- (IBAction)loadData:(id)sender03.{04.//1.首先获取文件的存取路径05.NSString *pathStr = [self dataFilePath];06.07.//2.判断文件是否存在，如果存在用一个数组取出文件中数据08.//并分别赋值给4个textField09.if([[NSFileManager defaultManager]fileExistsAtPath:pathStr])10.{11.//获取文件存取路径下的文件12.NSArray *data = [[NSArray alloc]initWithContentsOfFile:pathStr];13.14.//将获取到的文件分别赋值给4个textField15.self.stuID.text = [data objectAtIndex:0];16.self.stuName.text = [data objectAtIndex:1];17.self.stuAge.text = [data objectAtIndex:2];18.self.stuClass.text = [data objectAtIndex:3];19.20.[data release];//因为我写这个程序没有采用ARC，所以必须要释放data21.}22.}然后，通过Xcode重新运行代码，当iOS模拟器加载程序成功后，直接点击“读取”按钮，此时，你会发现，得到的内容和图3显示的一模一样(请忽略模拟器上的时间吧)——刚刚存的数据被成功加载回来了！是的，完成了简单的基本数据持久化。
9.至此，我们的程序就算是完成了。如果你没有采用ARC来写这个程序，那么，请记得在“- (void)dealloc”方法里面释放你创建的内存——如果你采用的是直接从xib拖动控件到ViewController.h文件里面生成相应的属性和方法，那么Xcode已经为你写好了“- (void)dealloc”方法了，你无须理会。
10.如果你想彻底清除data.plist里面保存的数据，直接将iOS模拟器“还原内容和设置”即可。
三、小测验
在上述保存了图3所示的内容以后并且没有将iOS模拟器“还原内容和设置”的情况下，再设置一组信息如图5所示，点击“保存”按钮后，按照第二大条第6步骤的方法，看看data.plist里面保存的是什么值？
图 5
请想想这是为什么吧？以及如何可以改进呢？也许，你并不想只保存一组数据，是吧？
如果你有好的想法，欢迎告知与大家，与大家一起探讨。
P.S.我已将完整的代码放到附件了(再次强调一下，我没有使用ARC)，如果有需要的朋友，欢迎下载参考。如对我的代码有改进，还请告知与我，我好更新本博客供其他人参考，感谢！