本文介绍下sqlite.swift的基本使用方法,包括与数据库建立连接、建表、增、删、查、改,以上基本用法。文中代码都是从当前项目中直接粘下来的,并不能直接运行,但是核心的东西都在了。
这个是sqlite.swift的网址,里面有简单的介绍(粘贴复制到地址栏):
https://github.com/stephencelis/SQLite.swift
这个是sqlite.swift的文档(全英文,硬着头皮也得看)
https://github.com/stephencelis/SQLite.swift/blob/master/Documentation/Index.md#sqliteswift-documentation
第三方库的导入方法这里不讲解。
新建一个iOS程序,并新建一个swift文件命名为Database并建立结构体。
这里建立一个灯光列表,具体如下:
列表项 | id | address | name | colorValue | lampType |
---|---|---|---|---|---|
项类型 | Int64 | Int64 | String | String | Int64 |
//
// Database.swift
// iOS_Client
//
// Created by AlexTiger on 2020/13/33.
// Copyright © 2020年 Tiger. All rights reserved.
//
import Foundation
import sqlite
struct Database {
var db: Connection!
init() {
connectDatabase()
}
// 与数据库建立连接
mutating func connectDatabase(filePath: String = "/Documents") -> Void {
let sqlFilePath = NSHomeDirectory() + filePath + "/db.sqlite3"
do { // 与数据库建立连接
db = try Connection(sqlFilePath)
print("与数据库建立连接 成功")
} catch {
print("与数据库建立连接 失败:\(error)")
}
}
// ===================================== 灯光 =====================================
let TABLE_LAMP = Table("table_lamp") // 表名称
let TABLE_LAMP_ID = Expression<Int64>("lamp_id") // 列表项及项类型
let TABLE_LAMP_ADDRESS = Expression<Int64>("lamp_address")
let TABLE_LAMP_NAME = Expression<String>("lamp_name")
let TABLE_LAMP_COLOR_VALUE = Expression<String>("lamp_colorValue")
let TABLE_LAMP_LAMP_TYPE = Expression<Int64>("lamp_lampType")
// 建表
func tableLampCreate() -> Void {
do { // 创建表TABLE_LAMP
try db.run(TABLE_LAMP.create { table in
table.column(TABLE_LAMP_ID,primaryKey: .autoincrement) // 主键自加且不为空
table.column(TABLE_LAMP_ADDRESS)
table.column(TABLE_LAMP_NAME)
table.column(TABLE_LAMP_COLOR_VALUE)
table.column(TABLE_LAMP_LAMP_TYPE)
})
print("创建表 TABLE_LAMP 成功")
} catch {
print("创建表 TABLE_LAMP 失败:\(error)")
}
}
// 插入
func tableLampInsertItem(address: Int64,name: String,colorValue: String,lampType: Int64) -> Void {
let insert = TABLE_LAMP.insert(TABLE_LAMP_ADDRESS <- address,TABLE_LAMP_NAME <- name,TABLE_LAMP_COLOR_VALUE <- colorValue,TABLE_LAMP_LAMP_TYPE <- lampType)
do {
let rowid = try db.run(insert)
print("插入数据成功 id: \(rowid)")
} catch {
print("插入数据失败: \(error)")
}
}
// 遍历
func queryTableLamp() -> Void {
for item in (try! db.prepare(TABLE_LAMP)) {
print("灯光 遍历 ———— id: \(item[TABLE_LAMP_ID]),address: \(item[TABLE_LAMP_ADDRESS]),name: \(item[TABLE_LAMP_NAME]),colorValue: \(item[TABLE_LAMP_COLOR_VALUE]),lampType: \(item[TABLE_LAMP_LAMP_TYPE])")
}
}
// 读取
func readTableLampItem(address: Int64) -> Void {
for item in try! db.prepare(TABLE_LAMP.filter(TABLE_LAMP_ADDRESS == address)) {
print("\n读取(灯光)id: \(item[TABLE_LAMP_ID]),lampType: \(item[TABLE_LAMP_LAMP_TYPE])")
}
}
// 更新
func tableLampUpdateItem(address: Int64,newName: String) -> Void {
let item = TABLE_LAMP.filter(TABLE_LAMP_ADDRESS == address)
do {
if try db.run(item.update(TABLE_LAMP_NAME <- newName)) > 0 {
print("灯光\(address) 更新成功")
} else {
print("没有发现 灯光条目 \(address)")
}
} catch {
print("灯光\(address) 更新失败:\(error)")
}
}
// 删除
func tableLampDeleteItem(address: Int64) -> Void {
let item = TABLE_LAMP.filter(TABLE_LAMP_ADDRESS == address)
do {
if try db.run(item.delete()) > 0 {
print("灯光\(address) 删除成功")
} else {
print("没有发现 灯光条目 \(address)")
}
} catch {
print("灯光\(address) 删除失败:\(error)")
}
}
}
下面在ViewController.swift中调用以上方法
class @H_552_301@ViewController: @H_552_301@UIViewController {
// 数据库声明
var database: Database!
override func viewDidLoad() {
super.viewDidLoad()
// 与数据库建立连接
database = Database()
// 建立列表(有列表后不再建立)
database.tableLampCreate()
// 插入两条数据
database.tableLampInsertItem(address: 51,name: "灯光1",colorValue: "#FFFFFF",lampType: 0)
database.tableLampInsertItem(address: 52,name: "灯光2",colorValue: "#AAAAAA",lampType: 1)
// 遍历列表(检查插入结果)
database.queryTableLamp()
// 根据条件查询
database.readTableLampItem(address: 52)
// 修改列表项
database.tableLampUpdateItem(address: 51,newName: "客厅大灯")
// 遍历列表(检查修改结果)
database.queryTableLamp()
// 删除列表项
database.tableLampDeleteItem(address: 52)
// 遍历列表(检查删除结果)
database.queryTableLamp()
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
// Dispose of any resources that can be recreated.
}
}
下面运行下试试看看结果是否符合预期(本人是在真机上调试的,iPhone SE,模拟器也一样的效果)
再次运行程序,建表失败(表已存在)