更新记录

1.0.2（2023-11-30）

1. 修复Android个别情况自定义dbName不生效问题

1.0.1（2022-03-15）

1.修复Android批量插入错误问题

1.0.0（2021-12-21）

原生稳定sqlite数据库增删查改，分页查询，版本升级，事务控制，批量执行

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

前言

原生稳定sqlite数据库增删查改，分页查询，版本升级，事务控制，批量执行

功能

API方法

var wrsSqlite = uni.requireNativePlugin("wrs-sqlite");

• 设置回调

            wrsSqlite.setDBCallback((resp) => {
                var opt = resp.opt;
                if (opt == "onCreate") {
                    this.showMsg("创建数据库");
                } else if (opt == "onOpen") {
                    this.showMsg("打开数据库");
                    // 一般这时候来初始化创建表结构
                    this.initTable();
                } else if (opt == "onUpgrade") {
                    var oldVersion = resp.oldVersion;
                    var newVersion = resp.newVersion;
                    this.showMsg("数据库升级，oldVersion:" + oldVersion + "  newVersion:" + newVersion);
                    // 数据库版本升级时，一般需要动态修改表
                }
            });

• 初始化数据库

                var params = {};
                params.dbName = "database.db";
                switch (uni.getSystemInfoSync().platform) {
                    case 'android':
                    params.dbName = "database.db";
                        break;
                    case 'ios':
                    params.dbName = "database.sqlite";
                        break;
                    default:
                        break;
                }   
                params.version = 1; // 版本号，用以做数据库版本升级
                wrsSqlite.initDB(params);

• 增(批量)

                var params = {};
                params.sqls = [{
                        table: "user",
                        keyValues: {
                            account: "张三",
                            password: "aabbcc123456",
                            age: 20
                        }
                    },
                    {
                        table: "user",
                        keyValues: {
                            account: "李四",
                            password: "aab56",
                            age: 25
                        }
                    }
                ];
                // params.transaction = false; // 是否开启事务
                params.transaction = true;
                wrsSqlite.insert(params);

• 删(批量)

    var params = {};
    params.sqls = [{
                    table: "user",
                    where: "account=? and password=?",
                    whereValues: ["张三", "aabbcc123456"]
                }];
    // params.transaction = false; // 是否开启事务
    wrsSqlite.delete(params);

• 查

                // var params = {
                //  table: "user",
                //  where: "account = ? and password = ?",
                //  whereValues: ["张三", "aabbcc123456"]
                // };
                var params = {
                    table: "user"
                };
                var result = wrsSqlite.query(params);
                // 在HBuilderx里，普通运行和debug运行返回的数据类型不一样
                if (isString(result)) {
                    result = JSON.parse(result);
                }
                var columnNames = result.columnNames;
                var data = result.data;
                if (null != columnNames && columnNames.length > 0) {
                    var result = "";
                    var columnNamesStr = JSON.stringify(columnNames);
                    var dataStr = JSON.stringify(data);
                    result = result + "表字段:" + columnNamesStr + "\n";
                    result = result + "表数据:" + dataStr + "\n";
                    this.showMsg("查询结果:\n" + result);
                } else {
                    this.showMsg("查询结果为空");
                }

• 改(批量)

                var params = {};
                params.sqls = [{
                    table: "user",
                    keyValues: {
                        account: "zhangsan"
                    },
                    where: "password = ?",
                    whereValues: ["aabbcc123456"]
                }];
                // params.transaction = false; // 是否开启事务
                wrsSqlite.update(params);

如果需要把某个表字段修改为设置null值，因为Android里传递null值时获取不到，所以请使用自定义SQL语句execSQL来修改

• 分页查(limit、orderBy、groupBy、having、where)

                var params = {
                    table: "user",
                    orderBy: "account desc",
                    limit:"1,3" // 第1条开始,返回3条数据
                };
                // var params = {
                //  table: "user",
                //  limit:"1,3" // 第1条开始(不包含第1条),返回3条数据
                // };
                var result = wrsSqlite.query(params);
                // 在HBuilderx里，普通运行和debug运行返回的数据类型不一样
                if (isString(result)) {
                    result = JSON.parse(result);
                }
                var columnNames = result.columnNames;
                var data = result.data;
                if (null != columnNames && columnNames.length > 0) {
                    var result = "";
                    var columnNamesStr = JSON.stringify(columnNames);
                    var dataStr = JSON.stringify(data);
                    result = result + "表字段:" + columnNamesStr + "\n";
                    result = result + "表数据:" + dataStr + "\n";
                    this.showMsg("查询结果:\n" + result);
                } else {
                    this.showMsg("查询结果为空");
                }

• 查询数据条数

                var params = {};
                params.sql = "select count(*) from user";
                var result = wrsSqlite.query(params);
                // 在HBuilderx里，普通运行和debug运行返回的数据类型不一样
                if (isString(result)) {
                    result = JSON.parse(result);
                }
                var columnNames = result.columnNames;
                var data = result.data;
                if (null != columnNames && columnNames.length > 0) {
                    var result = "";
                    var columnNamesStr = JSON.stringify(columnNames);
                    var dataStr = JSON.stringify(data);
                    result = result + "表字段:" + columnNamesStr + "\n";
                    result = result + "表数据:" + dataStr + "\n";
                    this.showMsg("查询数据条数结果:\n" + result);
                } else {
                    this.showMsg("查询数据条数为空");
                }

• 自定义SQL语句execSQL

                var params = {};
                params.sqls = [{
                    sql: "delete from user where account=?",
                    values: ["张三"]
                }];
                wrsSqlite.execSQL(params);

• 创建表 日期类型可以使用TIMESTAMP，如：update_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP)

                var params = {};
                params.sqls = [{
                    sql: "create table if not exists country (id integer primary key autoincrement, code integer, name varchar(20), address text)"
                }];
                wrsSqlite.createTable(params);

• 修改表

                var params = {};
                params.sqls = [{
                    sql: "ALTER TABLE user ADD idcard text"
                }];
                wrsSqlite.execSQL(params);

• 查询所有表名

                var params = {};
                params.sql = "select name from sqlite_master where type='table' order by name";
                var result = wrsSqlite.query(params);
                // 在HBuilderx里，普通运行和debug运行返回的数据类型不一样
                if (isString(result)) {
                    result = JSON.parse(result);
                }
                var columnNames = result.columnNames;
                var data = result.data;
                if (null != columnNames && columnNames.length > 0) {
                    var result = "";
                    var columnNamesStr = JSON.stringify(columnNames);
                    var dataStr = JSON.stringify(data);
                    result = result + "表字段:" + columnNamesStr + "\n";
                    result = result + "表数据:" + dataStr + "\n";
                    this.showMsg("查询所有表名结果:\n" + result);
                } else {
                    this.showMsg("查询所有表名为空");
                }

• 获取数据文件路径

                var path = wrsSqlite.getDBPath();
                if(path != null && path != undefined) {
                    this.showMsg("数据库文件路径为:" + path);
                } else {
                    this.showMsg("数据库文件路径为NULL");
                }

• 数据库是否已经打开

                var result = wrsSqlite.isOpen();
                var isOpen = result.isOpen;
                if(isOpen) {
                    this.showMsg("数据库已经打开");
                } else {
                    this.showMsg("数据库没有打开");
                }

• 关闭数据库

wrsSqlite.close();

支持定制，联系方式 QQ:252797991

如果觉得可以就点个👍吧，欢迎粉丝收藏，土豪打赏，您的关注就是我们创作的动力！