Three20研究院之结合第三方FMDB框架操作数据库详解（四）

最新推荐文章于 2025-11-24 15:52:13 发布

最新推荐文章于 2025-11-24 15:52:13 发布 · 127 阅读

文章标签：

本文详细介绍了FMDB数据库操作框架的使用方法，包括下载、添加源码、配置类库文件及实现增删改查功能。通过实例展示了如何使用FMDB进行数据库操作。

开始本章之间，首先了解一下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:[TTWebControllerclass]]; 

[map from:@"tt://StartView"toSharedViewController:[StartViewControllerclass]]; 

[map from:@"tt://SQLView/(initInfo:)"toViewController:[SQLViewControllerclass]]; 

[map from:@"tt://MessageView/(initInfo:)"toViewController:[MessageInfoControllerclass]]; 



if(![navigator restoreViewControllers]) 

{ 

[navigator openURLAction:[TTURLAction actionWithURLPath:@"tt://StartView"]]; 

} 

returnYES; 

} 



@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(inti =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) { 

case0: 

[navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/0"] applyAnimated:YES]]; 

break; 

case1: 

[navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/1"] applyAnimated:YES]]; 

break; 

case2: 

[navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/2"] applyAnimated:YES]]; 

break; 

case3: 

[navigator openURLAction:[[TTURLAction actionWithURLPath:@"tt://SQLView/3"] applyAnimated:YES]]; 

break; 

default: 

break; 

} 

} 

@end

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

SQLViewController.h

 
       01  #import <Three20/Three20.h> 

       02  #import "SingleDate.h" 

       03  

       04  @interface SQLViewController : TTTableViewController 

       05  { 

       06  //记录上一页点击的按钮 

       07  intpageID; 

       08  //获取单例模型的实例 

       09  SingleDate *instance; 

       10  //数据库对象 

       11  FMDatabase *db; 

       12  } 

       13  @end

SQLViewController.m

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

 
       001  #import "SQLViewController.h" 

       002  #import "FMDatabase.h" 

       003  #import "FMDatabaseAdditions.h" 

       004  

       005  #define DATABASE_NAME @"Temp.db" 

       006  

       007  @implementation SQLViewController 

       008  

       009  -(id)initInfo:(int)page 

       010  { 

       011  if(self = [super init]) { 

       012  //注解1 

       013  pageID = page; 

       014  

       015  } 

       016  returnself; 

       017  

       018  } 

       019  

       020  - (void)viewDidLoad 

       021  { 

       022  

       023  [super viewDidLoad]; 

       024  

       025  //注解2 

       026  

       027  //图片的地址 

       028  NSMutableArray *iconurls = [[[NSMutableArray alloc] initWithObjects: 

       029  @"bundle://0.jpg", 

       030  @"bundle://1.jpg", 

       031  @"bundle://2.jpg", 

       032  @"bundle://3.jpg", 

       033  nil] autorelease]; 

       034  //姓名 

       035  NSMutableArray *names = [[[NSMutableArray alloc] initWithObjects: 

       036  @"雨松MOMO", 

       037  @"RORO娃娃", 

       038  @"小老虎", 

       039  @"哇咔咔", 

       040  nil] autorelease]; 

       041  //性别 

       042  NSMutableArray *sexs = [[NSMutableArray alloc] initWithObjects: 

       043  @"男", 

       044  @"女", 

       045  @"男", 

       046  @"女", 

       047  nil]; 

       048  //地址 

       049  NSMutableArray *address = [[[NSMutableArray alloc] initWithObjects: 

       050  @"北京市朝阳区", 

       051  @"北京市西城区", 

       052  @"北京市海淀区", 

       053  @"北京市东城区", 

       054  nil] autorelease]; 

       055  

       056  //年龄 

       057  NSMutableArray *ages = [[[NSMutableArray alloc] initWithObjects: 

       058  [NSNumber numberWithInt:28], 

       059  [NSNumber numberWithInt:27], 

       060  [NSNumber numberWithInt:26], 

       061  [NSNumber numberWithInt:25], 

       062  nil] autorelease]; 

       063  

       064  //获取单例对象实例 

       065  instance = [SingleDate getInstance]; 

       066  //读取数据库 

       067  db = [instance loadDB:DATABASE_NAME]; 

       068  //结果集 

       069  FMResultSet *rs = nil; 

       070  //判断当前页面的ID 

       071  switch(pageID) 

       072  { 

       073  case0: 

       074  //注解3 

       075  if(![db tableExists:@"Message"]) 

       076  { 

       077  //创建数据库 

       078  if([db executeUpdate:@"CREATE TABLE Message (_id INTEGER PRIMARY KEY AUTOINCREMENT,IconUrl text, Name text, Sex text,Address text,Age integer)"]) 

       079  { 

       080  NSLog(@"创建表成功"); 

       081  

       082  for(inti=0 ;i<[iconurls count]; i++) 

       083  { 

       084  //遍历测试数据数组，然后将测试数据写入数据库当中 

       085  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]]) 

       086  { 

       087  NSLog(@"插入数据成功"); 

       088  

       089  } 

       090  } 

       091  } 

       092  } 

       093  //返回一个结果集 

       094  rs=[db executeQuery:@"SELECT * FROM Message"]; 

       095  break; 

       096  case1: 

       097  //判断当数据库中含有Message表时 

       098  if([db tableExists:@"Message"]) 

       099  { 

       100  //注释4 

       101  if([db executeUpdate:@"UPDATE Message SET Name = ? WHERE _id = ? ", @"雨松MOMO（已修改）",[NSNumber numberWithInt:1]]) 

       102  { 

       103  NSLog(@"更新一个数据成功"); 

       104  

       105  } 

       106  

       107  if([db executeUpdate:@"UPDATE Message SET Name = ? , Sex = ? , Address = ? WHERE _id = ? ", @"雨松MOMO（已修改）",@"男（已修改）",@"北京市朝阳区（已修改）",[NSNumber numberWithInt:1]]) 

       108  { 

       109  NSLog(@"更新多条数据成功"); 

       110  

       111  } 

       112  } 

       113  //返回一个结果集 

       114  rs=[db executeQuery:@"SELECT * FROM Message"]; 

       115  break; 

       116  case2: 

       117  //判断当数据库中含有Message表时 

       118  if([db tableExists:@"Message"]) 

       119  { 

       120  //删除数据 

       121  if([db executeUpdate:@"DELETE FROM Message WHERE _id = ?",[NSNumber numberWithInt:2]]) 

       122  { 

       123  NSLog(@"删除数据成功"); 

       124  } 

       125  

       126  } 

       127  //返回一个结果集 

       128  rs=[db executeQuery:@"SELECT * FROM Message"]; 

       129  break; 

       130  case3: 

       131  //返回一个结果集 

       132  rs=[db executeQuery:@"SELECT * FROM Message WHERE _id = ? ",[NSNumber numberWithInt:3]]; 

       133  break; 

       134  

       135  default: 

       136  break; 

       137  } 

       138  

       139  NSMutableArray * array = [[[NSMutableArray alloc]init] autorelease]; 

       140  //注释5 

       141  while([rs next]) 

       142  { 

       143  [array addObject:[TTTableImageItem itemWithText:[rs stringForColumn:@"Name"] 

       144  imageURL:[rs stringForColumn:@"IconUrl"] 

       145  URL:[NSString stringWithFormat: @"%@%@", @"tt://MessageView/", [rs stringForColumn:@"_id"]]]]; 

       146  } 

       147  //用完以后一定要关闭 

       148  [rs close]; 

       149  

       150  //设置列表自适应高度 

       151  self.variableHeightRows = YES; 

       152  //设置列表现实的数据 

       153  self.dataSource = [TTSectionedDataSource dataSourceWithArrays:@"当前数据库信息",array,nil]; 

       154  } 

       155  

       156  @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 



staticSingleDate *instance = nil; 



//获取单例 

+(SingleDate *)getInstance 

{ 

@synchronized(self) 

{ 

if(instance == nil) 

{ 

instance = [[self alloc] init]; 

} 

} 

returninstance; 

} 



//读取数据库 

-(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(@"数据库未能创建/打开"); 

returnnil; 

} 



returndb; 

} 

@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 

intsqlID; 

//单例对象 

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; 



} 

returnself; 



} 



- (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"]; 

//获取年龄 

intage = [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