iOS嵌入式數據庫SQLite3使用簡析

作者：HDDevTeam 2013-04-09 16:47:19

SQLite，是一款輕型的數據庫，是遵守ACID的關聯式數據庫管理系統，它的設計目標是嵌入式的，而且目前已經在很多嵌入式產品中使用了它，它占用資源非常的低，在嵌入式設備中，可能只需要幾百K的內存就夠了。它能夠支持Windows/Linux/Unix等等主流的操作系統，同時能夠跟很多程序語言相結合，比如 Tcl、C#、PHP、Java等，還有ODBC接口，同樣比起Mysql、PostgreSQL這兩款開源世界著名的數據庫管理系統來講，它的處理速度比他們都快。SQLite第一個Alpha版本誕生于2000年5月。至今已經有12個年頭，SQLite也迎來了一個版本 SQLite 3已經發布。

1. Sqlite3數據類型及存儲類

每個存放在sqlite數據庫中（或者由這個數據庫引擎操作）的值都有下面中的一個存儲類：

（1）NULL，值是NULL

（2）INTEGER，值是有符號整形，根據值的大小以1,2,3,4,6或8字節存放

（3）REAL，值是浮點型值，以8字節IEEE浮點數存放

（4）TEXT，值是文本字符串，使用數據庫編碼（UTF-8，UTF-16BE或者UTF-16LE）存放

（5）BLOB，只是一個數據塊，完全按照輸入存放（即沒有準換）

注：①Sqlite沒有單獨的布爾存儲類型，它使用INTEGER作為存儲類型，0為false，1為true

②Sqlite沒有另外為存儲日期和時間設定一個存儲類集，內置的sqlite日期和時間函數能夠將日期和時間以TEXT，REAL或INTEGER形式存放

TEXT 作為IS08601字符串（"YYYY-MM-DD HH:MM:SS.SSS"）
REAL 從格林威治時間11月24日，4174 B.C中午以來的天數
INTEGER 從 1970-01-01 00:00:00 UTC以來的秒數

2. Sqlite3函數功能簡介

1)基本函數及結構體

sqlite3        *pdb //數據庫句柄，跟文件句柄FILE很類似
sqlite3_stmt *stmt //這個相當于ODBC的Command對象，用于保存編譯好的SQL語句
sqlite3_open()      //打開數據庫
sqlite3_exec()      //執行非查詢的sql語句
sqlite3_prepare()   //準備sql語句，執行select語句或者要使用parameter bind時，用這個函數（封裝了sqlite3_exec）.
sqlite3_step()       //在調用sqlite3_prepare后，使用這個函數在記錄集中移動。
sqlite3_close()     //關閉數據庫文件

2）綁定函數

int sqlite3_bind_null(sqlite3_stmt*, int);
int sqlite3_bind_int(sqlite3_stmt*, int, int);
int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));
int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));

3）取值函數
sqlite3_column_text(), 取text類型的數據
sqlite3_column_blob()，取blob類型的數據
sqlite3_column_int(), 取int類型的數據

3. Sqlite3使用步驟

1) 首先獲取iPhone上Sqlite 3 的數據庫文件的地址
2) 打開Sqlite 3 的數據庫文件
3) 定義SQL文
4) 邦定執行SQL所需要的參數
5) 執行SQL文，并獲取結果
6) 釋放資源
7) 關閉Sqlite 3 數據庫。

4. Sqlite3數據操作

由于整個例子代碼比較繁瑣，這里只列出數據庫操作的部分代碼作為參考：

1.添加開發包libsqlite3.0.dylib

首先是設置項目文件，在項目中添加iPhone版的sqlite3的數據庫的開發包，在項目下的Frameworks點擊右鍵，然后選擇libsqlite3.0.dylib文件。

libsqlite3.0.dylib文件地址:

/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS2.2.sdk/usr/lib/libsqlite3.0.dylib

2.獲取sqlite3的數據庫文件地址：

//數據庫路徑  
-(NSString*)databasePath  
{ 
NSArray *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  
NSString *pathname = [path objectAtIndex:0];  
return [pathname stringByAppendingPathComponent:@”database.sqlite3”];  
}

3.打開數據庫

- (BOOL)openDatabase  
  
{  
    if (sqlite3_open([[self databasePath] UTF8String],&database) != SQLITE_OK)  
    {  
        sqlite3_close(database);  
        printf("failed to open the database");  
        return NO; 
} 
else   
    {  
        printf("open the database successfully");  
        return YES;  
    } 
}

4.創建表

//創建TimerTable表  
  
- (BOOL)createTimerTable  
{  
    if ([self openDatabase]==YES) 
    {  
        char *erroMsg;  
        NSString *createSQL = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS %@(timerid INTEGER PRIMARY KEY AUTOINCREMENT,time INTEGER,remaintime INTEGER,iconuri BLOB,vibrate INTEGER,status INTEGER,message TEXT)",TableName];  
        if (sqlite3_exec(database, [createSQL UTF8String], NULL, NULL, &erroMsg)!= SQLITE_OK) 
        {  
            sqlite3_close(database);  
            printf("create table faild");  
            return NO;  
        }  
        else  
        {  
            printf("table was created");  
            return YES;  
        } 
    }  
    else  
        return NO; 
}

5.添加數據

//添加Timer  
  
- (BOOL)insertTimer:(TimerInfo *)timerInfo  
{    
    bool isOpen=[self openDatabase];  
    if (isOpen!=YES)  
{  
      return NO;  
    }  
    sqlite3_stmt *statement;  
    static char *insertTimerSql="INSERT INTO TimerTable(time,remaintime,iconuri,vibrate,status,message,type) VALUES (?,?,?,?,?,?)";  
    if (sqlite3_prepare_v2(database,insertTimerSql,-1,&statement,NULL)!= SQLITE_OK)  
    {  
        NSLog(@"Error:Failed to insert timer");  
        return NO;  
    }  
    sqlite3_bind_int(statement,1,timerInfo.time);//timerInfo是一個封裝了相關屬性的實體類對象  
    sqlite3_bind_int(statement,2,timerInfo.remainTime);  
    sqlite3_bind_text(statement,3,[timerInfo.iconuri UTF8String],-1,SQLITE_TRANSIENT);  
    sqlite3_bind_int(statement,4,timerInfo.vibrate);  
    sqlite3_bind_int(statement,5,timerInfo.status);  
    sqlite3_bind_text(statement,6,[timerInfo.message UTF8String],-1,SQLITE_TRANSIENT);  
    int success=sqlite3_step(statement);  
    sqlite3_finalize(statement);  
    if(success==SQLITE_ERROR)  
    {  
        NSLog(@"Error:fail to insert into the database with message.");  
        return NO;  
    }  
    NSLog(@"inserted one timer");  
    return YES;  
}

6.查詢數據

//查詢數據庫中所有的TimerInfo，返回一個包含所有TimerInfo的可變數組  
  
-(NSMutableArray *)getAllTimers  
{  
    NSMutableArray *arrayTimers=[[NSMutableArray alloc] init];  
    NSString *queryStr=@"SELECT * FROM TimerTable";  
    sqlite3_stmt *statement;  
    if (sqlite3_prepare_v2(database, [queryStr UTF8String], -1, &statement, NULL)!=SQLITE_OK)  
    {  
        printf("Failed to get all timers!\n");    
    }  
    else  
    {  
        while (sqlite3_step(statement)==SQLITE_ROW)  
        {  
            TimerInfo *timerInfo=[[TimerInfo alloc] init]; 
            timerInfo.timerId =sqlite3_column_int(statement,0); 
            timerInfo.time =sqlite3_column_int(statement,1);  
            timerInfo.remainTime=sqlite3_column_int(statement,2);  
            timerInfo.vibrate =sqlite3_column_int(statement,4); 
            timerInfo.status = sqlite3_column_int(statement,5);  
            char *messageChar=sqlite3_column_text(statement,6); 
            if (messageChar==NULL)  
                timerInfo.message=nil;  
            else  
                timerInfo.message =[NSString stringWithUTF8String:messageChar];  
            [arrayTimers addObject:timerInfo];  
            [timerInfo release];  
        }  
    }  
    sqlite3_finalize(statement);  
    NSLog(@"arrayTimersCount: %i",[arrayTimers count]); 
    return arrayTimers; 
}

此外，還有數據庫數據的更新及其刪除操作就不再依依列出，它們之間只是執行的SQL文不同，其他部分的代碼較為類似。

運行效果：（具體頁面控件及事件：略）

在這里只是做下小結，其中難免有說的不對的地方，所以希望大家多多給予指正。

責任編輯：閆佳明來源： blog.51cto

iOS 嵌入式數據庫SQLite3使用