看這篇文章之前你得:
- 已經了解了基本的SQL語法, 基本會使用
- 推薦一個桌面數據庫軟件: Navigate Premium(有需要的留言)
- 知道移動端開發, SQLite是干什么的
直接把我xcode中的文件考過來了, 已經寫得很詳細了, (可以直接考到xcode中, 這樣就能按分類來看)耐心看吧...
import UIKit
class SQLiteManager: NSObject {
static let shareInstance: SQLiteManager = SQLiteManager()
/*數據庫基本操作:
1. 數據庫文件
2. 新建表
3. 指定字段名稱
4. 添加記錄
*/
/// 創建數據庫文件
var db: COpaquePointer = nil
// MARK:- 打開或創建數據庫文件(一般就在appdelegate中打開一次就行了)
func openDB(dbName: String) -> Bool {
// 1. 生成db文件的路徑, 沒有就會創建一個
let path = dbName.cacheDir()
guard let cPath = path.cStringUsingEncoding(NSUTF8StringEncoding) else {
return false
}
// 2. 創建數據庫文件
// 專門用戶打開數據庫文件, 如果不存在系統會自動創建一個新的
// 第一個參數: 數據庫文件的路徑
// 第二個參數: 數據庫的指針(句柄), 只要打開成功系統就會將打開的數據庫賦值給該指針
// 后續所有關于數據庫的操作, 都依賴于該指針
// sqlite3_open方法會返回一個整型的值, 告訴我們是否打開成功
if sqlite3_open(cPath, &db) != SQLITE_OK {
return false
}
// 3. 新建表
if !createTable() {
return false
}
return true
}
// MARK:- 創建表
func createTable() -> Bool {
// 1.定義sql語句(可以在navcat中寫好考進來, 換行寫, 一目了然)
let sqlStr = "CREATE TABLE 'T_Person' (" +
"'name' TEXT," +
"'age' INTEGER," +
"'id' INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT" +
");"
// 執行創建表的sql語句
/*
第1個參數: 一個已經打開的數據庫
第2個參數: 需要執行的SQL語句
第3個參數: 執行SQL之后的回調
第4個參數: 第三個參數的第一個參數
第5個參數: 錯誤信息的指針, 如果執行過程中發生錯誤就會給傳入的指針賦值
*/
if sqlite3_exec(db, sqlStr.cStringUsingEncoding(NSUTF8StringEncoding)!, nil, nil, nil) != SQLITE_OK {
return false
}
return true
}
// MARK:- 執行sql語句
/*
第1個參數: 一個已經打開的數據庫
第2個參數: 需要執行的SQL語句
第3個參數: 執行SQL之后的回調
第4個參數: 第三個參數的第一個參數
第5個參數: 錯誤信息的指針, 如果執行過程中發生錯誤就會給傳入的指針賦值
*/
/*
寫入: sql語句
let sqlStr = "INSERT INTO T_Person \n" +
"(name, age) \n" +
"VALUES \n" +
"('\(name!)', \(age));"
*/
func execSQL(sqlStr: String) -> Bool {
if sqlite3_exec(db, sqlStr.cStringUsingEncoding(NSUTF8StringEncoding)!, nil, nil, nil) != SQLITE_OK {
return false
}
return true
}
// MARK:- 執行查詢語句
/*
查詢語句(條件語句的使用where)
let sqlStr = "SELECT id, name, age FROM T_Person;"
*/
func querySQL(sqlStr: String) -> [[String: AnyObject]]? {
// 1. 預編譯
/*
第一個參數: 一個已經打開的數據庫
第二個參數: 需要執行的SQL語句
第三個參數: 需要執行的SQL語句的長度, 傳入-1系統會自動計算
第四個參數: 結果集指針(以后所有獲取數據的操作, 都依賴于該指針)
第五個參數: 沒用過
*/
// 結果集, 查新結果都依賴此
var stmt: COpaquePointer = nil
if sqlite3_prepare_v2(db, sqlStr.cStringUsingEncoding(NSUTF8StringEncoding)!, -1, &stmt, nil) != SQLITE_OK {
return nil
}
// 2. 利用結果集取出查詢結果
// 只要是調用一次sqlite3_step方法, 系統就會利用stmt取出一條數據
// 如果該方法的返回值等于SQLITE_ROW, 就代表可以獲取數據
var array = [[String: AnyObject]]()
while sqlite3_step(stmt) == SQLITE_ROW {
// 1. 獲取當前一共多少列
let count = sqlite3_column_count(stmt)
// 定義一條空數據信息, 用于保存
var dict = [String: AnyObject]()
for i in 0..<count {
// 2. 獲取每一列的名稱
let cName = sqlite3_column_name(stmt, i)
let name = String(CString: cName, encoding: NSUTF8StringEncoding)!
// 3. 獲取每一列的數據類型
let type = sqlite3_column_type(stmt, i)
switch type
{
case SQLITE_INTEGER:
let intValue = sqlite3_column_int(stmt, i)
dict[name] = Int(intValue)
case SQLITE_FLOAT:
let floatValue = sqlite3_column_double(stmt, i)
dict[name] = floatValue
case SQLITE_BLOB:
print("blob") // blob是二進制數據, 一般不做sqlite數據存儲對象
case SQLITE_NULL:
dict[name] = NSNull()
case SQLITE_TEXT:
let cTextValue = UnsafePointer<Int8>(sqlite3_column_text(stmt, i))
let textValue = String(CString: cTextValue, encoding: NSUTF8StringEncoding)
dict[name] = textValue
default:
print("other")
}
}
array.append(dict)
}
return array
}
// MARK:- 數據庫的事務處理(防止多線程不安全)
/*
1.事務能夠保證多條SQL語句, 要么一起成功, 要么一起失敗
2.想要保證多條SQL語句一起成功或者一起失敗, 就必須在執行多條SQL語句之前開啟事物
只有遇到了提交事務, 數據庫才會修改數據
3.如果中途遇到了意外, 我們可以通過回滾事物來還原以前的數據
4.提高性能
*/
// - sqlite3執行sql語句是默認開啟事務處理的, 當我們多條數據時, 應手動開啟事務, 這樣就只要開啟一次, 提升性能
// - 重復的開啟和提交是非常非常消耗性能的, 所以為了避免這種問題, 我們可以自己開啟事物, 只要我們自己開了事物 ,系統就不會自動幫我們開啟事物了
// 1. 開啟事務
func beginTransaction() -> Bool {
return execSQL("BEGIN TRANSACTION;")
}
// 2. 提交事務
func commit() -> Bool {
return execSQL("COMMIT TRANSACTION;")
}
// 3. 回滾事務
func rollBack() -> Bool {
return execSQL("ROLLBACK TRANSACTION;")
}
// MARK:- 數據寫入之動態綁定插入, 提高性能, 多數SQLite框架都是采用這種方式來寫入數據, FMDB也是這么干的
private let SQLITE_TRANSIENT = unsafeBitCast(-1, sqlite3_destructor_type.self)
func insert(sql: String, args: CVarArgType...) -> Bool
{
var stmt: COpaquePointer = nil
// 1.預編譯SQL語句
if sqlite3_prepare_v2(db, sql.cStringUsingEncoding(NSUTF8StringEncoding)!, -1, &stmt, nil) != SQLITE_OK
{
print("預編譯失敗")
return false
}
// 2.綁定參數
var index: Int32 = 1
for objc in args
{
if objc is Int
{
/*
第一個參數: stmt對象
第二個參數: 需要綁定的字段的索引
注意: 字段索引從1開始
第三個參數: 需要綁定到SQL上的值
*/
sqlite3_bind_int64(stmt, index, sqlite3_int64(objc as! Int))
}else if objc is Double
{
sqlite3_bind_double(stmt, index, objc as! Double)
}else if objc is String
{
/*
第一個參數: stmt對象
第二個參數: 需要綁定的字段的索引
第三個參數: 需要綁定到SQL上的值
第四個參數: 沒用過
第五個參數: bind方法中如何處理傳入的字符串
處理方式有兩種: 1.方法內部不管傳入的字符串, 不會對傳入的字符串進行retain(copy)操作, 所以在使用該字符串時字符串可能已經釋放了, 此時系統就會隨便設置一個值
2.方法內部會管理傳入的字符串, 所以在使用字符串時字符串不會被釋放, 使用完畢之后bind方法內部會自動釋放該字符串
#define SQLITE_STATIC ((sqlite3_destructor_type)0) 上述1
#define SQLITE_TRANSIENT ((sqlite3_destructor_type)-1) 上述2
*/
let text = objc as! String
let cText = text.cStringUsingEncoding(NSUTF8StringEncoding)!
sqlite3_bind_text(stmt, index, cText, -1, SQLITE_TRANSIENT)
}
index++
}
// 3.執行SQL語句
if sqlite3_step(stmt) != SQLITE_DONE
{
print("執行SQL語句失敗")
return false
}
// 4.重置STMT
sqlite3_reset(stmt)
// 5.關閉STMT
sqlite3_finalize(stmt)
// 6.返回結果
return true
}
// MARK:- sqlite異步執行
// 1. 創建一個串行隊列
let queue = dispatch_queue_create("sqliteQueue", DISPATCH_QUEUE_SERIAL)
/// 2. 異步執行SQL語句
func execSQLQueue(action: (db: COpaquePointer) -> ()) {
dispatch_async(queue) { () -> Void in
action(db: self.db)
// 在閉包中執行SQL語句
}
}
}
