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()(取整數)等。
這種方式的特點是可以綁定參數、逐筆產生結果,執行起來有點像 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_errmsgSQLITE_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 中靈活地管理本地資料了。