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