在ios使用sqlite的救贖 - FMDB

最近有個專案需要小型資料庫，當然首選一定是iOS內建的sqlite，但是因為他是C的lib，使用上是出了名的困難。之前就有聽說用sqlite可以使用FMDB這個objective-c wrapper library。果不其然的簡單易用，我馬上把我使用經驗跟大家分享，如果你想馬上體驗，也可以去抓我的Sample project - MySqlite。

安裝FMDB
方法很簡單，就跟所有的open source library一樣的三步驟。
1. 首先你要先把 libsqlite3.dylib 加進library
2. 在需要用到FMDB的檔案中#import "FMDatabase.h"
3. 把FMDB的.h跟.m加進你的project中
接著就可以開心的使用FMDB

產生Database
基本上就是透過+[FMDatabase databaseWithPath]取產生Database instance。

NSURL *appUrl = [[[NSFileManager defaultManager] 
     URLsForDirectory:NSDocumentDirectory 
            inDomains:NSUserDomainMask] lastObject];
NSString *dbPath = [[appUrl path] stringByAppendingPathComponent:@"MyDatabase.db"];   
FMDatabase* db = [FMDatabase databaseWithPath:dbPath];

if (![db open]) {       
 NSLog(@"Could not open db");       
}

產生所需table
其實寫過sql的應該對接下來的動作都不陌生，都一樣就是sql語法囉，詳細的請參考sqlite文件
下面的動作是產生一個user的table，並且有uid, name, descritpion三個column。我們使用IF NOT EXISTS來保證table不存在才會產生table。

if(![db executeUpdate:@"CREATE TABLE IF NOT EXISTS user (uid integer primary key asc autoincrement, name text, description text)"])
{
 NSLog(@"Could not create table: %@", [db lastErrorMessage]);
}

新增record
在FMDB中，它有提供很貼心類似-[NSString stringWithFormat:...]的功能，但是比較不一樣的是如果你是字串，它會幫你加上括號，使用上更為便利。

if(![db executeUpdate:@"INSERT INTO user (name, description) VALUES (?,?)", name, description])
{
 NSLog(@"Could not insert data: %@", [db lastErrorMessage]);
}

刪除record
一樣是下sql語法，這邊比較需要注意的是如果你要傳進去的是int, double這種基本形態，記得要轉換成物件，也就是用+[NSNumber numberWithInt]去轉換

if(![_db executeUpdate:@"DELETE FROM user WHERE uid = ?", [NSNumber numberWithInt:uid]])
{
 NSLog(@"Could not delete data: %@", [db lastErrorMessage]);
}

查詢資料
在FMDB中有提供另外一個class FMResultSet來存放查詢出來的records，透過-[FMResultSet next]來iterate出所有的record

NSMutableArray* items = [NSMutableArray arrayWithCapacity:0];
FMResultSet *rs = [db executeQuery:@"SELECT uid, name, description from user"];

while ([rs next]) {       
 int uid = [rs intForColumn:@"uid"];
 NSString *name = [rs stringForColumn:@"name"];       
 NSString *description = [rs stringForColumn:@"description"];       
   
 [items addObject:[NSDictionary dictionaryWithObjectsAndKeys:
       [NSNumber numberWithInt:uid], @"uid",
       name, @"name",
       description, @"description",
       nil]];
}

[rs close];   

基本上在其他oo平台中有用過sql的，對於FMDB的設計應該並不陌生，可以說完全不會有太多的困難。而相較於用傳統的plist或是archive的方法，我相信不管是效能上或是功能上，Sqlite+FMDB的組合絕對會更有優勢。對於中型以上的iOS程式應該會是標準配備。