【轉】iOS開發24：使用SQLite3儲存和讀取資料

標籤：

轉自：http://my.oschina.net/plumsoft/blog/57626

SQLite3是嵌入在iOS中的關係型資料庫，對於儲存大規模的資料很有效。SQLite3使得不必將每個對象都加到記憶體中。

基本操作：

（1）開啟或者建立資料庫

sqlite3 *database;int result = sqlite3_open("/path/databaseFile", &database);

 

 

如果/path/databaseFile不存在，則建立它，否則開啟它。如果result的值是SQLITE_OK，則表明我們的操作成功。

注意上述語句中資料庫檔案的地址字串前面沒有@字元，它是一個C字串。將NSString字串轉成C字串的方法是：

const char *cString = [nsString UTF8String];

 

 

（2）關閉資料庫

sqlite3_close(database);

 

 

（3）建立一個表格

char *errorMsg;const char *createSQL = "CREATE TABLE IF NOT EXISTS PEOPLE (ID INTEGER PRIMARY KEY AUTOINCREMENT, FIELD_DATA TEXT)";int result = sqlite3_exec(database, createSQL, NULL, NULL, &errorMsg);

 

 

執行之後，如果result的值是SQLITE_OK，則表明執行成功；否則，錯誤資訊儲存在errorMsg中。

sqlite3_exec這個方法可以執行那些沒有返回結果的操作，例如建立、插入、刪除等。

（4）查詢操作

NSString *query = @"SELECT ID, FIELD_DATA FROM FIELDS ORDER BY ROW";sqlite3_stmt *statement;int result = sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil);

 

 

如果result的值是SQLITE_OK，則表明準備好statement，接下來執行查詢：

 

while (sqlite3_step(statement) == SQLITE_ROW) {    int rowNum = sqlite3_column_int(statement, 0);    char *rowData = (char *)sqlite3_column_text(statement, 1);    NSString *fieldValue = [[NSString alloc] initWithUTF8String:rowData];    // Do something with the data here}sqlite3_finalize(statement);

 

使用過其他資料庫的話應該很好理解這段語句，這個就是依次將每行的資料存在statement中，然後根據每行的欄位取出資料。 

 

（5）使用約束變數

實際操作時經常使用叫做約束變數的東西來構造SQL字串，從而進行插入、查詢或者刪除等。

例如，要執行帶兩個約束變數的插入操作，第一個變數是int類型，第二個是C字串：

char *sql = "insert into oneTable values (?, ?);";sqlite3_stmt *stmt;if (sqlite3_prepare_v2(database, sql, -1, &stmt, nil) == SQLITE_OK) {    sqlite3_bind_int(stmt, 1, 235);    sqlite3_bind_text(stmt, 2, "valueString", -1, NULL);}if (sqlite3_step(stmt) != SQLITE_DONE)    NSLog(@"Something is Wrong!");sqlite3_finalize(stmt);

 

 

這裡，sqlite3_bind_int(stmt, 1, 235);有三個參數：

第一個是sqlite3_stmt類型的變數，在之前的sqlite3_prepare_v2中使用的。

第二個是所約束變數的標籤index。

第三個參數是要加的值。

有一些函數多出兩個變數，例如

sqlite3_bind_text(stmt, 2, "valueString", -1, NULL);

 

 

這句，第四個參數代表第三個參數中需要傳遞的長度。對於C字串來說，-1表示傳遞全部字串。

第五個參數是一個回呼函數，比如執行後做記憶體清除工作。

接下來，做個小例子吧！

1、運行Xcode 4.3，建立一個Single View Application，名稱為SQLite3 Test：

2、串連SQLite3庫：

按照中的紅色數位順序找到加號：

單擊這個加號，開啟視窗，在搜尋欄輸入sqlite3：

選擇libsqlite3.dylib，單擊Add，添加到工程。

3、進行介面設計。開啟ViewController.xib，使用Interface Builder設計介面如下：

設定四個文字框的tag分別是1、2、3、4。

4、在ViewController.h中添加屬性和方法：

@property (copy, nonatomic) NSString *databaseFilePath;- (void)applicationWillResignActive:(NSNotification *)notification;

 

 

5、開啟ViewController.m，向其中添加代碼：

5.1 在開頭添加代碼：

#import "sqlite3.h"#define kDatabaseName @"database.sqlite3"

 

 

5.2 在@implementation之後添加代碼：

@synthesize databaseFilePath;

 

 

5.3 在viewDidLoad方法中添加代碼：

- (void)viewDidLoad{    [super viewDidLoad];    // Do any additional setup after loading the view, typically from a nib.    //擷取資料庫檔案路徑    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);    NSString *documentsDirectory = [paths objectAtIndex:0];    self.databaseFilePath = [documentsDirectory stringByAppendingPathComponent:kDatabaseName];    //開啟或建立資料庫    sqlite3 *database;    if (sqlite3_open([self.databaseFilePath UTF8String] , &database) != SQLITE_OK) {        sqlite3_close(database);        NSAssert(0, @"開啟資料庫失敗！");    }    //建立資料庫表    NSString *createSQL = @"CREATE TABLE IF NOT EXISTS FIELDS (TAG INTEGER PRIMARY KEY, FIELD_DATA TEXT);";    char *errorMsg;    if (sqlite3_exec(database, [createSQL UTF8String], NULL, NULL, &errorMsg) != SQLITE_OK) {        sqlite3_close(database);        NSAssert(0, @"建立資料庫表錯誤: %s", errorMsg);    }    //執行查詢    NSString *query = @"SELECT TAG, FIELD_DATA FROM FIELDS ORDER BY TAG";    sqlite3_stmt *statement;    if (sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil) == SQLITE_OK) {        //依次讀取資料庫表格FIELDS中每行的內容，並顯示在對應的TextField        while (sqlite3_step(statement) == SQLITE_ROW) {            //獲得資料            int tag = sqlite3_column_int(statement, 0);            char *rowData = (char *)sqlite3_column_text(statement, 1);            //根據tag獲得TextField            UITextField *textField = (UITextField *)[self.view viewWithTag:tag];            //設定文本            textField.text = [[NSString alloc] initWithUTF8String:rowData];        }        sqlite3_finalize(statement);    }    //關閉資料庫    sqlite3_close(database);    //當程式進入後台時執行寫入資料庫操作    UIApplication *app = [UIApplication sharedApplication];    [[NSNotificationCenter defaultCenter]     addObserver:self     selector:@selector(applicationWillResignActive:)     name:UIApplicationWillResignActiveNotification     object:app];}

 

 

5.4 在@end之前實現方法：

//程式進入後台時的操作，實現將當前顯示的資料寫入資料庫- (void)applicationWillResignActive:(NSNotification *)notification {    //開啟資料庫    sqlite3 *database;    if (sqlite3_open([self.databaseFilePath UTF8String], &database)        != SQLITE_OK) {        sqlite3_close(database);        NSAssert(0, @"開啟資料庫失敗！");    }    //向表格插入四行資料    for (int i = 1; i <= 4; i++) {         //根據tag獲得TextField        UITextField *textField = (UITextField *)[self.view viewWithTag:i];        //使用約束變數插入資料        char *update = "INSERT OR REPLACE INTO FIELDS (TAG, FIELD_DATA) VALUES (?, ?);";        sqlite3_stmt *stmt;        if (sqlite3_prepare_v2(database, update, -1, &stmt, nil) == SQLITE_OK) {            sqlite3_bind_int(stmt, 1, i);            sqlite3_bind_text(stmt, 2, [textField.text UTF8String], -1, NULL);        }        char *errorMsg = NULL;        if (sqlite3_step(stmt) != SQLITE_DONE)            NSAssert(0, @"更新資料庫表FIELDS出錯: %s", errorMsg);        sqlite3_finalize(stmt);    }    //關閉資料庫    sqlite3_close(database);}

 

 

6、實現關閉鍵盤，參考《iOS開發4：關閉鍵盤》中的第2步。其中，backgroundTap方法如下：

//關閉鍵盤- (IBAction)backgroundTap:(id)sender {    for (int i = 1; i <= 4; i++) {        UITextField *textField = (UITextField *)[self.view viewWithTag:i];        [textField resignFirstResponder];    }}

 

 

7、運行程式：

剛運行時顯示如下面左圖：

   

在各個文字框輸入內容，如上面右圖。然後按Home鍵，這樣，就執行了寫入資料的操作。

第一次運行程式時，在SandBox的Documents目錄下出現資料庫檔案database.sqlite3：

此時退出程式，再次運行，則顯示的就是上次退出時的值。

【轉】iOS開發24：使用SQLite3儲存和讀取資料