您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS SQLite 原生用法詳解:打開、建表、插入與查詢的每一個步驟

編輯:iOS 相關教學

以下完整示範 iOS 中以原生 sqlite3 API 操作資料庫的各個環節,包含開啟、建表、插入與查詢。

#import <sqlite3.h>

@interface ViewController ()
{
    sqlite3 *_sqldb;
}
@end

@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
    [self OpenDb];
    [self createTable];
    [self insertData];
    [self FindData];
}

// 打開資料庫
- (void)OpenDb
{
    NSArray *arrs = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    // 資料庫不存在時會建立,存在時直接打開
    NSString *path = [arrs lastObject];
    NSString *documentpath = [path stringByAppendingPathComponent:@"sql.db"];

    int reslut = sqlite3_open([documentpath UTF8String], &_sqldb);
    if (reslut == SQLITE_OK) {
        NSLog(@"數據庫已被打開");
    }
}

// 透過資料庫實例建表
- (void)createTable
{
    // 不帶參數的 SQL
    const char *sql = "create table if not exists t_person (id integer primary key autoincrement, name text, age integer);";
    char *error;

    // sqlite3_exec 可執行一切不帶參數的 SQL。
    // 帶參數時盡量不要用,以免 SQL 注入
    int resutl = sqlite3_exec(_sqldb, sql, NULL, NULL, &error);
    if (resutl == SQLITE_OK) {
        NSLog(@"創建表成功");
    } else {
        NSLog(@"創建表失敗--》%s", error);
    }
}

// 插入資料
- (void)insertData
{
    // "?" 是佔位符
    const char *sql = "insert into t_person(name, age) values(?, ?);";
    sqlite3_stmt *stmp;

    // 執行前先檢查語法,-1 代表自動計算字串長度
    int result = sqlite3_prepare_v2(_sqldb, sql, -1, &stmp, NULL);
    if (result == SQLITE_OK) {
        NSLog(@"插入 SQL 語法沒有問題");

        // 綁定參數,注意下標從 1 開始
        sqlite3_bind_text(stmp, 1, "gcb", -1, NULL);
        sqlite3_bind_int(stmp, 2, 12);

        // 執行帶參數的 SQL,不能用 exec
        int stepResult = sqlite3_step(stmp);

        // 插入結果用 SQLITE_DONE 判斷
        if (stepResult == SQLITE_DONE) {
            NSLog(@"插入成功");
        } else {
            NSLog(@"插入失敗");
        }
        sqlite3_finalize(stmp);
    } else {
        NSLog(@"插入 SQL 語法有問題");
    }
}

// 查詢資料
- (void)FindData
{
    char *sql = "select id, name, age from t_person";
    sqlite3_stmt *stmt;

    // 檢查語法
    int result = sqlite3_prepare_v2(_sqldb, sql, -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        // 查詢的欄位下標從 0 開始(綁定參數則從 1 開始)
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            int xh = sqlite3_column_int(stmt, 0);
            char *name = (char *)sqlite3_column_text(stmt, 1);
            int age = sqlite3_column_int(stmt, 2);
            NSLog(@"xh=%i-->name=%s-->age=%i", xh, name, age);
        }
        sqlite3_finalize(stmt);
    } else {
        NSLog(@"查詢 SQL 語法有誤");
    }
}
@end

把上面這段程式拆開來看,有幾個規則一旦記住就不容易出錯:

  • 兩種執行 API 分工不同。sqlite3_exec 適合 CREATE、DROP、ALTER 這類沒有參數的敘述;sqlite3_prepare_v2 + sqlite3_bind_* + sqlite3_step 則用於帶參數或需要讀回結果的情境。
  • 下標方向相反。綁定參數(bind)從 1 開始,讀取欄位(column)從 0 開始,這是很多人第一次寫會弄錯的地方。
  • 結果碼要對應正確。查詢用 SQLITE_ROW 判斷有沒有資料,寫入用 SQLITE_DONE 判斷是否成功,兩者不可混用。
  • statement 一定要 finalize。範例中原本的 insertData 少了收尾,正式專案請務必在每個 statement 用畢後呼叫 sqlite3_finalize,並在 App 生命週期合適時機以 sqlite3_close 關閉連線。
  • 路徑放在 Documents。若要隨 App 移除而清除,放 Documents 或 Library 皆可;若想讓使用者能透過檔案共享看到,則要額外設定 Info.plist 的 UIFileSharingEnabled。

以上就是 iOS 中原生 SQLite 的完整操作示範。

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