1. 为什么需要SQLite ORM封装
在UniApp开发中,SQLite作为轻量级本地数据库被广泛使用。但直接操作SQLite会遇到几个典型问题:需要手动拼接SQL语句容易出错、数据类型转换繁琐、多表关联查询代码冗长。我在实际项目中就遇到过SQL拼接错误导致数据丢失的惨痛教训。
ORM(对象关系映射)的核心思想就是把数据库表映射为JavaScript对象。比如用户表users可以直接用user.name访问,而不是写SELECT name FROM users WHERE id=1。这种操作方式更符合前端开发者的思维习惯。
举个例子,假设我们有个商品表products,传统SQLite操作是这样的:
javascript复制const sql = `INSERT INTO products (name, price) VALUES ('手机', 3999)`;
plus.sqlite.executeSql({sql});
而ORM封装后可以这样写:
javascript复制const product = {name: '手机', price: 3999};
db.products.insert(product);
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础封装设计
2.1 数据库连接管理
首先需要封装基础的数据库连接功能。我通常会创建一个SqlHelper类,包含以下核心方法:
javascript复制class SqlHelper {
constructor() {
this.dbName = 'app.db';
this.dbPath = '_doc/app.db';
}
// 打开或创建数据库
open() {
return new Promise((resolve, reject) => {
plus.sqlite.openDatabase({
name: this.dbName,
path: this.dbPath,
success: resolve,
fail: reject
});
});
}
// 关闭数据库
close() {
return new Promise((resolve, reject) => {
plus.sqlite.closeDatabase({
name: this.dbName,
success: resolve,
fail: reject
});
});
}
}
这里有几个实用技巧:
- 使用Promise封装异步操作,方便配合async/await
- 数据库路径建议使用
_doc或_downloads目录 - 在App启动时自动打开连接,避免频繁开关
2.2 CRUD基础操作
接下来封装最基础的增删改查方法。以插入数据为例:
javascript复制// 原始SQL方式
async insert(table, data) {
const fields = Object.keys(data).join(',');
const values = Object.values(data)
.map(v => typeof v === 'string' ? `'${v}'` : v)
.join(',');
const sql = `INSERT INTO ${table} (${fields}) VALUES (${values})`;
return this.executeSql(sql);
}
// 使用示例
await db.insert('products', {
name: '笔记本电脑',
price: 5999,
stock:
