Three20软件引擎之结合第三方FMDB框架操作数据库详解（四）

Three20软件引擎之结合第三方FMDB框架操作数据库详解

雨松MOMO原创文章如转载，请注明：转载至我的独立域名博客雨松MOMO程序研究院，原文地址:http://www.xuanyusong.com/archives/638

开始本章之间，首先了解一下FMDB，它是一个老外写的第三方操作数据库的框架。因为IOS官方提供操作数据库的方法似乎不是那么近人而意，使用起来有点麻烦，所以这个老外哥们就将官方提供的方法又包了一层，它封装的方法非常浅，并没有多莫高深，只是更方便开发使用，我看了一下大概核心的代码500多行吧。下面开始学习它，首先需要将源码下载至本地，这哥们将代码上传至GitHub当中，(我现在越来越喜欢GitHub了，在这里总能找到老外写的好玩的东西）。

下载地址：https://github.com/ccgus/fmdb  

无需注册，在页面左上角标题下方点击“ZIP”按钮，即可将源码下载至本地，接着解压文件，然后将源码中src文件夹中的所有代码拷贝至工程当中。由于Xcode4.3.1有一个BUG比较恶心，不支持文件夹的拖拽添加至工程当中，所以需要手动添加文件夹。如下图所示，在下拉列表中点击“Add Files to Some Project”按钮，然后在我的电脑中 选择刚刚解压后的src文件夹，将FMDB中所有源码添加至当前工程。

FMDB的源码添加完毕后，然后删除fmdb.m 这是作者提供工程的入口类，有兴趣的朋友可以自行研究，我们只学习如何使用这个框架。 目前程序是无法编译通过的，因为缺少类库文件，如下图所示，请将libsqlite3.0dylib添加至工程。

类库文件添加完毕后，到这一步工程就应该可以正常编译了。如果到这一步你的工程还有错误，那就恭喜你自己在好好检查检查工程的结构啦。接下来将步入正题，老规矩还是以一个实例的形式向大家介绍如何使用FMDB，如下图所以，又是我们熟悉的界面。

本示例中，程序中共用到了3个控制类，它们是：

StartViewController：上图中绘制的启动视图。

SQLViewController：增、删、改、查后在屏幕中显示的列表视图。

MessageInfoController：选择数据库中某一项数据后将所有信息展示在这个视图中。

首先是程序的启动类，这里说明一下，有关以前提到的知识本节我就不在赘述，如果不理解的朋友请阅读本系列教程之前的文章。

AppDelegate.m

#import "AppDelegate.h" #import "StartViewController.h" #import "SQLViewController.h" #import "MessageInfoController.h" @implementation AppDelegate @synthesize window = _window; - (void)dealloc { [_window release]; [super dealloc]; } - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { TTNavigator* navigator = [TTNavigator navigator]; navigator.persistenceMode = TTNavigatorPersistenceModeAll; navigator.window = [[[UIWindow alloc] initWithFrame:TTScreenBounds()] autorelease]; TTURLMap* map = navigator.URLMap; [map from:@"*" toViewController:[TTWebController class]]; [map from:@"tt://StartView" toSharedViewController:[StartViewController class]]; [map from:@"tt://SQLView/(initInfo:)" toViewController:[SQLViewController class]]; [map from:@"tt://MessageView/(initInfo:)" toViewController:[MessageInfoController class]]; if (![navigator restoreViewControllers]) { [navigator openURLAction:[TTURLAction actionWithURLPath:@"tt://StartView"]]; } return YES; } @end

StartViewController.m 启动画面

#import "StartViewController.h" @implementation StartViewController - (void)viewDidLoad { [super viewDidLoad]; //标题栏名称 self.title = @"雨松MOMO"; //设置视图背景颜色 self.view.backgroundColor = [UIColor blackColor]; //创建图片视图 TTImageView *imageview = [[[TTImageView alloc] initWithFrame: CGRectMake(100, 50, 120, 120)] autorelease]; //设置图片视图显示的图片资源 imageview.defaultImage = TTIMAGE(@"bundle://0.jpg"); //将图片视图加入整个视图当中 [self.view addSubview:imageview]; //创建label视图 UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, 320, 30)]; //设置显示内容 label.text = @"Three20软件开发之FMDB数据库"; //设置背景颜色 label.backgroundColor = [UIColor blueColor]; //设置文字颜色 label.textColor = [UIColor whiteColor]; //设置显示位置居中 label.textAlignment = UITextAlignmentCenter; //设置字体大小 label.font = [UIFont fontWithName:[[UIFont familyNames] objectAtIndex:10] size:20]; [self.view addSubview: label]; NSArray *titles = [[NSArray alloc] initWithObjects: @"插入数据库", @"更新数据库", @"删除数据库", @"查询数据库", nil]; for (int i =0; i < [titles count]; i++) { //创建普通按钮 UIButton *button = [UIButton buttonWithType:1]; //设置按钮位置 button.frame = CGRectMake(0, 200 + i * 40, 320, 30); //设置按钮现实文字 [button setTitle:[titles objectAtIndex:i] forState:UIControlStateNormal]; //设置按钮标记 button.tag = i; //设置按钮点击后 绑定响应方法 [button addTarget:self action:@selector(ButtonPressed:) forControlEvents:UIControlEventTouchUpInside]; //将按钮添加入视图中 [self.view addSubview: button]; } } //按钮点击后将进入这个方法 -(void)ButtonPressed:(id)buttonID { //得到导航对象 TTNavigator* navigator = [TTNavigator navigator]; //获取点击的按钮 UIButton *button = (UIButton *)buttonID; //注解1 switch (button.tag) { case 0: [navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/0"] applyAnimated:YES]]; break; case 1: [navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/1"] applyAnimated:YES]]; break; case 2: [navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/2"] applyAnimated:YES]]; break; case 3: [navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/3"] applyAnimated:YES]]; break; default: break; } } @end

注解1：在启动视图中，点击按钮后程序将进入@"tt://SQLView"页面，该页面对应的控制类是SQLViewController。

SQLViewController.h 

#import <Three20/Three20.h> #import "SingleDate.h" @interface SQLViewController : TTTableViewController { //记录上一页点击的按钮 int pageID; //获取单例模型的实例 SingleDate *instance; //数据库对象 FMDatabase *db; } @end

SQLViewController.m

所有使用FMDB操作数据库的方法都写在这个类中，增加、删除、修改、查询都在里面。请大家先阅读一下，后面我会有详细的注解。

#import "SQLViewController.h" #import "FMDatabase.h" #import "FMDatabaseAdditions.h" #define DATABASE_NAME @"Temp.db" @implementation SQLViewController -(id)initInfo:(int)page { if (self = [super init]) { //注解1 pageID = page; } return self; } - (void)viewDidLoad { [super viewDidLoad]; //注解2 //图片的地址 NSMutableArray *iconurls = [[[NSMutableArray alloc] initWithObjects: @"bundle://0.jpg", @"bundle://1.jpg", @"bundle://2.jpg", @"bundle://3.jpg", nil] autorelease]; //姓名 NSMutableArray *names = [[[NSMutableArray alloc] initWithObjects: @"雨松MOMO", @"RORO娃娃", @"小老虎", @"哇咔咔", nil] autorelease]; //性别 NSMutableArray *sexs = [[NSMutableArray alloc] initWithObjects: @"男", @"女", @"男", @"女", nil]; //地址 NSMutableArray *address = [[[NSMutableArray alloc] initWithObjects: @"北京市朝阳区", @"北京市西城区", @"北京市海淀区", @"北京市东城区", nil] autorelease]; //年龄 NSMutableArray *ages = [[[NSMutableArray alloc] initWithObjects: [NSNumber numberWithInt:28], [NSNumber numberWithInt:27], [NSNumber numberWithInt:26], [NSNumber numberWithInt:25], nil] autorelease]; //获取单例对象实例 instance = [SingleDate getInstance]; //读取数据库 db = [instance loadDB:DATABASE_NAME]; //结果集 FMResultSet *rs = nil; //判断当前页面的ID switch (pageID) { case 0: //注解3 if(![db tableExists:@"Message"]) { //创建数据库 if ([db executeUpdate:@"CREATE TABLE Message (_id INTEGER PRIMARY KEY AUTOINCREMENT,IconUrl text, Name text, Sex text,Address text,Age integer)"]) { NSLog(@"创建表成功"); for(int i=0 ;i<[iconurls count]; i++) { //遍历测试数据数组，然后将测试数据写入数据库当中 if([db executeUpdate:@"INSERT INTO Message (IconUrl,Name,Sex,Address,Age) VALUES (?,?,?,?,?)", [iconurls objectAtIndex:i],[names objectAtIndex:i], [sexs objectAtIndex:i],[address objectAtIndex:i],[ages objectAtIndex:i]]) { NSLog(@"插入数据成功"); } } } } //返回一个结果集 rs=[db executeQuery:@"SELECT * FROM Message"]; break; case 1: //判断当数据库中含有Message表时 if([db tableExists:@"Message"]) { //注释4 if([db executeUpdate:@"UPDATE Message SET Name = ? WHERE _id = ? ", @"雨松MOMO（已修改）",[NSNumber numberWithInt:1]]) { NSLog(@"更新一个数据成功"); } if([db executeUpdate:@"UPDATE Message SET Name = ? , Sex = ? , Address = ? WHERE _id = ? ", @"雨松MOMO（已修改）",@"男（已修改）",@"北京市朝阳区（已修改）",[NSNumber numberWithInt:1]]) { NSLog(@"更新多条数据成功"); } } //返回一个结果集 rs=[db executeQuery:@"SELECT * FROM Message"]; break; case 2: //判断当数据库中含有Message表时 if([db tableExists:@"Message"]) { //删除数据 if([db executeUpdate:@"DELETE FROM Message WHERE _id = ?",[NSNumber numberWithInt:2]]) { NSLog(@"删除数据成功"); } } //返回一个结果集 rs=[db executeQuery:@"SELECT * FROM Message"]; break; case 3: //返回一个结果集 rs=[db executeQuery:@"SELECT * FROM Message WHERE _id = ? ",[NSNumber numberWithInt:3]]; break; default: break; } NSMutableArray * array = [[[NSMutableArray alloc]init] autorelease]; //注释5 while ([rs next]) { [array addObject:[TTTableImageItem itemWithText:[rs stringForColumn:@"Name"] imageURL:[rs stringForColumn:@"IconUrl"] URL:[NSString stringWithFormat: @"%@%@", @"tt://MessageView/", [rs stringForColumn:@"_id"]]]]; } //用完以后一定要关闭 [rs close]; //设置列表自适应高度 self.variableHeightRows = YES; //设置列表现实的数据 self.dataSource = [TTSectionedDataSource dataSourceWithArrays:@"当前数据库信息",array,nil]; } @end
 

注解1：(int)page表示上一个页面进入本页面中传递的参数，在本页面中通过它来判断不同的数据库操作。

注解2：这4个数组包含的信息有，图片地址、姓名、性别、地址、年龄，这些数据仅仅起到测试数据的作用，后面我们需要将它们全部写入数据库当中。然后强调一下数据库与表的区别，一个库中可以添加多个表，本节中使用的数据库名称为Temp.db 数据表为Message，请大家注意一下即可。

注解3：tableExists方法用来判断数据库中是否包含某一个表，当数据库中没有该表时，创建该表并且写入数据。如果数据库中有该表则不做任何操作。 为了区分数据库，所以在插入数据时设置第一个参数为 _id INTEGER PRIMARY KEY AUTOINCREMENT它表示在数据库中添加_id字段，并且该字段为自动添值，它是一个向上递增的序列用来区分每条数据。

注解4：用于更新数据，这些都是标准的SQL语句，这里主要强调一下当更新多条数据时 数据之间使用逗号隔开。

注释5：这里主要学习FMResultSet类，它是一个查询的结果集。使用数据库语句找到的数据将全部写入FMResultSet对象当中，然后使用循环判断该对象即可。[rs next]方法表示拨动结果集的指针，返回true表示当前指针对应的结果集当中有值。最后将数据库中拿到的数据已列表的形式显示在视图中，如下图所示，列表中已经写入数据。

在获取数据库对象时，这使用到了单例模式，单例模式在程序语言设计中占据重要地位，而在IOS程序开发中也会频繁使用单例模式。举个简单的例子 从viewA 进入  viewB ， 但是viewB需要viewA中计算过的一些数据，有些朋友会想那直接在页面切换时将参数传递给viewB不就行了。这样是可以，但是如果程序中频繁的使用这样的操作肯定会出问题，因为它们属于View层，MVC设计模式告诉我们一定不要让数据放在View层。 在这里单例模型就好比控制器层，在viewA中将数据计算完毕后，写入单例对象中的变量中，进入viewB后，在继续从单例中获取刚刚viewA传递进去的数值。这样的思路会清晰很多，避免后期很多麻烦。

SingleDate.h

#import <Three20/Three20.h> #import "FMDatabase.h" @interface SingleDate : NSObject { } //获取单例对象 +(SingleDate *)getInstance; //读取数据库 -(FMDatabase *)loadDB:(NSString *)dbName; @end

SingleDate.m

#import "SingleDate.h" @implementation SingleDate static SingleDate *instance = nil; //获取单例 +(SingleDate *)getInstance { @synchronized(self) { if (instance == nil) { instance = [[self alloc] init]; } } return instance; } //读取数据库 -(FMDatabase* )loadDB:(NSString *)dbName { //获取当前程序路径 NSURL *appUrl = [[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject]; NSString *dbPath = [[appUrl path] stringByAppendingPathComponent:dbName]; //注释1 FMDatabase *db= [FMDatabase databaseWithPath:dbPath] ; if (![db open]) { [db release]; NSLog(@"数据库未能创建/打开"); return nil; } return db; } @end

注释1：如果没有该数据库则创建并且返回数据库对象，如果有该数据库直接返回对象。接着调用[db open]方法判断数据库对象是否创建与打开成功。

        接下来我们看看创建的数据库文件保存在了那里，如果你是用真机调试，那么请在Xcode主界面中点击右上角Organizer按钮，接着选择机器的名称，在机器对应的下拉列表中选择Applications，最后点击右侧页面下方Download按钮将应用程序中的数据下载至本地，解开这个包即可看到创建的数据库。如果你使用模拟器调试，该文件保存的路径为Library（资源库）->Application Support ->iPhone Simulator -> 5.1->Applciations->你的项目->Documents->Temp.db ，这个路径是我的模拟器路径，不同的模拟器版本路径会稍有差异，不过都差不多。如果实在找不到，请输出上方代码的 dbPath，它就是当前你数据库文件的路径。

下面我推荐大家使用在Mac下查看数据库的软件，名称是Navicat Premium。那么本节中也使用这个软件打开上述代码创建的数据库。打开Uavicat Premium 然间后，在左上角出点击Connection下拉列表选择SQLite，然后弹出创建数据库查看页面，接着在Connection Name ：输入一个名称（随便即可）Database File：选择刚刚创建的数据库文件的路径， 最后点击右下角OK按钮即可。如下图所示，已经将数据库打开，并且相应的数值已经写入Message数据库当中，这些数据从左到右的含义是：升序ID、图片的地址、名称、性别、地址、年龄，这些应该能看懂吧。怎么样这个软件还不错吧。

        接着是最后的展示页面，该页面将每一条数据库中的所有数据展示在屏幕当中。将选择列表的ID传入该页面，然后通过ID 去数据库中查询数值，从而将所有的信息展示在该页面中，代码在下面，仔细阅读以下就会明白。

MessageInfoController.h

#import <Three20/Three20.h> #import "SingleDate.h" #import "FMDatabase.h" @interface MessageInfoController : TTViewController { //数据库ID int sqlID; //单例对象 SingleDate *instance; //数据库对象 FMDatabase *db; } @end

MessageInfoController.m

#import "MessageInfoController.h" #define DATABASE_NAME @"Temp.db" @implementation MessageInfoController -(id)initInfo:(int)page { if (self = [super init]) { sqlID = page; } return self; } - (void)viewDidLoad { [super viewDidLoad]; instance = [SingleDate getInstance]; db = [instance loadDB:DATABASE_NAME]; //查询数据库的结果集 FMResultSet *rs=[db executeQuery:@"SELECT * FROM Message WHERE _id = ? ",[NSNumber numberWithInt:sqlID]]; if(rs != nil) { [rs next]; //获取名称 NSString * name = [rs stringForColumn:@"Name"]; //获取图片 UIImage * image = TTIMAGE([rs stringForColumn:@"IconUrl"]); //获取性别 NSString * sex = [rs stringForColumn:@"Sex"]; //获取地址 NSString * address = [rs stringForColumn:@"Address"]; //获取年龄 int age = [rs intForColumn:@"Age"]; [rs close]; //标题栏名称 self.title = name; //设置视图背景颜色 self.view.backgroundColor = [UIColor blackColor]; //创建图片视图 TTImageView *imageview = [[[TTImageView alloc] initWithFrame: CGRectMake(100, 200, 120, 120)] autorelease]; //设置图片视图显示的图片资源 imageview.defaultImage = image; //将图片视图加入整个视图当中 [self.view addSubview:imageview]; //将所有文字信息写入视图当中 CGRect frame = CGRectMake(10, 60, 300, 100); TTStyledTextLabel* label = [[[TTStyledTextLabel alloc] initWithFrame:frame] autorelease]; NSString* labelText = [NSString stringWithFormat: @"姓名：%@ 性别：%@ 地址：%@ 年龄%d" , name, sex,address,age]; label.text = [TTStyledText textFromXHTML:labelText]; label.font = [UIFont systemFontOfSize:22]; [self.view addSubview:label]; } } @end

最后欢迎各位盆友可以和MOMO一起讨论Three20软件开发，如果你觉得看得不清楚，MOMO附带上本章的源码下载，希望大家可以一起学习 哈哈～。哇咔咔～ MOMO愿和 大家好好学习，大家一起进步哈～！！！

下载地址：http://download.csdn.net/detail/xys289187120/4165817

(下载后必需搭建three20环境成功后才能运行～ 因为three20为引用加载，所以程序路径都是我本机的请见谅！或者你可可以将你的Three20路径修改的和我一样就可以直接运行啦，我的路径是：User （用户) -> Share（共享）->Three20)。