iOS 本身就是支援 SQLite 的。雖然市面上有 SQLite.swift 這類好用的第三方封裝,Apple 也提供了 CoreData,但底層跑的仍然是 SQLite。理解原生 API 的運作方式,之後不管用哪一層封裝都會更有底氣。以下示範如何在 Swift 專案裡直接操作 sqlite3。
建立 Swift 專案後,需要手動把 sqlite3 動態庫拉進來:
1. 開啟專案設定,切到 Build Phases。

2. 展開 Link Binary With Libraries,點 + 號並搜尋 sqlite3。

完成後,列表裡會出現 libsqlite3.tbd:

3. 建立橋接檔:在專案目錄下新增一個 Objective-C 標頭檔。

4. 在該標頭檔中引入 sqlite3:
#import "sqlite3.h"

5. 最後到 Build Settings 搜尋 swift,找到 Objective-C Bridging Header,填入剛剛建立的橋接檔名稱。

設定完成後,隨便在一個 Swift 檔案裡輸入 sqlite3,若有自動補全提示跳出來,就代表引入成功。
用 sqlite3_open 即可,不需要自己先建檔案——若路徑上的檔案不存在,這個方法會順手幫你建好再開啟。
// 資料庫存放路徑
let sqlitepath = NSHomeDirectory().stringByAppendingPathComponent("Documents/sqlite3.db")
// 開啟資料庫;檔案不存在時會先建立再開啟,所以不必手動建檔
let state = sqlite3_open(sqlitepath, &db)
if state == SQLITE_OK {
println("打開數據庫成功")
} else {
println("打開數據庫失敗")
}
第二個參數是一個指標,開啟成功後會回傳操作用的 handle,後續所有動作都要靠它。實務上會把它宣告在類的屬性層級,方便各方法共用:
var db: COpaquePointer = nil
override func viewDidLoad() {
super.viewDidLoad()
// ...
}
這類不需要參數的 SQL,用 sqlite3_exec 一行就能跑完:
// 建表
let createtable = "create table if not exists students (id integer primary key autoincrement, name text, stuId integer)"
let result = sqlite3_exec(db, createtable, nil, nil, nil)
if result == SQLITE_OK {
println("創建表成功")
}
// 刪表
let removetable = "drop table studets"
let result2 = sqlite3_exec(db, removetable, nil, nil, nil)
if result2 == SQLITE_OK {
println("刪除表成功")
}
寫入類的 SQL 請改用「先 prepare、再 bind、最後 step」三步驟,用問號當佔位符,這麼做能有效避開 SQL 注入與效能問題。
// 新增資料
let inserttable = "insert into studets (stuId, name) values(?, ?)"
var statement: COpaquePointer = nil
let result3 = sqlite3_prepare_v2(db, inserttable, -1, &statement, nil)
if result3 == SQLITE_OK {
// 綁定參數(索引從 1 開始)
sqlite3_bind_int(statement, 1, 1)
sqlite3_bind_text(statement, 2, "lijialong", -1, nil)
// 執行
if sqlite3_step(statement) == SQLITE_DONE {
println("數據插入成功")
}
sqlite3_finalize(statement)
}
流程與新增完全相同,只是換一條 SQL:
// 更新 let updatetable = "update studets set name = 'ss' where id = 1" var statement: COpaquePointer = nil sqlite3_prepare_v2(db, updatetable, -1, &statement, nil) sqlite3_step(statement) sqlite3_finalize(statement) // 刪除 let deleterow = "delete from studets where name = 'lijialong'" sqlite3_prepare_v2(db, deleterow, -1, &statement, nil) sqlite3_step(statement) sqlite3_finalize(statement)
查詢的關鍵是反覆呼叫 sqlite3_step:只要回傳 SQLITE_ROW 就代表還有一列可讀,用 sqlite3_column_xxx 依序取出各欄(欄位索引從 0 開始)。
// 查詢
let query = "select * from studets"
// prepare 之後,資料就準備好在 statement 中了
sqlite3_prepare_v2(db, query, -1, &statement, nil)
// 每次 step 往下走一列,回傳 SQLITE_ROW 就進入迴圈
while sqlite3_step(statement) == SQLITE_ROW {
let id = sqlite3_column_int(statement, 0)
let stuId = sqlite3_column_int(statement, 2)
}
最後提醒兩點容易踩的細節:一是 sqlite3_finalize 一定要呼應每一次 prepare,否則 statement 會洩漏;二是欄位讀取索引從 0 起算,而綁定參數索引從 1 起算,兩者方向相反,寫的時候特別容易錯。