1.3.2.3 QN.database
优质
小牛编辑
128浏览
2023-12-01
基于 sqlite 3 实现的 数据库存储能力.
1.1. API 调用
1.1.1. QN.database.execSql(options)
API 调用入参
执行单条 SQL 语句
| 参数名 | 类型 | 是否可选 | 默认值 | 含义 |
|---|---|---|---|---|
options | Object | 选项 | ||
options.query | Object | 请求参数 | ||
options.query.sql | String Array | SQL 语句 或 SQL 语句和参数的组合数组 | ||
options.query.sql[0] | String | SQL 语句 | ||
options.query.sql[1] | Array | 执行 SQL 语句同时传入的参数 | ||
options.success | Function | optional | 调用成功的回调函数 | |
options.error | Function | optional | 调用失败的回调函数 |
API 响应结果
| 参数名 | 类型 | 是否必须返回 | 含义 |
|---|---|---|---|
result | Object | 响应对象 | |
result.code | String | 错误码，成功为 QAP_SUCCESS；失败为其他 | |
result.msg | String | 错误信息 |
调用示例
// 直接执行 SQL 语句
QN.database.execSql({
query: {
sql: 'CREATE TABLE IF NOT EXISTS Employee(id integer PRIMARY KEY AUTOINCREMENT,name varchar,sex varchar,departmentId integer)',
}
}).then((result) => {
console.log(result);
}, (error) => {
console.log(error);
});
QN.database.execSql({
query: {
sql: 'CREATE TABLE IF NOT EXISTS Employee(id integer PRIMARY KEY AUTOINCREMENT,name varchar,sex varchar,departmentId integer)',
},
success(result) {
console.log(result);
},
error(error) {
console.log(error);
}
});
// 执行 SQL 语句并传入参数，传入的数据会取代 SQL 语句中的 `?`
QN.database.execSql({
query: {
sql: ['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['张三', '男', 10003]],
}
}).then((result) => {
console.log(result);
}, (error) => {
console.log(error);
});
QN.database.execSql({
query: {
sql: ['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['张三', '男', 10003]],
},
success(result) {
console.log(result);
},
error(error) {
console.log(error);
}
});
1.1.2. QN.database.batchSql(options)
批量执行 SQL 语句
API 调用入参
执行单条 SQL 语句
| 参数名 | 类型 | 是否可选 | 默认值 | 含义 |
|---|---|---|---|---|
options | Object | 选项 | ||
options.query | Object | 请求参数 | ||
options.query.sql | Array | SQL 数组 | ||
options.query.sql[i] | String | QN.database.execSql 中 sql 的任一形式 | ||
options.success | Function | optional | 调用成功的回调函数 | |
options.error | Function | optional | 调用失败的回调函数 |
API 响应结果
| 参数名 | 类型 | 是否必须返回 | 含义 |
|---|---|---|---|
result | Object | 响应对象 | |
result.code | String | 错误码，成功为 QAP_SUCCESS；失败为其他 | |
result.msg | String | 错误信息 |
调用示例
QN.database.batchSql({
query: {
sql: [
['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['张三', '男', 10003]],
['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['李四', '男', 10004]],
['DELETE FROM Employee WHERE sex = "女"'],
]
}
}).then((result) => {
console.log(result);
}, (error) => {
console.log(error);
});
QN.database.batchSql({
query: {
sql: [
['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['张三', '男', 10003]],
['INSERT INTO Employee (name,sex,departmentId) VALUES (NULL,?,?)', ['李四', '男', 10004]],
['DELETE FROM Employee WHERE sex = "女"'],
]
},
success(result) {
console.log(result);
},
error(error) {
console.log(error);
}
});