OpenHarmony 5.0（API 12）关系型数据库relationalStore 新增本地数据变化监听接口介绍

前言

关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于 SQLite 组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的 SQL 语句来满足复杂的场景需要。

接口介绍

RdbStore 提供管理关系数据库(RDB)方法的接口，其中数据变更监听接口：

on('dataChange')

on(event: 'dataChange', type: SubscribeType, observer: Callback<Array>): void

注册数据库的数据变更的事件监听。当分布式数据库中的数据发生更改时，将调用回调。

其中，订阅类型 SubscribeType 在 API 12 增加了 SUBSCRIBE_TYPE_LOCAL_DETAILS 类型，用于订阅本地数据更改详情。

DD一下： 欢迎大家关注公众号<程序猿百晓生>，可以了解到以下知识点。

`欢迎大家关注公众号<程序猿百晓生>，可以了解到以下知识点。`
1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题（含参考答案） 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

实现

监听：

async onDataChangeDetail(device: string, callback: Function) {
    Logger.info(TAG, `onDataChangeDetail enter，device=` + device + ` ,tableName = ` + this.tableName);
    try {
      if (this.rdbStore != undefined) {
        this.distributedTable = await this.rdbStore.obtainDistributedTableName(device, this.tableName);
        Logger.info(TAG, `obtainDistributedTableName,distributedTable=` + this.distributedTable);
      }
    } catch (err) {
      Logger.error(TAG, `ObtainDistributedTableName failed, code is ${err.code},message is ${err.message}`);
    }
    this.dataChangeDetailCallback = callback;
    if (this.rdbStore != undefined) {
      this.rdbStore.on('dataChange', data_rdb.SubscribeType.SUBSCRIBE_TYPE_LOCAL_DETAILS, async (changeInfo: Array<data_rdb.ChangeInfo>) => {
        Logger.info(TAG, `on dataChange SUBSCRIBE_TYPE_REMOTE, callback`);
        Logger.info(TAG, `on dataChange SUBSCRIBE_TYPE_REMOTE =` + JSON.stringify(changeInfo));
        await this.pullDataDetail(changeInfo);
      })
    }
  }

根据变更整理：

async pullDataDetail(changeInfo: Array<data_rdb.ChangeInfo>) {
    Logger.info(TAG, `start pullDataDetail`);
    if (this.rdbStore != undefined) {
      if (changeInfo.length > 0) {
        let result: Contact[] = [];
        for (let i = 0; i < changeInfo.length; i++) {
          let table: string = changeInfo[i].table;
          if (table !== TABLE_NAME) {
            return;
          }
          let inserted: Array<string> | Array<number> = changeInfo[i].inserted;
          let updated: Array<string> | Array<number> = changeInfo[i].updated;
          let deleted: Array<string> | Array<number> = changeInfo[i].deleted;
          if (inserted.length > 0) {
            let insertData: Contact[] = await this.getDetailByType(inserted, TYPE_INSERT);
            insertData.forEach(element => {
              result.push(element);
            });
          }
          if (updated.length > 0) {
            let updateData: Contact[] = await this.getDetailByType(updated, TYPE_UPDATE);
            updateData.forEach(element => {
              result.push(element);
            });
          }
          if (deleted.length > 0) {
            for (let index = 0; index < deleted.length; index++) {
              result.push(new Contact(deleted[index] as number, '', 0, '', 0, '', TYPE_DELETE));
            }
          }
        }
        Logger.info(TAG, `result:` + JSON.stringify(result));
        if (this.dataChangeDetailCallback !== null) {
          this.dataChangeDetailCallback(result);
        }
      }
    }
  }

样例效果