ArkData：关系持久化——让数据在设备中安全的奏乐原创

起梨花月

发布于 2024-11-7 22:30

浏览

1收藏

Hey 小伙伴, 数据的小船儿，我们来聊聊如何在数字海洋中稳稳地航行，不让任何宝贵的数据随风而去。🚣‍♀️🌊

📚 应用数据持久化简介

在数字的世界里，我们每天都在产生大量的数据，就像海边的贝壳一样，如果不捡起来，它们就会随着潮水消失。应用数据持久化，就是把那些宝贵的数据“捡起来”，保存到我们的设备上，让它们变成永恒的记忆。📖

🔗 关系型数据库：数据的保险箱

想象一下，你有一个超级保险箱，可以安全地存储你的所有珍贵物品。在数字世界里，关系型数据库就是这样的保险箱，它能够存储复杂的数据关系，比如你的朋友圈、你的学习笔记，甚至是你的购物清单。🔐

🌟 关系型数据库的魔力

关系型数据库基于SQLite组件，就像是一个强大的魔法书，能够存储和处理复杂的数据关系。📚

谓词：这就像是数据库的搜索咒语，帮助我们找到特定的数据。🔍
结果集：这是我们施展搜索咒语后得到的宝藏集合，我们可以从中提取任何我们想要的宝贝。💎

🚀 运作机制：数据库的心脏

关系型数据库提供了通用的操作接口，底层使用SQLite作为持久化存储引擎，支持事务、索引、视图等强大的数据库特性。🏗️

📋 约束限制：保险箱的使用规则

虽然关系型数据库很强大，但它也有一些使用规则，比如：

WAL模式：这是数据库的默认日志方式，就像是保险箱的日志记录，记录了所有的操作。📝
连接限制：数据库同一时间只能支持一个写操作，就像是保险箱一次只能一个人打开。🔒

🛠️ 接口说明：操作数据库的工具箱

关系型数据库提供了一系列的接口，就像是工具箱中的工具，帮助我们进行数据的操作。🧰

接口名称	描述
`getRdbStore`	获取一个RdbStore，操作关系型数据库。
`executeSql`	执行包含指定参数但不返回值的SQL语句。
`insert`	向目标表中插入一行数据。
`update`	根据谓词的指定实例对象更新数据库中的数据。
`delete`	根据谓词的指定实例对象从数据库中删除数据。
`query`	根据指定条件查询数据库中的数据。
`deleteRdbStore`	删除数据库。

📝 开发步骤：建造你的数据库

获取RdbStore：首先，我们需要获取一个RdbStore，这就像是拿到保险箱的钥匙。🔑

// 导入关系型数据库模块
import { relationalStore } from '@kit.ArkData';

// 定义数据库配置
const storeConfig: relationalStore.StoreConfig = {
  name: 'MyDatabase.db',
  securityLevel: relationalStore.SecurityLevel.S3,
  encrypt: false,
};

// 获取RdbStore
relationalStore.getRdbStore(context, storeConfig, (err, store) => {
  if (err) {
    console.error(`获取RdbStore失败: ${err.message}`);
    return;
  }
  console.info('成功获取RdbStore');
  // 接下来可以进行数据库操作
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.

插入数据：现在，我们可以向数据库中插入数据，就像是把宝贝放入保险箱。📦

// 定义要插入的数据
const data: relationalStore.ValuesBucket = {
  NAME: 'Alice',
  AGE: 23,
  SALARY: 5000,
};

// 插入数据
store.insert('EMPLOYEE', data, (err, rowId) => {
  if (err) {
    console.error(`插入数据失败: ${err.message}`);
    return;
  }
  console.info(`数据插入成功, rowId: ${rowId}`);
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

查询数据：当我们需要找到特定的数据时，我们可以使用查询接口，就像是在保险箱中寻找特定的宝贝。🔎

// 定义查询条件
const predicates = new relationalStore.RdbPredicates('EMPLOYEE');
predicates.equalTo('NAME', 'Alice');

// 查询数据
store.query(predicates, ['ID', 'NAME', 'AGE', 'SALARY'], (err, resultSet) => {
  if (err) {
    console.error(`查询数据失败: ${err.message}`);
    return;
  }
  console.info(`查询结果: ${resultSet}`);
  // 处理查询结果
  resultSet.close();
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.

更新和删除数据：如果我们需要更新或删除数据，我们可以使用更新和删除接口，就像是重新排列或移除保险箱中的宝贝。🔄

// 更新数据
const updateData: relationalStore.ValuesBucket = {
  SALARY: 6000,
};

store.update(updateData, predicates, (err, rows) => {
  if (err) {
    console.error(`更新数据失败: ${err.message}`);
    return;
  }
  console.info(`数据更新成功, 影响行数: ${rows}`);
});

// 删除数据
store.delete(predicates, (err, rows) => {
  if (err) {
    console.error(`删除数据失败: ${err.message}`);
    return;
  }
  console.info(`数据删除成功, 影响行数: ${rows}`);
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.

备份和恢复数据库：最后，我们还可以备份和恢复数据库，就像是为保险箱做一个副本，以防万一。💾

// 备份数据库
store.backup('Backup.db', (err) => {
  if (err) {
    console.error(`备份数据库失败: ${err.message}`);
    return;
  }
  console.info('数据库备份成功');
});

// 恢复数据库
store.restore('Backup.db', (err) => {
  if (err) {
    console.error(`恢复数据库失败: ${err.message}`);
    return;
  }
  console.info('数据库恢复成功');
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.

删除数据库：如果我们需要删除整个数据库，我们可以使用删除接口，就像是清空整个保险箱。🗑️

relationalStore.deleteRdbStore(context, 'MyDatabase.db', (err) => {
  if (err) {
    console.error(`删除数据库失败: ${err.message}`);
    return;
  }
  console.info('数据库删除成功');
});
1.
2.
3.
4.
5.
6.
7.