FMDB(FMDatabase)--SQLite的封装

http://note.sdo.com/u/3413430/NoteContent/d1mS~k158MiwE0c400eTi

SQLite的C API對初學者來說實在太麻煩太瑣碎，難度太高。FMDB ( FMDatabase ) 說穿了其實只是把C API包裝成簡單易用的Objective-C类。對于SQLite初學者來說，大大減低了上手的難度。有了FMDB，寫程式時只要專心在SQLite的語法上，而不用去理那堆有看沒有懂的C API，實在是件快樂的事情。

－打开／关闭资料库

使用资料库的第一件事，就是建立一个资料库。要注意的是， 在iOS环境下，只有document directory 是可以进行读写的。在写程式时用的那个Resource资料夹底下的东西都是read-only。因此，建立的资料库要放在document 资料夹下。方法如下： 

1	NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);

2	NSString *documentDirectory = [paths objectAtIndex:0];

3	NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"MyDatabase.db"];

4	FMDatabase *db = [FMDatabase databaseWithPath:dbPath] ;

5	if (![db open]) {

6	NSLog(@“Could not open db.”);

7

return ;

8

}

建立table 

如果是新建的资料库档，一开始是没有table的。建立table的方式很简单：

1	[db executeUpdate:@"CREATE TABLE PersonList (Name text, Age integer, Sex integer, Phone text, Address text, Photo blob)"];

这 是FMDB裡很常用的指令，[FMDatabase_object executeUpdate:]后面用NSString塞入SQLite语法，就解决了。因為这篇主要是在讲FMDB，所以SQLite的语法就不多说 了，上述程式码建立了一个名為PersonList的table，裡面有姓名、年龄、性别、电话、地址和照片。（嗯….很范例的一个table）

－ 插入资料

插入资料跟前面一样，用executeUpdate后面加语法就可以了。比较不同的是，因為插入的资料会跟Objective-C的变数有关，所以在string裡使用?号来代表这些变数。

1	[db executeUpdate:@"INSERT INTO PersonList (Name, Age, Sex, Phone, Address, Photo) VALUES (?,?,?,?,?,?)",

2

3	@"Jone", [NSNumber numberWithInt:20], [NSNumber numberWithInt:0], @“091234567”, @“Taiwan, R.O.C”, [NSData dataWithContentsOfFile: filepath]];

其中，在SQLite中的text对应到的是NSString，integer对应NSNumber，blob则是NSData。该做的转换FMDB都做好了，只要了解SQLite语法，应该没有什麼问题才是。

－更新资料

太简单了，不想讲，请看范例：

1	[db executeUpdate:@"UPDATE PersonList SET Age = ? WHERE Name = ?",[NSNumber numberWithInt:30],@“John”];

－取得资料

取得特定的资料，则需使用FMResultSet物件接收传回的内容：

01	FMResultSet *rs = [db executeQuery:@"SELECT Name, Age, FROM PersonList"];

02

03	while ([rs next]) {

04

05	NSString *name = [rs stringForColumn:@"Name"];

06

07	int age = [rs intForColumn:@"Age"];

08

09

}

10

11	[rs close];

用[rs next]可以轮询query回来的资料，每一次的next可以得到一个row裡对应的数值，并用[rs stringForColumn:]或[rs intForColumn:]等方法把值转成Object-C的型态。取用完资料后则用[rs close]把结果关闭。

－快速取得资料

在有些时候，只会query某一个row裡特定的一个数值（比方只是要找John的年龄），FMDB提供了几个比较简便的方法。这些方法定义在FMDatabaseAdditions.h，如果要使用，记得先import进来。

view source print

1

//找地址

2

3	NSString *address = [db stringForQuery:@"SELECT Address FROM PersonList WHERE Name = ?",@"John”];

4

5

//找年齡

6

7

int age = [db intForQuery:@"SELECT Age FROM PersonList WHERE Name = ?",@"John”]; //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// 1、首先得实例化一个FMDatabase对象，这跟Sqlitepersistentobjects 派生一个子类进行操作是不同。接着打开一个数据库(如果没有会创建一个数据库) //paths： ios下Document路径，Document为中ios可读写的文件夹 //创建数据库实例 db 这里说明下:如果路径中不存在”Test.db”的文件,sqlite会自动创建”Test.db” NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);   NSString *documentDirectory = [paths objectAtIndex:0];   //dbPath： 数据库路径，在Document中。   NSString *dbPath = [documentDirectory stringByAppendingPathComponent:@"Test.db"];       FMDatabase *db= [FMDatabase databaseWithPath:dbPath] ;   if (![db open]) {   NSLog(@“Could not open db.”);   return ;   }  接下来，我们可以通过这个数据库对象进行操作了。操作主要是update和queries。 首先是创建表。 //创建一个名为User的表，有两个字段分别为string类型的Name，integer类型的 Age [db executeUpdate:@"CREATE TABLE User (Name text, Age integer)"];  这样我们就有了一张表了。接下我们对表进行操作。插入数据!注意插入的数据使用了通配符，这跟iphone直接使用sqlite借口的绑定变量是一样的，后面的通配符匹配的数据。 //插入数据使用OC中的类型 text对应为NSString integer对应为NSNumber的整形 [db executeUpdate:@"INSERT INTO User (Name,Age) VALUES (?,?)",@"老婆",[NSNumber numberWithInt:20]] ;  接下来是更新数据。 //更新数据 将“老婆”更改为“宝贝”   [db executeUpdate:@"UPDATE User SET Name = ? WHERE Name = ? ",@"老婆",@"宝贝"];  再接下来，就是删除数据啦。 //删除数据   [db executeUpdate:@"DELETE FROM User WHERE Name = ?",@"老婆"];  update的基本操作就这几个，接下来是queries! //返回数据库中第一条满足条件的结果   NSString *aa=[db stringForQuery:@"SELECT Name FROM User WHERE Age = ?",@"20"];  这样我们就查询返回了一条数据，那当我们想要查询放返回多条数据怎么办呢?不用愁，之前我就提到了FMDB中的另外一个主要的类，FMResultSet，这是一个结果集!返回多条数据时FMDB会将数据放在这个结果集中，然后我们在对这个结果集进行查询操作!很简单。 FMResultSet *rs=[db executeQuery:@"SELECT * FROM User"];   rs=[db executeQuery:@"SELECT * FROM User WHERE Age = ?",@"20"];   while ([rs next]){   NSLog(@“%@ %@”,[rs stringForColumn:@"Name"],[rs stringForColumn:@"Age"]);   }  更多的FMResultSet方法有： intForColumn: longForColumn: longLongIntForColumn: boolForColumn: doubleForColumn: stringForColumn: dateForColumn: dataForColumn: dataNoCopyForColumn: UTF8StringForColumnIndex: objectForColumn: 具体查看一下类就行了!好了，对于FMDB的使用就这样，是不是很简单呢，其实这个些封装sqlite的框架都是万变不离其宗的，只要你掌握了sql就行了!