SQLite模块用于操作本地数据库文件，可实现数据库文件的创建，执行SQL语句等功能。
注意：HBuilderX1.7.2及以上版本支持此功能。
方法：
- openDatabase: 打开数据库
- isOpenDatabase: 判断数据库是否打开
- closeDatabase: 关闭数据库
- transaction: 执行事务
- executeSql: 执行增删改等操作的SQL语句
- selectSql: 执行查询的SQL语句
回调方法：
- SQLiteSuccessCallback: SQLite操作成功回调函数
- SQLiteFailCallback:SQLite操作失败回调函数
权限：
5+功能模块（permissions）
在hbuilderX项目中的源码图添加下面代码
{
// ...
"permissions":{
// ...
"SQLite": {
"description": "SQLite数据库"
}
}
}
或者勾选这个SQLite
实现功能逻辑
sqlite.vue（页面）
<template>
<view>
<view class="uni-divider uni-divider__content" style="margin: 50rpx 200rpx; color: red;font-size: 28rpx;">
测试SQLite如何进行本地存储</view>
<button @click="openSQL">打开数据库</button>
<button @click="createTable">创建表</button>
<button @click="insertTableData">新增表数据</button>
<button @click="selectTableData">查询表数据</button>
<button @click="updateTableData">修改表数据</button>
<button @click="deleteTableData">按条件删除表数据</button>
<button @click="closeSQL">关闭数据库</button>
<view class="uni-divider__content" v-for="(item,index) in listData" :key='index'>
<view>名字:{
{
item.name}}</view>
<view>内容:{
{
item.content}}</view>
<view>时间:{
{
item.time}}</view>
<image :src="item.imgsrc" mode=""></image>
<video :src="item.videosrc" controls></video>
</view>
</view>
</template>
<script>
// 引入封装的 sqlite
import DB from "@/utils/sqlite.js";
import {
getImageFile,
getVideoFile
} from "@/utils/download.js"
export default {
data() {
return {
listData: [],
list: []
};
},
onLoad() {
this.openSQL();
// this.selectTableData()
},
methods: {
// 打开数据库
openSQL() {
// 这个是查询有没有打开数据库
let open = DB.isOpen();
console.log("数据库状态", open ? "开启" : "关闭");
if (!open) {
DB.openSqlite()
.then(res => {
this.showToast("数据库已打开");
})
.catch(error => {
console.log("数据库开启失败");
});
}
},
// 关闭数据库
closeSQL() {
// 这个是查询有没有打开数据库
let open = DB.isOpen();
if (open) {
DB.closeSqlite()
.then(res => {
this.showToast("数据库已关闭");
})
.catch(error => {
this.showToast("数据库关闭失败");
});
}
},
// 创建表
createTable() {
let open = DB.isOpen();
if (open) {
this.openSQL();
let sql =
'"id" INTEGER PRIMARY KEY AUTOINCREMENT,"name" text,"content" text, "imgsrc" varchar, "videosrc" varchar, "time" text';
// 创建表 DB.createTable(表名, 表的列)
DB.createTable("chat", sql)
.then(res => {
this.showToast("创建chat表成功");
})
.catch(error => {
this.showToast("创建表失败");
});
} else {
this.showToast("数据库未打开");
}
},
// 新增表数据
insertTableData() {
let open = DB.isOpen();
if (open) {
let arr = [{
name: '测试1',
content: "离子图片",
imgsrc: "https://lmg.jj20.com/up/allimg/tp10/211224122S31944-0-lp.jpg",
videosrc: 'http://vd3.bdstatic.com/mda-ni68ppt2xqskeu9v/360p/h264/1662530911412069950/mda-ni68ppt2xqskeu9v.mp4'
},
{
name: '测试2',
content: "美景图片",
imgsrc: 'https://lmg.jj20.com/up/allimg/1113/052420110515/200524110515-1-1200.jpg',
videosrc: 'http://vd3.bdstatic.com/mda-ni68ppt2xqskeu9v/360p/h264/1662530911412069950/mda-ni68ppt2xqskeu9v.mp4'
},
{
name: '测试3',
content: "长白山",
imgsrc: 'https://lmg.jj20.com/up/allimg/1113/051220112022/200512112022-1-1200.jpg',
videosrc: 'http://vd3.bdstatic.com/mda-ni68ppt2xqskeu9v/360p/h264/1662530911412069950/mda-ni68ppt2xqskeu9v.mp4'
}
]
let fileList = JSON.parse(JSON.stringify(arr))
const downloadList = []
fileList.forEach((item, index, arr) => {
downloadList.push(getImageFile(item.imgsrc, item, index, arr), getVideoFile(item.videosrc,
item, index, arr))
})
Promise.all(downloadList).then(res => {
fileList.map(item => {
let time = this.formatDate(new Date().getTime());
let sql =
`'${
item.name}','${
item.content}','${
item.imgsrc}','${
item.videosrc}','${
time}'`;
let condition = "'name','content','imgsrc','videosrc','time'";
// 新增 DB.insertTableData(表名, 对应表头列的数据)
DB.insertTableData("chat", sql, condition)
.then(res => {
this.showToast("新增数据成功");
this.selectTableData();
})
.catch(error => {
console.log("失败", error);
});
})
})
} else {
this.showToast("数据库未打开");
}
},
// 查询表数据
selectTableData() {
let open = DB.isOpen();
if (open) {
// 查询表 DB.selectTableData(表名,查询条件列名,查询条件列值)
DB.selectTableData("chat")
.then(res => {
console.log("contact表数据", res);
if (res) {
this.listData = res
}
})
.catch(error => {
console.log("查询失败", error);
});
} else {
this.showToast("数据库未打开");
}
},
// 修改表数据
updateTableData() {
let open = DB.isOpen();
if (open) {
let time = this.formatDate(new Date().getTime());
let data = `content = '我被修改了',time = '${
time}'`;
// 修改表数据 DB.updateTableData(表名, 要修改的列名=修改后列值, 修改条件的列名, 修改条件的列值)
DB.updateTableData("chat", data, "name", "小明")
.then(res => {
this.showToast("更新chat表成功");
this.selectTableData();
})
.catch(error => {
console.log("修改失败", error);
});
} else {
this.showToast("数据库未打开");
}
},
// 删除表数据
deleteTableData() {
let open = DB.isOpen();
if (open) {
// 删除表 DB.deleteTableData(表名,查询条件列名,查询条件列值)
DB.deleteTableData("chat", "name", "测试2", )
.then(res => {
this.showToast("删除表数据成功");
this.selectTableData();
})
.catch(error => {
console.log("删除失败", error);
});
} else {
this.showToast("数据库未打开");
}
},
// 提示框
showToast: function(str) {
uni.showToast({
icon: "none",
title: str,
mask: true
});
},
// 时间戳转年月日
formatDate(data) {
let now = new Date(data);
var year = now.getFullYear(); //取得4位数的年份
var month =
now.getMonth() + 1 < 10 ?
"0" + (now.getMonth() + 1) :
now.getMonth() + 1;
var date = now.getDate() < 10 ? "0" + now.getDate() : now.getDate();
var hour = now.getHours() < 10 ? "0" + now.getHours() : now.getHours();
var minute =
now.getMinutes() < 10 ? "0" + now.getMinutes() : now.getMinutes();
var second =
now.getSeconds() < 10 ? "0" + now.getSeconds() : now.getSeconds();
return (
year +
"-" +
month +
"-" +
date +
" " +
hour +
":" +
minute +
":" +
second
);
}
}
};
</script>
引入自定义sqlite.js文件
module.exports = {
dbName: 'chat', // 数据库名称
dbPath: '_doc/chat.db', // 数据库地址,推荐以下划线为开头 _doc/xxx.db
// 判断数据库是否打开
isOpen() {
// 数据库打开了就返回 true,否则返回 false
var open = plus.sqlite.isOpenDatabase({
name: this.dbName, // 数据库名称
path: this.dbPath // 数据库地址
})
return open;
},
// 创建数据库 或 有该数据库就打开
openSqlite() {
return new Promise((resolve, reject) => {
// 打开数据库
plus.sqlite.openDatabase({
name: this.dbName,
path: this.dbPath,
success(e) {
resolve(e); // 成功回调
},
fail(e) {
reject(e); // 失败回调
}
})
})
},
// 关闭数据库
closeSqlite() {
return new Promise((resolve, reject) => {
plus.sqlite.closeDatabase({
name: this.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 是表名，不能用数字开头、括号里是表格的表头
createTable(dbTable, data) {
return new Promise((resolve, reject) => {
// executeSql: 执行增删改等操作的SQL语句
plus.sqlite.executeSql({
name: this.dbName,
sql: `CREATE TABLE IF NOT EXISTS ${
dbTable}(${
data})`,
success(e) {
resolve(e);
},
fail(e) {
reject(e);
}
})
})
},
// 数据库删表 sql:'DROP TABLE dbTable'
dropTable(dbTable) {
return new Promise((resolve, reject) => {
plus.sqlite.executeSql({
name: this.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 是表名、根据表头列名插入列值
insertTableData(dbTable, data, condition) {
// 判断有没有传参
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);
return new Promise((resolve, reject) => {
// 表格添加数据
plus.sqlite.executeSql({
name: this.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
insertOrReplaceData(dbTable, data, condition) {
// 判断有没有传参
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: this.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 是查询条件的列名和列值
selectTableData(dbTable, lname, lvalue, cc, dd) {
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: this.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 是查询条件的列名和列值
deleteTableData(dbTable, lname, lvalue, ww, ee) {
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: this.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 是查询条件的列名和列值
updateTableData(dbTable, data, lname, lvalue) {
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: this.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，这样就能一步一步的拿完所有的数据
pullSQL(dbTable, id, num) {
return new Promise((resolve, reject) => {
plus.sqlite.selectSql({
name: this.dbName,
sql: `SELECT * FROM ${
dbTable} ORDER BY '${
id}' DESC LIMIT 15 OFFSET '${
num}'`,
success(e) {
resolve(e);
},
fail(e) {
reject(e);
}
})
})
}
}
实现效果
使用sqlite步骤：
1、打开数据库
2、创建表
3、新增表数据（数据保存到本地数据库，断网状态可以查看图片、视频）
4、查询表数据（显示表的所有数据）
演示的视频在我的导航栏视频那里
plus.sqlite视频录制
