HarmonyOS 数据持久化关系型数据库之初始化操作

快来打我* 2024-04-22 07:47 90阅读 0赞

上文 [HarmonyOS 数据持久化之首选项 preferences][HarmonyOS _ preferences] 我们有说用户首选项  
但它只能处理一些比较简单的数据类型结构 的持久化处理  
如果是一些批量较大 结构较为复杂的数据结构 那么 首选项就无法满足了 我们就要选择 关系型数据库

通过 SQLite 组件实现的一种本地数据库，具备所有关系型数据库特性 例如(事务 存储过程 视图)等等  
因为是本地型数据库 所以不需要网络 性能也非常强大

因为 harmonyOS 关系型数据库 内容 比较复杂 我们分成三个部分

1 初始化数据库  
2 对数据库进行 增删改 操作  
3 查询操作

那么 我们就先来说 初始化数据库的内容

首先 这个东西 我们要封装起来 成一个类  
在模块下的 ets目录 下 创建一个 utils 目录  
下面创建一个 relationalClass.ts文件  
![在这里插入图片描述][56b0c844e29145d3b4900b8d2cc3754c.png]  
然后 我们类基本骨架写成这样

//创建类对象 名称叫 relationalClass
    class relationalClass{
        
      initTaskDB(context) {
        
      }
    
    }
    
    //new 一个relationalClass类的实力对象
    const relational = new relationalClass()
    //将实力对象导出
    export default relational as relationalClass

然后 我们初始化的逻辑 就要写在 initTaskDB 中 因为初始化 需要UIAbility 中的 上下文 ConText  
所以 这里 我们先接这个参数

首先 我们要导包

import relationalStore from "@ohos.data.relationalStore";

这也是 harmonyos 内置的 不需要安装 直接导入就可以用

然后 是做一个 rdb配置

const config = {
        
    	name:'MyApplication.db',
    	securityLevel: relationalStore.SecurityLevel.S1
    }

![在这里插入图片描述][43e4b4acd6fc4a92808e8f217a15db70.png]  
这里 对象中 nameo 是我们数据库本地文件名 因为这个相当于是本地文件读写  
然偶 securityLevel 字段就是 relationalStore.SecurityLevel 下的 S1 到 S4 值越大 安全级别越高  
因为 这里 我们就是做个练习 所以 S1就够用了

键表的话 就用 sql 语句就好了 如果不懂sql 可以参考我的文章  
[MySQL新建表 演示单表增删查改][MySQL_]

const sql = `CREATE TABLE IF NOT EXISTS TASK(
               ID INTEGER PRIMARY KEY AUTOINCREMENT,
               NAME TEXT NOT NULL,
               FINISHED bit
              )`

这里 语句发生了 一点点变化

CREATE TABLE IF NOT EXISTS 表名 这句是基本一样的  
第一 字段 ID  
NTEGER 数字类型  
PRIMARY KEY 设置组件唯一记录 不能重复  
AUTOINCREMENT 数字属性自增 sql中是 AUTO\_INCREMENT 这里 不要中间的横杠了

NAME 字段  
这里字符串 变成了 TEXT 文本类型  
NOT NULL 非空约束

FINISHED 字段

TASK 表 三个字段

有一些不太一样 但大体还是看得懂的

我们 整体代码 编写如下

//导入 relationalStore 首选项操作对象 这个包是harmonyos自带的 无需安装
    import relationalStore from "@ohos.data.relationalStore";
    
    //创建类对象 名称叫 relationalClass
    class relationalClass{
        
      //记录 rdbStore 操作数据库对象
      private rdbStore:relationalStore.RdbStore
    
      initTaskDB(context) {
        
        // 1.rdb配置
        const config = {
        
          name:'MyApplication.db',
          securityLevel: relationalStore.SecurityLevel.S1
        }
        // 2.初始化sql语句
        const sql = `CREATE TABLE IF NOT EXISTS TASK(
               ID INTEGER PRIMARY KEY AUTOINCREMENT,
               NAME TEXT NOT NULL,
              FINISHED bit`
        // 获取 RDB
        relationalStore.getRdbStore(context, config,(err, rdbStore)=> {
        
          if(err) {
        
            console.log('testTag', "获取rdbstore失败!");
            return
          }
          //执行创建表sql
          rdbStore.executeSql(sql);
          console.log('testTag', "创建表sql执行完毕!");
          //记录 rdbStare
          this.rdbStore = rdbStore;
        })
      }
    
    }
    
    //new 一个relationalClass类的实力对象
    const relational = new relationalClass()
    //将实力对象导出
    export default relational as relationalClass

我们定义了一个成员变量 rdbStore  
用于接受 getRdbStore 返回的 rdbStore对象 因为你之后要操作数据库 是需要通过它执行的

然后 我们 initTaskDB中 上来声明了 config 和 sql 内容 这个我们上面讲过  
relationalStore.getRdbStore 获取 rdbSore 需要两个参数 UIAbility上下文的 ConText 和 我们上面声明的config  
这里 会返回两个参数 如果 err有内容 说明 获取失败了 我们直接输出日志  
如果 没有  
则 通过 rdbStore.executeSql 执行我们的sql 需要一个sql字符串做参数

成功后 记录 rdbStore

然后 这里 我们找到模块入口文件  
导入 我们写的这个类 然后在onCreate 生命周期中 使用我们写的 initTaskDB  
传入 我们 UIAbility 上下文的 ConText  
![在这里插入图片描述][17468a60cd164eee99be8a1b13018b64.png]

[HarmonyOS _ preferences]: https://blog.csdn.net/weixin_45966674/article/details/136498873?spm=1001.2014.3001.5501
[56b0c844e29145d3b4900b8d2cc3754c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/085a87fb52bd4fd29e6a1599dfc02cb0.png
[43e4b4acd6fc4a92808e8f217a15db70.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/6e1004f18dcc4f98a45fbe81abccfd37.png
[MySQL_]: https://blog.csdn.net/weixin_45966674/article/details/122802590
[17468a60cd164eee99be8a1b13018b64.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/22/faadc857b72249bd8a9550c38a62c53c.png