前言

近期一個(gè)項(xiàng)目中需要實(shí)現(xiàn)離線存儲(chǔ)，在線同步的功能。調(diào)研了兩種實(shí)現(xiàn)方案:

• CoreData: iOS 技術(shù)棧中提供的對(duì)象管理技術(shù)。對(duì)象關(guān)系，內(nèi)存管理，undo/redo,本地存儲(chǔ)等功能。
• FMDB(https://github.com/ccgus/fmdb)： 僅專注于Database層, 對(duì)iOS SDK中的SQLite接口做了封裝。使用FMDB操作SQLite非常方便,在API方面跟跟JDBC非常類似。

這里先給一個(gè)FMDB的showcase:

NSString* docsdir = [NSSearchPathForDirectoriesInDomains( NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *dbpath = [docsdir stringByAppendingPathComponent:@"dyobv.sqlite"];    

FMDatabase *db = [FMDatabase databaseWithPath:dbpath];  
[db open];    

FMResultSet *rs = [db executeQuery:@"select * from log_keepers"];

NSMutableArray *array = [NSMutableArray arrayWithCapacity:32];
while([rs next]) {
    DYLogKeeper *obj = [[DYLogKeeper alloc] init];  
    obj.localId = [rs stringForColumn:@"local_id"];
    // … 省略賦值操作
    
    [array addObject: obj];
}
[db close];    

從代碼中看，F(xiàn)MDB更適合平時(shí)編程習(xí)慣。 FMDB有ARC，非ARC，使用方面回不有任何阻礙。

使用說明

FMDB技術(shù)使用已經(jīng)有非常優(yōu)秀的教程，這里提供兩個(gè)傳送門：

1. 《在iOS開發(fā)中使用FMDB》: http://blog.devtang.com/blog/2012/04/22/use-fmdb/
2. 官方文檔: https://github.com/ccgus/fmdb

推薦工具

MesaSQLite(http://www.desertsandsoftware.com/wordpress/?page_id=17)，這個(gè)工具是Mac OS X上的原生App，支持文件拖拽操作, 比FireFox Sql Manager插件好用很多。

如何調(diào)試

調(diào)試sqlite時(shí)需要在Simulator環(huán)境下進(jìn)行。啟動(dòng)項(xiàng)目后，使用MesaSQLite打開Mac OS X上的sqlite文件。

具體步驟如下:

1. 創(chuàng)建數(shù)據(jù)庫時(shí)將路徑輸出:

    NSString* docsdir = [NSSearchPathForDirectoriesInDomains( NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *dbpath = [docsdir stringByAppendingPathComponent:@"dyobv.sqlite"];  
    NSLog("--databasePath: %@", dbpath); //輸出的地址就是dyobv.sqlite的路徑    

2. 在Console中找到sqlite文件路徑(路徑是隱藏文件夾)，然后后在Terminal中使用open指令打開。

實(shí)戰(zhàn)中的問題

創(chuàng)建數(shù)據(jù)庫表

1. 在MesaSQLite設(shè)計(jì)器中創(chuàng)建表結(jié)構(gòu)，然后將生成的sql復(fù)制出來使用。這樣可以避免手敲代碼產(chǎn)生的錯(cuò)誤。
2. 將sql保存成文件，然后放到xcode工程中。 這里我會(huì)在Supportting files創(chuàng)建一個(gè)sql分組，將所有sql文件放到這里。
3. 使用下面語句將sql語句讀入到NSString中:

    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"log_keepers_table" ofType:@"sql"];
    NSError *error;
    NSString *sql = [NSString stringWithContentsOfFile:filePath encoding:NSUTF8StringEncoding error:&error];       

4. 調(diào)用 [db executeupdate:sql] 建表

為什么要將sql放到文件中? 先看一段建表的sql:

CREATE TABLE "log_keepers" (
    "local_id" varchar(36) PRIMARY KEY NOT NULL  UNIQUE ,
    "logkeeper_id" varchar(36),
    "add_time" DATETIME NOT NULL ,
    "content" VARCHAR(256),
    "device_id" VARCHAR(36) NOT NULL ,
    "device_type" INTEGER NOT NULL ,
    "channel" INTEGER NOT NULL
)    

將這段sql直接放到NSString中，代碼將非常難閱讀。將sql放到文件中，然后用帶代碼高亮的工具進(jìn)行編輯，出了方便閱讀，還可以解決xcode不支持sql語法高亮的問題。

如何判斷表是否已經(jīng)存在?

SQLite中沒有 if exists 語句, 需要使用如下代碼判斷:

FMDatabase *db = [[DYDB sharedDB] connect];//DYDB是我自己封裝的工具類

NSString *existsSql = [NSString stringWithFormat:@"select count(name) as countNum from sqlite_master where type = 'table' and name = '%@'", @"log_keepers" ];
NSLog(@"%@", existsSql);

FMResultSet *rs = [db executeQuery:existsSql];

if ([rs next]) {
    NSInteger count = [rs intForColumn:@"countNum"];
    NSLog(@"The table count: %d", count);
    if (count == 1) {
        NSLog(@"log_keepers table is existed.");
        return;
    }
    
    NSLog(@"log_keepers is not existed.");
}

[rs close];

什么時(shí)候創(chuàng)建表?

建表操作放到AppDelegate中，在程序啟動(dòng)時(shí)先檢測(cè)表是否存在，如果不存在則創(chuàng)建表結(jié)構(gòu)：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
//  RKLogConfigureByName("RestKit", RKLogLevelWarning);
//  RKLogConfigureByName("RestKit/ObjectMapping", RKLogLevelTrace);
    RKLogConfigureByName("RestKit/Network", RKLogLevelTrace);
    
    DLog(@"initialize database... ");
    [DYLogKeeper createSqliteTable];
    [DYSyncItem createSqliteTable];
    
    return YES;
}    

本文中涉及的代碼段

FMDB基本使用: https://gist.github.com/lvjian700/6113564