【转】基本数据持久性(一) 使用plist保存和读取数据

原文网址：http://www.it165.net/pro/html/201309/7170.html

想保存成绩、记录得分、保存账号密码等等？数据持久性可以做到这一点！这篇文章通过简单的程序，来分享一下如何使用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.//输入学生ID

04.@property (retain, nonatomic) IBOutlet UITextField *stuID;

05.//输入学生Name

06.@property (retain, nonatomic) IBOutlet UITextField *stuName;

07.//输入学生Age

08.@property (retain, nonatomic) IBOutlet UITextField *stuAge;

09.//输入学生Class

10.@property (retain, nonatomic) IBOutlet UITextField *stuClass;

11.//点击“保存”按钮时触发的操作

12.- (IBAction)saveData:(id)sender;

13.//点击“读取”按钮时触发的操作

14.- (IBAction)loadData:(id)sender;

15.@end

4.因为有textField，所以一般接下来我是先在“ViewController.m”文件里面写隐藏键盘的方法，以免忘记而在测试程序时因为键盘未隐藏而耽误事。在这里有两个方法来隐藏键盘，上面已经叙述过。如果采用“- (BOOL)textFieldShouldReturn:(UITextField *)textField”的方法来隐藏键盘，需要先在“- (void)viewDidLoad”方法里面设置代理，程序代码如下：

01.- (void)viewDidLoad

02.{

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 *)textField

02.{

03.//因为xib文件中的4个输入框均为textField，

04.//所以只要使该方法的参数textField取消第一响应状态

05.//即可满足该项目中的所有textField当点击回车按钮时都取消第一响应状态

06.[textField resignFirstResponder];

07.//取消textField的第一响应状态，键盘隐藏

08.return YES;

09.}

另外一种隐藏键盘的方法是当触摸屏幕时(非textField区域和键盘区域)键盘隐藏，因此可以使用“- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event”方法，代码如下：

1.//点击非textField和键盘的屏幕后隐藏键盘

2.- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event

3.{

4.[_stuID resignFirstResponder];

5.[_stuName resignFirstResponder];

6.[_stuAge resignFirstResponder];

7.[_stuClass resignFirstResponder];

8.}

5.以上的工作做完后，那么接下来要干什么呢？既然是要永久的保存数据，那么是否应该有一个永久保存数据的位置呢？是的，接下来我们要做的工作就是创建一个.plist的文件，并得到保存该.plist的文件的位置，以供我们保存和读取数据时候找到该路径。为此，我们创建一个方法，该方法返回一个NSString类型的值(文件的路径是一串字符串，这个很好理解吧？)，当我们点击“保存”或者“读取”按钮时，能够读到这个路径下的数据。我写的这个方法名叫“- (NSString*)dataFilePath”，详细代码如下所示：

01.//获取文件的路径

02.- (NSString*)dataFilePath

03.{

04.//1.获取文件路径数组，这个是因为考虑到为mac编写代码的原因

05.NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  //注意，括号里面的第一个元素是NSDocumentDirectory，而不是NSDocumentationDirectory

06.//2.获取文件路径数组的第一个元素，因为我们只需要这一个

07.NSString *documentPath = [paths objectAtIndex:0];

08.//3.获取第2步得到的元素的字符串，并创建一个名为data.plist的.plist文件用于保存数据

09.NSString *fileName = [documentPath stringByAppendingPathComponent:@"data.plist"];    

10.return fileName;

11.}

6.接下来，就是对数据的保存了。为此，需要在点击“保存”按钮的方法里面填写一些内容。该方法我命名为“- (IBAction)saveData:(id)sender”。首先，我们先尝试打开一下我们创建的plist文件，看看里面都有什么内容，也好与保存完数据后的做比较。为此，我们需要先在“- (IBAction)saveData:(id)sender”的方法里面获得一下保存文件的路径，并测试文件是否存在。如果文件存在，则输出文件的路径地址，以便我们查找.plist文件。详细代码如下：

01.//点击保存按钮时触发的操作

02.- (IBAction)saveData:(id)sender

03.{

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，所以必须要释放alert

12.}

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，所以必须要释放data

28.}

写好后，运行程序，当模拟器将程序加载完成后，不要填写任何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)sender

03.{

04.//1.首先获取文件的存取路径

05.NSString *pathStr = [self dataFilePath];

06. 

07.//2.判断文件是否存在，如果存在用一个数组取出文件中数据

08.//并分别赋值给4个textField

09.if([[NSFileManager defaultManager]fileExistsAtPath:pathStr])

10.{

11.//获取文件存取路径下的文件

12.NSArray *data = [[NSArray alloc]initWithContentsOfFile:pathStr];

13. 

14.//将获取到的文件分别赋值给4个textField

15.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，所以必须要释放data

21.}

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)，如果有需要的朋友，欢迎下载参考。如对我的代码有改进，还请告知与我，我好更新本博客供其他人参考，感谢！