HarmonyOS 应用开发之关系型数据库跨设备数据同步

场景介绍

当应用程序本地存储的关系型数据存在跨设备同步的需求时,可以将需要同步的表数据迁移到新的支持跨设备的表中,当然也可以在刚完成表创建时设置其支持跨设备。

基本概念

关系型数据库跨设备数据同步,支持应用在多设备间同步存储的关系型数据。

  • 分布式列表,应用在数据库中新创建表后,可以设置其为分布式表。在查询远程设备数据库时,根据本地表名可以获取指定远程设备的分布式表名。
  • 设备之间同步数据,数据同步有两种方式,将数据从本地设备推送到远程设备或将数据从远程设备拉至本地设备。

运作机制

底层通信组件完成设备发现和认证,会通知上层应用程序设备上线。收到设备上线的消息后数据管理服务可以在两个设备之间建立加密的数据传输通道,利用该通道在两个设备之间进行数据同步。

数据跨设备同步机制

业务将数据写入关系型数据库后,向数据管理服务发起同步请求。

数据管理服务从应用沙箱内读取待同步数据,根据对端设备的deviceId将数据发送到其他设备的数据管理服务。再由数据管理服务将数据写入同应用的数据库内。

数据变化通知机制

增、删、改数据库时,会给订阅者发送数据变化的通知。主要分为本地数据变化通知和分布式数据变化通知。

  • 本地数据变化通知:本地设备的应用内订阅数据变化通知,数据库增删改数据时,会收到通知。
  • 分布式数据变化通知:同一应用订阅组网内其他设备数据变化的通知,其他设备增删改数据时,本设备会收到通知。

约束限制

  • 每个应用程序最多支持同时打开16个关系型分布式数据库。
  • 单个数据库最多支持注册8个订阅数据变化的回调。

接口说明

以下是关系型设备协同分布式数据库跨设备数据同步功能的相关接口,大部分为异步接口。异步接口均有callback和Promise两种返回形式,下表均以callback形式为例。

接口名称描述
setDistributedTables(tables: Array, callback: AsyncCallback): void设置分布式同步表。
sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback>): void分布式数据同步。
on(event: ‘dataChange’, type: SubscribeType, observer: Callback>): void订阅分布式数据变化。
off(event:’dataChange’, type: SubscribeType, observer: Callback>): void取消订阅分布式数据变化。
obtainDistributedTableName(device: string, table: string, callback: AsyncCallback): void;根据本地数据库表名获取指定设备上的表名。
remoteQuery(device: string, table: string, predicates: RdbPredicates, columns: Array , callback: AsyncCallback): void根据指定条件查询远程设备数据库中的数据。

开发步骤

说明:

数据只允许向数据安全标签不高于对端设备安全等级的设备同步数据,具体规则可见跨设备同步访问控制机制。

  1. 导入模块。
Copy
   import relationalStore from '@ohos.data.relationalStore';
  1. 请求权限。
    1. 需要申请ohos.permission.DISTRIBUTED_DATASYNC权限。
    2. 同时需要在应用首次启动时弹窗向用户申请授权。
  2. 创建关系型数据库,设置将需要进行分布式同步的表。
Copy
 import UIAbility from '@ohos.app.ability.UIAbility'; import window from '@ohos.window'; import { BusinessError } from "@ohos.base"; class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { const STORE_CONFIG: relationalStore.StoreConfig = { name: "RdbTest.db", securityLevel: relationalStore.SecurityLevel.S1 }; relationalStore.getRdbStore(this.context, STORE_CONFIG, (err: BusinessError, store: relationalStore.RdbStore) => { store.executeSql('CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)', (err) => { // 设置分布式同步表。 store.setDistributedTables(['EMPLOYEE']); // 进行数据的相关操作 }) }) } }
  1. 分布式数据同步。使用SYNC_MODE_PUSH触发同步后,数据将从本设备向组网内的其它所有设备同步。
Copy
// 构造用于同步分布式表的谓词对象 
let predicates = new relationalStore.RdbPredicates('EMPLOYEE'); // 调用同步数据的接口 
if(store != undefined) { (store as relationalStore.RdbStore).sync(relationalStore.SyncMode.SYNC_MODE_PUSH, predicates, (err, result) => { // 判断数据同步是否成功 
if (err) { console.error(`Failed to sync data. Code:${err.code},message:${err.message}`); return; } console.info('Succeeded in syncing data.'); for (let i = 0; i < result.length; i++) { console.info(`device:${result[i][0]},status:${result[i][1]}`); } }) }
  1. 分布式数据订阅。数据同步变化将触发订阅回调方法执行,回调方法的入参为发生变化的设备ID。
Copy
 let devices: string | undefined = undefined; try { // 调用分布式数据订阅接口,注册数据库的观察者 // 当分布式数据库中的数据发生更改时,将调用回调 
 if(store != undefined) { (store as relationalStore.RdbStore).on('dataChange', relationalStore.SubscribeType.SUBSCRIBE_TYPE_REMOTE, (storeObserver)=>{ if(devices != undefined){ for (let i = 0; i < devices.length; i++) { console.info(`The data of device:${devices[i]} has been changed.`); } } }); } } catch (err) { console.error('Failed to register observer. Code:${err.code},message:${err.message}'); } // 当前不需要订阅数据变化时,可以将其取消。
  try { if(store != undefined) { (store as relationalStore.RdbStore).off('dataChange', relationalStore.SubscribeType.SUBSCRIBE_TYPE_REMOTE, (storeObserver)=>{ }); } } catch (err) { console.error('Failed to register observer. Code:${err.code},message:${err.message}'); }
  1. 跨设备查询。如果数据未完成同步,或未触发数据同步,应用可以使用此接口从指定的设备上查询数据。
Copy
// 获取deviceIds
import deviceManager from '@ohos.distributedDeviceManager';
import { BusinessError } from '@ohos.base'

let dmInstance: deviceManager.DeviceManager;
let deviceId: string | undefined = undefined ;

try {
  dmInstance = deviceManager.createDeviceManager("com.example.appdatamgrverify");
  let devices = dmInstance.getAvailableDeviceListSync();

  deviceId = devices[0].networkId;

  // 构造用于查询分布式表的谓词对象
  let predicates = new relationalStore.RdbPredicates('EMPLOYEE');
  // 调用跨设备查询接口,并返回查询结果
  if(store != undefined && deviceId != undefined) {
    (store as relationalStore.RdbStore).remoteQuery(deviceId, 'EMPLOYEE', predicates, ['ID', 'NAME', 'AGE', 'SALARY', 'CODES'],
      (err: BusinessError, resultSet: relationalStore.ResultSet) => {
        if (err) {
          console.error(`Failed to remoteQuery data. Code:${err.code},message:${err.message}`);
          return;
        }
        console.info(`ResultSet column names: ${resultSet.columnNames}, column count: ${resultSet.columnCount}`);
      }
    )
  }
} catch (err) {
  let code = (err as BusinessError).code;
  let message = (err as BusinessError).message;
  console.error("createDeviceManager errCode:" + code + ",errMessage:" + message);
}
阅读全文
下载说明:
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.shuli.cc/?p=21732,转载请注明出处。
0

评论0

显示验证码
没有账号?注册  忘记密码?