#夏日挑战赛#OpenHarmony JS 关系型数据库使用示例 原创 精华

深开鸿
发布于 2022-6-16 15:35
浏览
5收藏

本文正在参加星光计划3.0–夏日挑战赛
作者:杜晨阳

概述

在应用开发的过程中,数据存储是一项重要功能。那么在鸿蒙系统中,作为数据持久化存储之一的数据库是怎么使用的呢?
下面给大家带来的是基于api8版本的数据库使用示例

导入模块

import dataRdb from '@ohos.data.rdb'

关系型数据库的使用

1、创建数据库及表格

    const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS " + TABLE_NAME
        + "(ID INTEGER PRIMARY KEY AUTOINCREMENT,NAME TEXT NOT NULL,AGE NUMBER,SCORE BLOB)";
    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        // @ts-ignore 创建数据库中表格
        rdbStore.executeSql(SQL_CREATE_TABLE);
    })

2、增/删/改/查数据库数据
新增数据

    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        rdbStore.insert(TABLE_NAME, info, function (err, ret) {
        })
    })

删除数据

    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
        predicates.equalTo("NAME", info);
        rdbStore.delete(predicates, function (err, rows) {
        })
    })

更新数据

    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
        predicates.equalTo("NAME", oldInfo.name).equalTo("AGE", oldInfo.age);
        rdbStore.update(newInfo, predicates, function (err, ret) {
        })
    })

查询数据

    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        let datas = [];
        let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
        rdbStore.query(predicates, ["NAME", "AGE", "SCORE"],function (err, resultSet) {
        })
   })

 或者使用sql语句
    dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
        let datas = [];
        rdbStore.querySql("SELECT * FROM " + TABLE_NAME, [], function (err, resultSet) {
        })
   })

注:增删改查也可以执行sql语句,但是没有返回值,示例:

    dataRdb.deleteRdbStore(STORE_CONFIG.name, function (err, rdbStore) {
        rdbStore.executeSql("DELETE FROM EMPLOYEE", null, function () {
        })
    })

3、删除数据库

    dataRdb.deleteRdbStore(STORE_CONFIG.name, function (err, rdbStore) {
    })

完整代码示例

// @ts-nocheck
import dataRdb from '@ohos.data.rdb'

const STORE_VERSION = 1;
const STORE_CONFIG = {
    name: "RdbLocal.db"
}
const TABLE_NAME = "table_name";
const TAG = "RdbManager";

/**
 * 数据库管理类,基于API 8版本
 *   Info:{
        //名称:String
        name:"小明",
        //年龄:Number
        age : "18",
        //分数: BLOB 整型数组
        score: new Uint8Array([60, 70, 80]),
   }
 */
export default class RdbManager {
    /**
     * 初始化数据库及表,在应用启动时必须先调用,
     * 调用方式:RdbManager.createRdb();
     */
    createRdb() {
        const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS " + TABLE_NAME
        + "(ID INTEGER PRIMARY KEY AUTOINCREMENT,NAME TEXT NOT NULL,AGE NUMBER,SCORE BLOB)";
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            // @ts-ignore 创建数据库中表格
            rdbStore.executeSql(SQL_CREATE_TABLE);
            console.info(TAG + ' createRdb table done. ' + err);
        })
    }
    /**
     * 删除数据库
     * 调用方式:RdbManager.createRdb();
     */
    deleteRdb() {
        dataRdb.deleteRdbStore(STORE_CONFIG.name, function (err, rdbStore) {
            console.info(TAG + '  delete store done. ' + err)
        })
    }

    /**
     * 添加数据
     * return 执行结果 true 添加成功   false 添加失败
     *
     * 调用方式:RdbManager.insertInfo(info,function (result) {});
     */
    insertInfo(info, callback) {
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            rdbStore.insert(TABLE_NAME, info, function (err, ret) {
                console.info(TAG + ' insertInfo table done. ' + "  err:" + err + "  ret:" + ret);
                let result = false;
                if (ret > 0) {
                    result = true;
                }
                callback(result);
            })
        })
    }
    /**
     * 删除数据
     * return 执行结果 true 删除成功   false 删除失败
     *
     * 调用方式:RdbManager.deleteInfo(info,function (result) {});
     */
    deleteInfo(info, callback) {
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
            predicates.equalTo("NAME", info);
            rdbStore.delete(predicates, function (err, rows) {
                console.log(TAG + "  deleteInfo table done. rows: " + rows)
                let result = false;
                if (rows > 0) {
                    result = true;
                }
                callback(result);
            })
        })
    }

    /**
     * 更新数据
     * return 执行结果 true 更新成功   false 更新失败
     *
     * 调用方式:RdbManager.updateInfo(oldInfo, newInfo,function (result) {});
     * oldInfo,newInfo 都是Info类型
     */
    updateInfo(oldInfo, newInfo, callback) {
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
            predicates.equalTo("NAME", oldInfo.name).equalTo("AGE", oldInfo.age);
            rdbStore.update(newInfo, predicates, function (err, ret) {
                console.log(TAG + "  updateInfo table done. row count: " + ret)
                let result = false;
                if (ret > 0) {
                    result = true;
                }
                callback(result);
            })
        })
    }

    /**
     * 查询全部数据,使用sql语句
     * return array Info
     *
     * 调用方式:RdbManager.queryAllInfoBySql(function (result) {});
     */
    queryAllInfoBySql(callback) {
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            let datas = [];
            rdbStore.querySql("SELECT * FROM " + TABLE_NAME, [], function (err, resultSet) {
                console.log(TAG + "  queryAllInfoBySql table done: " + resultSet.rowCount + "   resultSet.isEnded:" + resultSet.isEnded);
                //rowCount 代表查询结果总数量
                if (resultSet.rowCount === 0) {
                    resultSet.close()
                    resultSet = null;
                    callback(datas);
                }
                while (!resultSet.isEnded) {
                    console.log(TAG + "  queryAllInfoBySql  resultSet.rowIndex:" + resultSet.rowIndex);
                    //rowIndex 默认角标是-1
                    if (resultSet.rowIndex < 0) {
                        resultSet.goToFirstRow();
                    } else {
                        resultSet.goToNextRow();
                    }
                    var name = resultSet.getString((resultSet.getColumnIndex("NAME")));
                    var age = resultSet.getLong((resultSet.getColumnIndex("AGE")));
                    var score = resultSet.getBlob((resultSet.getColumnIndex("SCORE")));
                    let info = {}
                    info.name = name;
                    info.age = age;
                    info.score = score;
                    datas.push(info);
                    if (resultSet.isAtLastRow) {
                        resultSet.close()
                        resultSet = null;
                        callback(datas);
                    }
                }
            })
        })
    }
    /**
     * 查询全部数据,使用查询api
     * return array Info
     *
     * 调用方式:RdbManager.queryAllInfo(function (result) {});
     */
    queryAllInfo(callback) {
        dataRdb.getRdbStore(STORE_CONFIG, STORE_VERSION, function (err, rdbStore) {
            let datas = [];
            let predicates = new dataRdb.RdbPredicates(TABLE_NAME);
            rdbStore.query(predicates, ["NAME", "AGE", "SCORE"],
                function (err, resultSet) {
                    console.log(TAG + "  queryAllInfo table done: " + resultSet.rowCount);
                    if (resultSet.rowCount === 0) {
                        resultSet.close()
                        resultSet = null;
                        callback(datas);
                    }
                    while (!resultSet.isEnded) {
                        if (resultSet.rowIndex < 0) {
                            resultSet.goToFirstRow();
                        } else {
                            resultSet.goToNextRow();
                        }
                        var name = resultSet.getString((resultSet.getColumnIndex("NAME")));
                        var age = resultSet.getLong((resultSet.getColumnIndex("AGE")));
                        var score = resultSet.getBlob((resultSet.getColumnIndex("SCORE")));
                        let info = {
                            name: name,
                            age: age,
                            score: score,
                        }
                        datas.push(info);
                        if (resultSet.isAtLastRow) {
                            resultSet.close()
                            resultSet = null;
                            callback(datas);
                        }
                    }
                })
        })
    }
}

调用示例

import RdbManager from '../../RdbManager.js';

const TAG = "rdbDemo";
let mRdbManager = new RdbManager();

export default {
    data: {
       
    },
    createRdb: function () {
        mRdbManager.createRdb();
    },
    inseatRdb: function () {
        let info = {
            name: "张三",
            age: 26,
            score: new Uint8Array([100, 99, 100]),
        }
        let info2 = {
            name: "李四",
            age: 22,
            score: new Uint8Array([60, 88, 70]),
        }
        mRdbManager.insertInfo(info, function (result) {
            console.log(TAG + " insertInfo1  result:" + result)
        });
        mRdbManager.insertInfo(info2, function (result) {
            console.log(TAG + " insertInfo2  result:" + result)
        });
    },
    deleteRdb: function () {
        mRdbManager.deleteInfo("张三", function (result) {
            console.log(TAG + " deleteInfo  result:" + result)
        });
    },
    updateRdb: function () {
        let oldInfo = {
            name: "李四",
            age: 22,
        }
        let newInfo = {
            age: 18,
            score: new Uint8Array([100, 100, 100]),
        }
        mRdbManager.updateInfo(oldInfo, newInfo, function (result) {
            console.log(TAG + " deleteInfo  result:" + result)
        });
    },
    queryRdb: function () {
        mRdbManager.queryAllInfo(function (result) {
            console.log(TAG + "  queryRdb result.length:" + result.length);
            result.forEach(item => {
                console.log(TAG + " queryRdb  item.name:" + item.name + "  item.age:" + item.age + "  item.score:" + item.score)
            })
        });
    },
}

总结

以上代码示例可在DevEco Studio 3.0 Beta1 使用Remote Emulator P40 Pro API7版本演示
最后跟大家分享一些开发过程中的注意事项

1、目前针对于数据库版本更新,没有提供对应接口可以直接调用。如有需要,可以尝试通过手写sql语句实现版本更新功能。

2、在数据库表格中插入数据时,支持的数据字段类型包括ValueType(number、string、boolean)、Uint8Array、null 。
但是在查询结果的结果集ResultSet中,未提供getBoolean方法,不推荐插入boolean类型数据。

3、在插入string类型数据时,注意类型匹配,不要直接将number数据存入数据库中string字段下。
已知问题:将number 类型 99存入string类型字段后,数据库自动将该数据变更为“99.00”。通过ResultSet.getString()返回值为“99.00”

参考资料

关系型数据库

更多原创内容请关注:深开鸿技术团队

入门到精通、技巧到案例,系统化分享HarmonyOS开发技术,欢迎投稿和订阅,让我们一起携手前行共建鸿蒙生态。

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
已于2022-6-17 18:40:43修改
4
收藏 5
回复
举报
2条回复
按时间正序
/
按时间倒序
Whyalone
Whyalone

api8版本的数据库使用示例,增删改查

回复
2022-6-16 16:32:25
西安丶木易楊
西安丶木易楊

有没有获取数据库版本号的接口??

 

回复
2022-8-1 10:48:39
回复
    相关推荐