您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 中的 SQLite 資料庫操作完全指南

編輯:iOS 開發綜合

iPhone 可以透過 sqlite3 這個輕量的關聯式資料庫來存取本地資料。本文從環境配置到增刪改查,完整梳理在 iOS 中使用 SQLite 的各個環節。

第一步:加入資料庫開發套件

首先在專案中引入 iPhone 版的 sqlite3 資料庫開發套件。在專案的 Frameworks 目錄上按右鍵,選擇加入 libsqlite3.0.dylib 即可。

核心操作流程

整體操作可以濃縮為以下七個步驟:

1. 取得資料庫檔案路徑

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *path = [documentsDirectory stringByAppendingPathComponent:@"database_name"];

2. 開啟資料庫

sqlite3 *database;
sqlite3_open([path UTF8String], &database);

3. 準備 SQL 語句

sqlite3_stmt *stmt;
const char *sql = "SELECT * FROM table_name WHERE pk=? and name=?";
sqlite3_prepare_v2(database, sql, -1, &stmt, NULL);

4. 綁定參數

sqlite3_bind_int(stmt, 1, 1);
sqlite3_bind_text(stmt, 2, [title UTF8String], -1, SQLITE_TRANSIENT);

5. 執行 SQL

sqlite3_step(stmt);

6. 釋放語句資源

sqlite3_finalize(stmt);

7. 關閉資料庫

sqlite3_close(database);

兩個關鍵結構與五個主要函式

要掌握 SQLite,先記住兩個結構體與五個核心函式:

sqlite3 *pdb 是資料庫句柄,概念上類似檔案句柄 FILE;sqlite3_stmt *stmt 則類似 ODBC 中的 Command 物件,用來保存編譯好的 SQL 語句。

  • sqlite3_open():開啟資料庫
  • sqlite3_exec():執行非查詢類的 SQL 語句
  • sqlite3_prepare():準備 SQL 語句,執行 select 或需要使用參數綁定時使用(封裝了 sqlite3_exec)
  • sqlite3_step():在呼叫 sqlite3_prepare 後,用它逐筆移動記錄集
  • sqlite3_close():關閉資料庫檔案

此外還有一系列用來從記錄集欄位取值的函式,例如 sqlite3_column_text()(取文字)、sqlite3_column_blob()(取 blob)、sqlite3_column_int()(取整數)等。

PreparedStatement 方式的執行流程

這種方式的特點是可以綁定參數、逐筆產生結果,執行起來有點像 ADO,每次返回一行。

先建立 statement 物件:

int sqlite3_prepare(
   sqlite3 *db,               /* Database handle */
   const char *zSql,          /* SQL statement, UTF-8 encoded */
   int nBytes,                /* Length of zSql in bytes. */
   sqlite3_stmt **ppStmt,     /* OUT: Statement handle */
   const char **pzTail        /* OUT: Pointer to unused portion of zSql */
);

接著綁定參數 sqlite3_bind_xxxx(sqlite3_stmt*, int, ...),第二個參數表示參數在 SQL 中的序號(從 1 開始),第三個參數是要綁定的值。對 blob 與 text 類型,第四個參數是長度(不含結尾),第五個參數是 SQLite 處理結束後用於清理字串的函式。未綁定的未知參數會被視為 NULL。

執行過程使用 sqlite3_step(sqlite3_stmt*),常見返回值包括:

  • SQLITE_BUSY:資料庫被鎖定,需等待重試
  • SQLITE_DONE:成功執行完畢
  • SQLITE_ROW:返回一行結果,可搭配 sqlite3_column_xxx 取值
  • SQLITE_ERROR:執行錯誤,可參考 sqlite3_errmsg
  • SQLITE_MISUSE:函式使用不當(通常是未正確初始化)

結束時用 sqlite3_finalize() 清理 statement,用 sqlite3_reset() 可將 statement 重置到未執行狀態(綁定參數不變)。

實戰:完整的增刪改查

取得資料庫路徑:

- (NSString *)getDataBasePath {
    NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];
    NSString *filePath = [path stringByAppendingPathComponent:@"database.db"];
    return filePath;
}

開啟資料庫(檔案不存在時系統會自動建立):

- (void)openDatabase {
    NSString *filePath = [self getDataBasePath];
    const char *filename = [filePath UTF8String];
    sqlite3 *db = nil;
    int rc = sqlite3_open(filename, &db);
    if (rc != SQLITE_OK) {
        sqlite3_close(db);
        NSAssert(NO, @"資料庫開啟失敗,請檢查檔案路徑");
    } else {
        NSLog(@"資料庫開啟成功");
    }
}

建立資料表:

- (IBAction)createTable:(id)sender {
    [self openDatabase];
    NSString *createSql = @"CREATE TABLE ContactTable (name TEXT, phone TEXT)";
    char *errmsg = nil;
    int rc = sqlite3_exec(_database, [createSql UTF8String], NULL, NULL, &errmsg);
    if (rc != SQLITE_OK) {
        NSLog(@"資料表建立失敗");
    } else {
        NSLog(@"資料表建立成功");
    }
    sqlite3_close(_database);
}

插入資料(使用 ? 作為佔位符,再逐一綁定):

- (IBAction)insertData:(id)sender {
    [self openDatabase];
    NSString *insertSql = @"INSERT INTO ContactTable VALUES(?,?)";
    sqlite3_stmt *stmt = nil;
    int rc = sqlite3_prepare_v2(_database, [insertSql UTF8String], -1, &stmt, NULL);
    if (rc == SQLITE_OK) {
        NSString *name = @"zhangsan";
        NSString *phone = @"電話號碼";
        sqlite3_bind_text(stmt, 1, [name UTF8String], strlen([name UTF8String]), NULL);
        sqlite3_bind_text(stmt, 2, [phone UTF8String], strlen([phone UTF8String]), NULL);
        int step = sqlite3_step(stmt);
        if (step == SQLITE_DONE) {
            NSLog(@"插入資料成功");
        } else {
            NSLog(@"插入資料失敗____%s", sqlite3_errmsg(_database));
        }
        sqlite3_finalize(stmt);
    }
    sqlite3_close(_database);
}

刪除資料:

- (IBAction)deleteData:(id)sender {
    [self openDatabase];
    NSString *deleteSql = @"DELETE FROM ContactTable WHERE name = 'zhangsan'";
    sqlite3_stmt *stmt = NULL;
    int rc = sqlite3_prepare_v2(_database, [deleteSql UTF8String], strlen([deleteSql UTF8String]), &stmt, NULL);
    if (rc == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_DONE) {
            NSLog(@"資料刪除完成");
        }
        sqlite3_finalize(stmt);
    }
    sqlite3_close(_database);
}

修改資料:

- (IBAction)upDateData:(id)sender {
    [self openDatabase];
    NSString *updateSql = @"UPDATE ContactTable SET phone = '18909091234' WHERE ROWID = 1";
    sqlite3_stmt *stmt = NULL;
    int rc = sqlite3_prepare_v2(_database, [updateSql UTF8String], -1, &stmt, NULL);
    if (rc == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_DONE) {
            NSLog(@"資料更新成功");
        } else {
            NSLog(@"資料更新失敗");
        }
        sqlite3_finalize(stmt);
    }
    sqlite3_close(_database);
}

查詢資料(用 while 迴圈逐筆讀取):

- (IBAction)queryData:(id)sender {
    NSMutableArray *mArray = [NSMutableArray array];
    [self openDatabase];
    NSString *querySql = @"SELECT * FROM ContactTable";
    sqlite3_stmt *stmt = NULL;
    int rc = sqlite3_prepare_v2(_database, [querySql UTF8String], -1, &stmt, NULL);
    if (rc == SQLITE_OK) {
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            char *name = (char *)sqlite3_column_text(stmt, 0);
            char *phone = (char *)sqlite3_column_text(stmt, 1);
            NSString *nameStr = [[NSString alloc] initWithUTF8String:name];
            NSString *phoneStr = [[NSString alloc] initWithUTF8String:phone];
            [mArray addObject:nameStr];
            [mArray addObject:phoneStr];
        }
        sqlite3_finalize(stmt);
    }
    for (id object in mArray) {
        NSLog(@"取出的資料為____%@", object);
    }
    sqlite3_close(_database);
}

掌握這些基本操作後,你就能在 iOS 中靈活地管理本地資料了。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved