phone开发基础教程》第十一章 基本数据持久

以前我们也用到过读取数据，但是没有一个应用程序是将其数据永久性存储，也就是在应用重启，机器重启后数据不会丢失，和上一次最后的数据一致。这章一共定义了三种保持数据的方法，第一种：实用属性列表，第二种：对象归档，第三种：使用Iphone的嵌入式数据库（SQLite3）

 

给予Iphone应用程序沙盒原理，我们保持的数据都是保存在相对应的应用程序的Document文件夹。既然我们把数据放在每一个应用的Document文件夹中，呢我我们怎么得到相应的路径呢，其实也不是很难。下面是检索文档目录路径的代码：

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserdomainMask, YES);

NSString *documentDirectory = [paths objectAtIndex:0];常量NSDocumentDirectory表面我们正在查找的Document目录路径，常量NSUserDomainmask表明我们希望将搜索限制于我们应用程序的沙盒中。这样我们就可以得到该数组的第一值，也仅此一值，因为每一个应用程序只有一个Document文件夹。我们得到了Document的路径，然后和文件名相连接不就是一个完整的路径了吗，这用到了stringByAppendingPathComponent方法：

NSString *filepath = [documentDirectory stringbyAppendingPathComponent:@"filename.xxx"];其中filename.xxx为要命名的文件。

 

在每一个应用程序中还对应一个temp文件夹，我们怎么获取这个文件夹的路径呢，也比较简单：

NSString *tempPath = NSTemporaryDirectory（）；

NSString *filePath = [tempPath stringByAppendingPathComponent:@"filename.xxx"];

 

 

下面我们来创建该项目：

第一个实用属性列表文件，打开Xcode，创建新项目，选择View-Based Application即可，我创建项目名称是IP_11persistence。打开IP_11persistenceViewController.h，首先定义一个常量用来串联Document。

#define kFileName @"data.plist"

然后定义四个输出口，用来输入和显示数据。

IBOutlet UITextField *show1;
 IBOutlet UITextField *show2;
 IBOutlet UITextField *show3;
 IBOutlet UITextField *show4;

定义两个方法：

-(NSString *)dataFilePath;//用来返回数据文件的完整路径名
-(void)applicationWillTerminate:(NSNotification *)notification;//应用程序在退出时调用，将数据保存到数据列表

然后打开IP_11persistenceViewController.m

添加下面这三个方法：

-(NSString *)dataFilePath//用来返回数据文件的完整路径名
{
 NSArray *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
 NSString *paths = [path objectAtIndex:0];
 return [paths stringByAppendingPathComponent:kFileName];

 

}

-(void)applicationWillTerminate:(NSNotification *)notification//应用程序在退出时调用，将数据保存到数据列表
{
 NSMutableArray *array = [[NSMutableArray alloc]init];
 [array addObject:show1.text];
 [array addObject:show2.text];
 [array addObject:show3.text];
 [array addObject:show4.text];
 [array writeToFile:[self dataFilePath] atomically:YES];
 [array release];
}

-(void)viewDidLoad
{
 NSString *filePath = [self dataFilePath];//得到文件路径
 if([[NSFileManager defaultManager] fileExistsAtPath:filePath])//如果该文件存在就加载
 {
  NSArray *array = [[NSArray alloc] initWithContentsOfFile:filePath];
  show1.text = [array objectAtIndex:0];
  show2.text = [array objectAtIndex:1];
  show3.text = [array objectAtIndex:2];
  show4.text = [array objectAtIndex:3];
  [array release];
 }

 UIApplication *app = [UIApplication sharedApplication];
 [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillTerminate:)
             name:UIApplicationWillTerminateNotification
              object:app];
 [super viewDidLoad];
}

代码已经搞定，下面点开Resources文件夹，打开IP_11persistenceViewController.xib，向里面拖入4个UITextField控件，勾掉每一个控件上的Clear When Editing Begin，这样就不是每次选中文本框的时候会自动消失里面的内容了。关联四个控件即可。（在实际的例子当中我添加两个方法，一个是在点击回车时，软键盘自动消失，一个是在点击背景是软键盘自动消失，这两个方法在第四章中有详细的讲解，可以去参考）。build and go运行，这是你输入内容，关闭应用程序，然后在打开，你会发现你刚才输入的内容仍然存在，下面开始第二种方法，使用对象归档的方法。

 

创建一个新的项目，我的项目名是：IP_11persistence2。创建好以后，在Classes文件夹上点右键创建一个新的类，选择NSObject subclass模板。名称为fourlines。打开fourlines.h，向里面添加四个常量和四个输出口：

#define kField1Key @"show1"
#define kField2Key @"show2"
#define kField3Key @"show3"
#define kField4Key @"show4"

 

NSString *show1;
NSString *show2;
NSString *show3;
NSString *show4;

打开fourlines.m文件，修改代码：

-(void)encodeWithCoder:(NSCoder *)encoder //对所有的属性进行编码
{
 [encoder encodeObject:show1 forKey:kField1Key];
 [encoder encodeObject:show2 forKey:kField2Key];
 [encoder encodeObject:show3 forKey:kField3Key];
 [encoder encodeObject:show4 forKey:kField4Key];
}

-(id)initWithCoder:(NSCoder *)decoder//使用相同的4格键值对这些属性进行解码
{
 if(self == [super init])
 {
  self.show1 = [decoder decodeObjectForKey:kField1Key];
  self.show2 = [decoder decodeObjectForKey:kField2Key];
  self.show3 = [decoder decodeObjectForKey:kField3Key];
  self.show4 = [decoder decodeObjectForKey:kField4Key];
 }
 return self;
}

-(id)copyWithZone:(NSZone *)zone//创建一个新的fourline对象，并将所有4格字符串复制到其中
{
 fourlines *copy = [[[self class] allocWithZone:zone] init];
 show1 = [self.show1 copy];
 show2 = [self.show2 copy];
 show3 = [self.show3 copy];
 show4 = [self.show4 copy];
 return copy;
}

然后打开IP_11persistence2ViewController.h，里面声明四个输出口，这和第一个例子一样，定义两个常量。

#define kFileName @"archive"
#define kDataKey @"Data"

打开IP_11persistence2ViewController.m导入fourlines类。

#import "fourlines.h"

修改代码

-(NSString *)dataFilePath//用来返回数据文件的完整路径名
{
 NSArray *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
 NSString *paths = [path objectAtIndex:0];
 return [paths stringByAppendingPathComponent:kFileName];
}

-(void)applicationWillTerminate:(NSNotification *)notification//应用程序在退出时调用，将数据保存到数据列表
{
 fourlines *fourline = [[fourlines alloc] init];
 fourline.show1 = show1.text;
 fourline.show2 = show2.text;
 fourline.show3 = show3.text;
 fourline.show4 = show4.text;
 
 NSMutableData *data = [[NSMutableData alloc] init];
 NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
 [archiver encodeObject:fourline forKey:kDataKey];
 [archiver finishEncoding];
 [data writeToFile:[self dataFilePath] atomically:YES];
 [fourline release];
 [archiver release];
 [data release];
}

-(void)viewDidLoad
{
 NSString *filePath = [self dataFilePath];//得到文件路径
 if([[NSFileManager defaultManager] fileExistsAtPath:filePath])//如果该文件存在就加载
 {
  NSMutableData *data = [[NSMutableData alloc] initWithContentsOfFile:[self dataFilePath]];
  NSKeyedUnarchiver *archiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
  fourlines *fourline = [archiver decodeObjectForKey:kDataKey];
  [archiver finishDecoding];
  
  show1.text = fourline.show1;
  show2.text = fourline.show2;
  show3.text = fourline.show3;
  show4.text = fourline.show4;
  
  [archiver release];
  [data release];
 }
 UIApplication *app = [UIApplication sharedApplication];
 [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillTerminate:)
             name:UIApplicationWillTerminateNotification
              object:app];
 [super viewDidLoad];
}

对IP_11persistence2ViewController.xib的操作同第一个。

 

下面来创建最后一个使用SQLite来保存数据。我创建的项目名是IP_11SQLite。

首先导入libsqlite3.lib，这和导入FrameWork一样，在Framework文件夹上面右击，ADD-Existing Files然后选择文件，该文件在/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS2.2.sdk/usr/lib/libsqlite3.dylib下面。导入后开始修改代码。

打开IP_11SQLiteViewController.h

#import "/usr/include/sqlite3.h"
#define kFileName @"data.sqlite3"

增加一个变量：sqlite3 *database;

修改后为：

#import <UIKit/UIKit.h>
#import "/usr/include/sqlite3.h"
#define kFileName @"data.sqlite3"

@interface IP_11SQLiteViewController : UIViewController {
 IBOutlet UITextField *show1;
 IBOutlet UITextField *show2;
 IBOutlet UITextField *show3;
 IBOutlet UITextField *show4;
 
 sqlite3 *database;
}
@property (nonatomic, retain) UITextField *show1;
@property (nonatomic, retain) UITextField *show2;
@property (nonatomic, retain) UITextField *show3;
@property (nonatomic, retain) UITextField *show4;
-(NSString *)dataFilePath;
-(void)applicationWillTerminate:(NSNotification *)notification;
@end

然后打开IP_11SQLiteViewController.m修改代码如下：

-(NSString *)dataFilePath//用来返回数据文件的完整路径名
{
 NSArray *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
 NSString *paths = [path objectAtIndex:0];
 return [paths stringByAppendingPathComponent:kFileName];
}

-(void)applicationWillTerminate:(NSNotification *)notification//应用程序在退出时调用，将数据保存到数据列表
{
 for(int i = 1; i<=4; i++)
 {
  NSString *fieldName = [[NSString alloc] initWithFormat:@"show%d",i];
  UITextField *field = [self valueForKey:fieldName];//根据每一i的值设定相应textfield
  [fieldName release];
  
  NSString *update = [[NSString alloc] initWithFormat:@"insert or replace into fields (row, field_data) values (%d, 插入或更新表
  char *errorMsg;
  
  if(sqlite3_exec(database, [update UTF8String],NULL,NULL,&errorMsg) != SQLITE_OK)//执行插入或更新操作，如果插入或更新失败给出错误信息
  {
   NSAssert1(0,@"Error updating tables: %s",errorMsg);
   sqlite3_free(errorMsg);
  }
 }
 sqlite3_close(database);//关闭数据库连接
}

-(void)viewDidLoad
{
 if(sqlite3_open([[self dataFilePath] UTF8String], &database) != SQLITE_OK)//打开数据库，如果打开失败给出提示
 {
  sqlite3_close(database);
  NSAssert(0,@"Failed to open database");
 }
 
 char *errorMsg;
 NSString *createSQL = @"create table if not exists fields (row integer primary key, field_data text);";//创建表
 if(sqlite3_exec(database, [createSQL UTF8String],NULL,NULL,&errorMsg)!=SQLITE_OK)//是否创建成功
 {
  sqlite3_close(database);
  NSAssert1(0,@"Error creating table: %s",errorMsg);
 }
 
 NSString *query = @"select row, field_data from fields order by row";//查找表中的数据，行和每一行对应的值
 sqlite3_stmt *statement;
 if(sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil) == SQLITE_OK)
 {
  while(sqlite3_step(statement) == SQLITE_ROW)
  {
   int row = sqlite3_column_int(statement, 0);
   char *rowData = (char *)sqlite3_column_text(statement, 1);
   
   NSString *fieldName = [[NSString alloc] initWithFormat:@"show%d",row];
   NSString *fieldValue = [[NSString alloc] initWithUTF8String:rowData];
   UITextField *field = [self valueForKey:fieldName];
   field.text = fieldValue;
   [fieldName release];
   [fieldValue release];
  }
  sqlite3_finalize(statement);
 }
 
 UIApplication *app = [UIApplication sharedApplication];
 [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillTerminate:)
             name:UIApplicationWillTerminateNotification
              object:app];
 [super viewDidLoad];
}
最后就是IP_11SQLiteViewController.xib的修改了，和第一个一样的。

到此三种方法的操作结束了。