一、勾选SQLite数据库选项
（1）HBuilder工具打开项目
（2）项目/manifest.json =>App模块配置 => 勾选SQLite(数据库)
二、封装sqlite.ts
在项目根目录下创建sqlite/sqlite.ts
// 数据库名称
const dbName = 'scan'/*** 数据库地址* @type {String} 推荐以下划线为开头 _doc/xxx.db* @description 开发环境中数据库所在地址：文件管理/Android/data/io.dcloud.HBuilder/downloads/salary.db* @description 打包安装后数据库所在地址：文件管理/Android/data/uni.UNI4312312(以UNI开头接数字)/downloads/salary.db*/// 数据库地址,推荐以下划线为开头 _doc/xxx.db
// 如果路径不为_downloads/xxx.db,在手机中会找不到文件夹(强烈建议：不要修改路径)
const dbPath = '_downloads/scan.db'// 判断数据库是否打开(箭头函数)
const isOpen = () => {// 数据库打开了就返回 true,否则返回 falsevar open = plus.sqlite.isOpenDatabase({name: dbName, // 数据库名称path: dbPath, // 数据库地址})return open
}// 创建数据库 或 有该数据库就打开(普通函数)
const openSqlite = () => {return new Promise((resolve, reject) => {// 打开数据库plus.sqlite.openDatabase({name: dbName,path: dbPath,success(e) {resolve(e) // 成功回调},fail(e) {reject(e) // 失败回调},})})
}// 关闭数据库(箭头函数)
const closeSqlite = () => {return new Promise((resolve, reject) => {plus.sqlite.closeDatabase({name: dbName,success(e) {resolve(e)},fail(e) {reject(e)},})})
}// 普通函数
// 数据库建表 sql:'CREATE TABLE IF NOT EXISTS dbTable("id" varchar(50),"name" TEXT)
// 创建 CREATE TABLE IF NOT EXISTS 、 dbTable 是表名，不能用数字开头、括号里是表格的表头
// @param {Object} dbTable:表名
// @param {Object} data : 表结构
const createTable = function (dbTable: string, data: string) {return new Promise((resolve, reject) => {// executeSql: 执行增删改等操作的SQL语句plus.sqlite.executeSql({name: dbName,sql: `CREATE TABLE IF NOT EXISTS ${dbTable}(${data})`,success(e) {resolve(e)},fail(e) {reject(e)},})})
}// 数据库删表 sql:'DROP TABLE dbTable'(箭头函数)
// @param {Object} dbTable:表名
const dropTable = (dbTable: string) => {return new Promise((resolve, reject) => {plus.sqlite.executeSql({name: dbName,sql: `DROP TABLE ${dbTable}`,success(e) {resolve(e)},fail(e) {reject(e)},})})
}// 普通函数
// 向表格里添加数据 sql:'INSERT INTO dbTable VALUES('x','x','x')' 对应新增
// 或者 sql:'INSERT INTO dbTable ('x','x','x') VALUES('x','x','x')' 具体新增
// 插入 INSERT INTO 、 dbTable 是表名、根据表头列名插入列值
// @param {Object} dbTable:表名
// @param {Object} data : 插入表中的值结构
// @param {Object} condition : 插入表中对应的列的属性名称结构
const insertTableData = function (dbTable: string, data: string, condition?: string) {// 判断有没有传参if (dbTable !== undefined && data !== undefined) {// 判断传的参是否有值var bol = JSON.stringify(data) == '{}'if (!bol) {if (condition == undefined) {var sql = `INSERT INTO ${dbTable} VALUES (${data})`} else {var sql = `INSERT INTO ${dbTable} (${condition}) VALUES(${data})`}console.log(sql)// console.log(sql);return new Promise((resolve, reject) => {// 表格添加数据plus.sqlite.executeSql({name: dbName,sql: sql,success(e) {resolve(e)},fail(e) {reject(e)},})})} else {return new Promise((resolve, reject) => {reject('错误添加')})}} else {return new Promise((resolve, reject) => {reject('错误添加')})}
}// 箭头函数
// 根据条件向表格里添加数据 有数据更新、无数据插入
// (建表时需要设置主键) 例如 --- "roomid" varchar(50) PRIMARY KEY
// @param {Object} dbTable:表名
// @param {Object} data : 插入表中的值结构
// @param {Object} condition : 插入表中对应的列的属性名称结构
const insertOrReplaceData = (dbTable: string, data: string, condition?: string) => {// 判断有没有传参if (dbTable !== undefined && data !== undefined) {if (condition == undefined) {var sql = `INSERT OR REPLACE INTO ${dbTable} VALUES(${data})`} else {var sql = `INSERT OR REPLACE INTO ${dbTable} (${condition}) VALUES(${data})`}// console.log(sql);return new Promise((resolve, reject) => {// 表格添加数据plus.sqlite.executeSql({name: dbName,sql: sql,success(e) {resolve(e)},fail(e) {reject(e)},})})} else {return new Promise((resolve, reject) => {reject('错误添加')})}
}// 普通函数
// 查询获取数据库里的数据 sql:'SELECT * FROM dbTable WHERE lname = 'lvalue''
// 查询 SELECT * FROM 、 dbTable 是表名、 WHERE 查找条件 lname,lvalue 是查询条件的列名和列值
// @param {Object} dbTable:表名
// @param {Object} lname:列名
// @param {Object} lvalue:列中的属性值
const selectTableData = function (dbTable: string,lname?: string,lvalue?: string,cc?: string,dd?: string,
) {if (dbTable !== undefined) {// 第一个是表单名称，后两个参数是列表名，用来检索if (lname !== undefined && cc !== undefined) {// 两个检索条件var sql = `SELECT * FROM ${dbTable} WHERE ${lname} = '${lvalue}' AND ${cc} = '${dd}'`}if (lname !== undefined && cc == undefined) {// 一个检索条件var sql = `SELECT * FROM ${dbTable} WHERE ${lname} = '${lvalue}'`// console.log(sql);}if (lname == undefined) {var sql = `SELECT * FROM ${dbTable}`}return new Promise((resolve, reject) => {// 表格查询数据 执行查询的SQL语句plus.sqlite.selectSql({name: dbName,sql: sql,success(e) {resolve(e)},fail(e) {reject(e)},})})} else {return new Promise((resolve, reject) => {reject('错误查询')})}
}// 箭头函数
// 删除表里的数据 sql:'DELETE FROM dbTable WHERE lname = 'lvalue''
// 删除 DELETE FROM 、 dbTable 是表名、 WHERE 查找条件 lname,lvalue 是查询条件的列名和列值
// @param {Object} dbTable:表名
// @param {Object} lname:列名
// @param {Object} lvalue:列中的属性值
const deleteTableData = (dbTable: string,lname?: string,lvalue?: string,ww?: string,ee?: string,
) => {if (dbTable !== undefined) {if (lname == undefined) {var sql = `DELETE FROM ${dbTable}`} else {if (ww !== undefined) {// 两个检索条件var sql = `DELETE FROM ${dbTable} WHERE ${lname} = '${lvalue}' AND ${ww} = '${ee}'`} else {// 一个检索条件var sql = `DELETE FROM ${dbTable} WHERE ${lname} = '${lvalue}'`}}return new Promise((resolve, reject) => {// 删除表数据plus.sqlite.executeSql({name: dbName,sql: sql,success(e) {resolve(e)},fail(e) {reject(e)},})})} else {return new Promise((resolve, reject) => {reject('错误删除')})}
}// 普通函数
// 修改数据表里的数据 sql:"UPDATE dbTable SET 列名 = '列值',列名 = '列值' WHERE lname = 'lvalue'"
// 修改 UPDATE 、 dbTable 是表名, data: 要修改的列名=修改后列值, lname,lvalue 是查询条件的列名和列值
// @param {Object} dbTable:表名
// @param {Object} data : 修改表中的值结构
// @param {Object} lname:列名
// @param {Object} lvalue:列中的属性值
const updateTableData = function (dbTable: string, data: string, lname?: string, lvalue?: string) {if (lname == undefined) {var sql = `UPDATE ${dbTable} SET ${data}`} else {var sql = `UPDATE ${dbTable} SET ${data} WHERE ${lname} = '${lvalue}'`}// WHERE 前面是要修改的列名、列值，后面是条件的列名、列值return new Promise((resolve, reject) => {// 修改表数据plus.sqlite.executeSql({name: dbName,sql: sql,success(e) {resolve(e)},fail(e) {reject(e)},})})
}// 箭头函数
// 获取指定数据条数 sql:"SELECT * FROM dbTable ORDER BY 'id' DESC LIMIT 15 OFFSET 'num'"
// dbTable 表名, ORDER BY 代表排序默认正序, id 是排序的条件 DESC 代表倒序，从最后一条数据开始拿
// LIMIT 15 OFFSET '${num}',这句的意思是跳过 num 条拿 15 条数据, num 为跳过多少条数据是动态值
// 例 初始num设为0，就从最后的数据开始拿15条，下次不拿刚获取的数据，所以可以让num为15，这样就能一步一步的拿完所有的数据
// @param {Object} dbTable:表名
// @param {Object} id:数据id
/*** @param {Object} num 例子如下：* select * from boot limit 10 offset 0;* select * from boot limit 10 offset 10;* select * from boot limit 10 offset 20;* select * from boot limit 10 offset 30;* 比如说每页数量为 10 条，然后我们分别获区第1、2、3、4页的数据**/
const pullSQL = (dbTable: string, id: string, num: number) => {return new Promise((resolve, reject) => {plus.sqlite.selectSql({name: dbName,sql: `SELECT * FROM ${dbTable} ORDER BY '${id}' DESC LIMIT 15 OFFSET '${num}'`,success(e) {resolve(e)},fail(e) {reject(e)},})})
}// 导出方法
export default {// 查询数据库是否打开isOpen,// 创建/开启数据库openSqlite,// 关闭数据库closeSqlite,// 数据库建表createTable,// 数据库删表dropTable,// 表里新增/插入数据insertTableData,// 根据条件向表里插入数据、更新或覆盖insertOrReplaceData,// 表里查询数据selectTableData,// 表里删除数据deleteTableData,// 表里修改数据updateTableData,// 倒叙查询数据pullSQL,
}
三、使用
注意：如果列的属性是varchar、TEXT修饰的，插入数据前后需要用单引号-' '
<template>
<view class="content"><button @click="handleClick">按钮</button>
</view>
</template><script lang="ts" setup>
// 引入salite.ts
import DB from '@/sqlite/sqlite';const handleClick = () => {// 创建/开启数据库DB.openSqlite().then((res) => {console.log('创建/开启数据库', res)}).catch((err) => {console.log('创建/开启数据库失败', err)})// 查询数据库是否打开const flag = DB.isOpen()console.log('数据库是否打开', flag)// 关闭数据库//const close = DB.closeSqlite()//console.log("关闭数据库",close);// 数据库建表const dbTable = 'demo' // 表名const data = "'id' varchar(50) PRIMARY KEY,'name' TEXT, 'age' INTEGER,'date_column' TEXT" // 表结构DB.createTable(dbTable, data).then((res) => {console.log('数据库建表', res)}).catch((err) => {console.log('数据库建表失败', err)})// 数据库删表//DB.dropTable()// 表里新增/插入数据// 注意：如果列的属性是varchar、TEXT修饰的，插入数据前后需要用单引号-''const inDBTable = 'demo' // 表名const date = new Date() // 日期const inData = "22, 'zdy', 20, '2024/11/20'" // 插入的值const inCondition = 'id, name, age, date_column' // 表中列名（可以不写）DB.insertTableData(inDBTable, inData).then((res) => {console.log('表里新增/插入数据', res)}).catch((err) => {console.log('表里新增/插入数据失败', err)})// 实验方法同上// 根据条件向表里插入数据、更新或覆盖const inOrReDBTable = 'demo' // 表名const inOrReData = "29, 'zgy', 36, '2024/11/21'" // 插入的值const inOrReCondition = 'id, name, age, date_column' // 表中列名（可以不写）DB.insertOrReplaceData(inOrReDBTable, inOrReData).then((res) => {console.log('表里插入数据、更新或覆盖成功', res)}).catch((err) => {console.log('表里插入数据、更新或覆盖失败', err)})// 表里删除数据const delDBTable = 'demo' // 表名const delname = 'id'const delvalue = '22'DB.deleteTableData(delDBTable, delname, delvalue).then((res) => {console.log('表里删除数据', res)}).catch((err) => {console.log('表里删除数据失败', err)})// 表里修改数据const updateDBTable = 'demo' // 表名const updateDate = "name = '张姓', age = 31, date_column='2024/8/10'"const updateName = 'id'const updateValue = '22'DB.updateTableData(updateDBTable, updateDate, updateName, updateValue).then((res) => {console.log('表里修改数据', res)}).catch((err) => {console.log('表里修改数据失败', err)})// 表里查询数据const queryDBTable = 'demo' // 表名const lname = 'id'const lvalue = '22'DB.selectTableData(queryDBTable, lname, lvalue).then((res) => {console.log('表里查询数据', res)}).catch((err) => {console.log('表里查询数据失败', err)})// 倒叙查询数据const pullDBTable = 'demo' // 表名const pullId = '22'const pullNum = '10'DB.pullSQL(pullDBTable, pullId, pullNum).then((res) => {console.log('倒叙查询数据', res)}).catch((err) => {console.log('倒叙查询数据失败', err)})
}
</script scoped lang="scss">
<style>
.content {display: flex;flex-direction: column;align-items: center;justify-content: center;}
</style>
参考文章
uni-app集成使用SQLite数据库的方法步骤
【uniapp】uniapp中本地存储sqlite数据库保姆级使用教程（附完整代码和注释）
