HarmonyOS 应用开发之通过数据管理服务实现数据共享静默访问

场景介绍

典型跨应用访问数据的用户场景下，数据提供方会存在多次被拉起的情况。

为了降低数据提供方拉起次数，提高访问速度，OpenHarmony提供了一种不拉起数据提供方直接访问数据库的方式，即静默数据访问。

静默数据访问通过数据管理服务进行数据的访问和修改，无需拉起数据提供方。

数据管理服务仅支持数据库的基本访问或数据托管，如果有业务处理，需要将业务处理封装成接口，给数据访问方调用。

如果业务过于复杂，无法放到数据访问方，建议通过DataShareExtensionAbility 拉起数据提供方实现功能。

运作机制

可以通过数据管理服务进行代理访问的数据分为以下三种：

  • 持久化数据：归属于数据提供方的数据库，这类数据存储于数据提供方的沙箱，可以在数据提供方中通过声明的方式进行共享，按表为粒度配置为可以被其他应用访问的数据表。

  • 过程数据：托管在数据管理服务上的过程数据，这类数据存储于数据管理服务的沙箱，格式为json或byte数据，无人订阅10天后自动删除。

  • 动态数据：托管在设备上的动态数据，这类数据存储于内存中，设备重启之后自动删除。只限于调用enableSilentProxy和disableSilentProxy接口设置的数据。

数据类型存储位置数据格式有效期适用场景
持久化数据数据提供方的沙箱数据库中的数据表永久存储适用于数据格式类似关系型数据库的相关场景，如日程，会议等
过程数据数据管理服务的沙箱json或byte数据无人订阅10天后自动删除适用于数据有时效性且数据格式较简单的相关场景，如步数，天气，心率等
动态数据数据管理服务的内存key-value数据设备重启之后自动删除适用于动态关闭/打开静默访问通道的场景。例如：升级过程中为了保证数据正确性可以动态关闭静默访问，升级结束后再调用相关接口打开静默访问。调用接口生成的开启关闭状态，设备重启之后会清除。只限于调用enableSilentProxy和disableSilentProxy接口设置的数据

图1 静默数据访问视图

  • 和跨应用数据共享方式不同的是，静默数据访问借助数据管理服务通过目录映射方式直接读取数据提供方的配置，按规则进行预处理后，并访问数据库。

  • 数据访问方如果使用静默数据访问方式，URI需严格按照如下格式：
    datashareproxy://{bundleName}/{dataPath}

    数据管理服务会读取对应bundleName作为数据提供方应用，读取配置，进行权限校验并访问对应数据。

    dataPath为数据标识，可以自行定义，在同一个数据提供方应用中需要保持唯一。

约束与限制

  • 目前持久化数据中仅关系型数据库支持静默数据访问方式。
  • 整个系统最多同时并发16路查询，有多出来的查询请求需要排队处理。
  • 持久化数据不支持代理创建数据库，如果需要创建数据库，需要拉起数据提供方。
  • 数据提供方如果是normal级别签名的应用，配置的数据读写权限必须为system_basic及以上权限。

接口说明

以下是静默数据访问的相关接口，大部分为异步接口。异步接口均有callback和Promise两种返回形式，下表均以callback形式为例，更多接口及使用方式请见 数据共享。

通用接口

接口名称描述
createDataShareHelper(context: Context, uri: string, options: DataShareHelperOptions, callback: AsyncCallback<DataShareHelper>): void创建DataShareHelper实例。

持久化数据

接口名称描述
insert(uri: string, value: ValuesBucket, callback: AsyncCallback<number>): void向目标表中插入一行数据。
delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback<number>): void从数据库中删除一条或多条数据记录。
query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array<string>, callback: AsyncCallback<DataShareResultSet>): void查询数据库中的数据。
update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: ValuesBucket, callback: AsyncCallback<number>): void更新数据库中的数据记录。
addTemplate(uri: string, subscriberId: string, template: Template): void添加一个指定订阅者的数据模板。
on(type: ‘rdbDataChange’, uris: Array<string>, templateId: TemplateId, callback: AsyncCallback<RdbDataChangeNode>): Array<OperationResult订阅指定URI和模板对应的数据变更事件。

过程数据

接口名称描述
publish(data: Array<PublishedItem>, bundleName: string, version: number, callback: AsyncCallback<Array<OperationResult>>): void发布数据，将数据托管至数据管理服务。
on(type: ‘publishedDataChange’, uris: Array<string>, subscriberId: string, callback: AsyncCallback<PublishedDataChangeNode>): Array<OperationResult>订阅已发布数据的数据变更通知。

动态数据

接口名称描述
enableSilentProxy(context: Context, uri?: string): Promise<void>数据提供方动态开启静默访问。
当访问方通过静默访问调用DataShare相关接口的时候，校验静默访问的开关状态。
如果静默访问的是开启的，DataShare相关接口会执行原逻辑。
disableSilentProxy(context: Context, uri?: string): Promise<void>数据提供方来动态关闭静默访问。
当访问方通过静默访问调用DataShare相关接口的时候，校验静默访问的开关状态。
如果静默访问的是关闭的，DataShare相关接口接口将会直接返回。

持久化数据实现说明

首先，以共享一个关系型数据库为例，说明开发步骤。

数据提供方应用的开发

  1. 数据提供方需要在module.json5中的proxyData节点定义要共享的表的标识，读写权限和基本信息， 配置方法可考参考配置文件。

    表1 module.json5中proxyData节点对应的属性字段

    属性名称备注说明必填
    uri数据使用的URI，是跨应用数据访问的唯一标识。是
    requiredReadPermission标识从该数据代理读取数据时所需要的权限，不配置默认不允许其他APP访问数据。支持权限可参考权限列表。否
    requiredWritePermission标识从该数据代理修改数据时所需要的权限，不配置默认不允许其他APP修改数据。支持权限可参考权限列表。否
    metadata数据源的信息，包含name和resource字段。
    name类型固定为"dataProperties"，是配置的唯一标识。
    resource类型固定为"$profile:{fileName}"，表示配置文件的名称为{fileName}.json。    		是

    module.json5配置样例：

    "proxyData":[{"uri": "datashareproxy://com.acts.ohos.data.datasharetest/test","requiredReadPermission": "ohos.permission.GET_BUNDLE_INFO","requiredWritePermission": "ohos.permission.KEEP_BACKGROUND_RUNNING","metadata": {"name": "dataProperties","resource": "$profile:my_config"}}
]

    表2 my_config.json对应属性字段

    属性名称备注说明必填
    path指定数据源路径，目前支持关系型数据库，配置为库名/表名是
    type标识数据库类型，目前支持配置为rdb，表示关系型数据库。是
    scope数据库所在范围。
    1.module表示数据库位于本模块下；
    2.application表示数据库位于本应用下。    		否

    my_config.json配置样例

    {"path": "DB00/TBL00","type": "rdb","scope": "application"
}

数据访问方应用的开发

  1. 导入基础依赖包。

    import dataShare from '@ohos.data.dataShare';
import dataSharePredicates from '@ohos.data.dataSharePredicates';
import UIAbility from '@ohos.app.ability.UIAbility';
import { ValuesBucket } from '@ohos.data.ValuesBucket';
import window from '@ohos.window';
import { BusinessError } from '@ohos.base';

  2. 定义与数据提供方通信的URI字符串。

    let dseUri = ('datashareproxy://com.acts.ohos.data.datasharetest/test');

  3. 创建工具接口类对象。

    let dsHelper: dataShare.DataShareHelper | undefined = undefined;
let abilityContext: Context;export default class EntryAbility extends UIAbility {onWindowStageCreate(windowStage: window.WindowStage) {abilityContext = this.context;dataShare.createDataShareHelper(abilityContext, dseUri, {isProxy: true}, (err, data) => {dsHelper = data;});}
}

  4. 获取到接口类对象后，便可利用其提供的接口访问提供方提供的服务，如进行数据的增、删、改、查等。

    // 构建一条数据
let key1 = 'name';
let key2 = 'age';
let key3 = 'isStudent';
let key4 = 'Binary';
let valueName1 = 'ZhangSan';
let valueName2 = 'LiSi';
let valueAge1 = 21;
let valueAge2 = 18;
let valueIsStudent1 = false;
let valueIsStudent2 = true;
let valueBinary = new Uint8Array([1, 2, 3]);
let valuesBucket: ValuesBucket = { key1: valueName1, key2: valueAge1, key3: valueIsStudent1, key4: valueBinary };
let updateBucket: ValuesBucket = { key1: valueName2, key2: valueAge2, key3: valueIsStudent2, key4: valueBinary };
let predicates = new dataSharePredicates.DataSharePredicates();
let valArray = ['*'];
if (dsHelper != undefined) {// 插入一条数据(dsHelper as dataShare.DataShareHelper).insert(dseUri, valuesBucket, (err, data) => {console.info(`dsHelper insert result:${data}`);});// 更新数据(dsHelper as dataShare.DataShareHelper).update(dseUri, predicates, updateBucket, (err, data) => {console.info(`dsHelper update result:${data}`);});// 查询数据(dsHelper as dataShare.DataShareHelper).query(dseUri, predicates, valArray, (err, data) => {console.info(`dsHelper query result:${data}`);});// 删除指定的数据(dsHelper as dataShare.DataShareHelper).delete(dseUri, predicates, (err, data) => {console.info(`dsHelper delete result:${data}`);});
}

  5. 对指定的数据进行订阅。

    function onCallback(err: BusinessError, node: dataShare.RdbDataChangeNode) {console.info("uri " + JSON.stringify(node.uri));console.info("templateId " + JSON.stringify(node.templateId));console.info("data length " + node.data.length);for (let i = 0; i < node.data.length; i++) {console.info("data " + node.data[i]);}
}let key21: string = "p1";
let value21: string = "select * from TBL00";
let key22: string = "p2";
let value22: string = "select name from TBL00";
let template: dataShare.Template = {predicates: {key21: value21,key22: value22,},scheduler: ""
}
if(dsHelper != undefined)
{(dsHelper as dataShare.DataShareHelper).addTemplate(dseUri, "111", template);
}
let templateId: dataShare.TemplateId = {subscriberId: "111",bundleNameOfOwner: "com.acts.ohos.data.datasharetestclient"
}
if(dsHelper != undefined) {// 使用数据管理服务修改数据时触发onCallback回调，回调内容是template中的规则查到的数据let result: Array<dataShare.OperationResult> = (dsHelper as dataShare.DataShareHelper).on("rdbDataChange", [dseUri], templateId, onCallback);
}

过程数据实现说明

以托管一份过程数据为例，说明开发步骤。

数据提供方应用的开发（可选）

数据提供方需要在module.json5中的proxyData节点定义过程数据的标识，读写权限和基本信息， 配置方法可考参考配置文件。

注意：

  • 该步骤为可选，可以不对module.json5中的proxyData进行配置。
  • 不配置proxyData时，托管数据不允许其他应用访问。
  • 不配置proxyData时，数据标识可以为简写，发布、订阅、查询数据可以使用简写的数据标识，如weather，可以不用全写为datashareproxy://com.acts.ohos.data.datasharetest/weather

表3 module.json5中proxyData节点对应的属性字段

属性名称备注说明必填
uri数据使用的URI，是跨应用数据访问的唯一标识。是
requiredReadPermission标识从该数据代理读取数据时所需要的权限，不配置默认不允许其他APP访问数据。支持权限可参考权限列表。否
requiredWritePermission标识从该数据代理修改数据时所需要的权限，不配置默认不允许其他APP访问数据。支持权限可参考权限列表。否

module.json5配置样例：

"proxyData": [{"uri": "datashareproxy://com.acts.ohos.data.datasharetest/weather","requiredReadPermission": "ohos.permission.GET_BUNDLE_INFO","requiredWritePermission": "ohos.permission.KEEP_BACKGROUND_RUNNING"}
]

数据访问方应用的开发

  1. 导入基础依赖包。

    import dataShare from '@ohos.data.dataShare';
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
import { BusinessError } from '@ohos.base';

  2. 定义与数据提供方通信的URI字符串。

    let dseUri = ('datashareproxy://com.acts.ohos.data.datasharetest/weather');

  3. 创建工具接口类对象。

    let dsHelper: dataShare.DataShareHelper | undefined = undefined;
let abilityContext: Context;export default class EntryAbility extends UIAbility {onWindowStageCreate(windowStage: window.WindowStage) {abilityContext = this.context;dataShare.createDataShareHelper(abilityContext, dseUri, {isProxy : true}, (err, data) => {dsHelper = data;});}
}

  4. 获取到接口类对象后，便可利用其提供的接口访问提供方提供的服务，如进行数据的增、删、改、查等。

    // 构建两条数据，第一条为免配置的数据，仅自己使用
let data : Array<dataShare.PublishedItem> = [{key:"city", subscriberId:"11", data:"xian"},{key:"datashareproxy://com.acts.ohos.data.datasharetest/weather", subscriberId:"11", data:JSON.stringify("Qing")}];
// 发布数据
if (dsHelper != undefined) {let result: Array<dataShare.OperationResult> = await (dsHelper as dataShare.DataShareHelper).publish(data, "com.acts.ohos.data.datasharetestclient");
}

  5. 对指定的数据进行订阅。

    function onPublishCallback(err: BusinessError, node:dataShare.PublishedDataChangeNode) {console.info("onPublishCallback");
}
let uris:Array<string> = ["city", "datashareproxy://com.acts.ohos.data.datasharetest/weather"];
if (dsHelper != undefined) {let result: Array<dataShare.OperationResult> = (dsHelper as dataShare.DataShareHelper).on("publishedDataChange", uris, "11", onPublishCallback);
}

动态数据实现说明

动态数据实现静默访问只针对数据提供方。以动态开启静默访问为例，说明开发步骤。

数据提供方应用的开发

数据提供方调用开启动态开启静默访问接口，来开启静默访问功能。此接口是搭配data_share_config.json文件中isSilentProxyEnable字段进行工作的。支持的配置可参考data_share_config.json配置

注意：

  • 该步骤为可选，可以不对data_share_config.json文件中isSilentProxyEnable字段进行配置，默认为true，默认为开启静默访问功能。
  • 校验静默访问是否开启，会优先校验enableSilentProxy/disableSilentProxy接口设置的开关状态，其次会校验data_share_config.json文件中isSilentProxyEnable字段。
  • 不调用enableSilentProxy/disableSilentProxy接口时，优先会校验data_share_config.json文件中isSilentProxyEnable字段。
  • 不调用enableSilentProxy/disableSilentProxy接口，也不配置data_share_config.json文件中isSilentProxyEnable字段时，默认静默访问是开启的。

  1. 导入基础依赖包。

    import dataShare from '@ohos.data.dataShare';
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

  2. 定义与数据提供方通信的URI字符串。

    let dseUri = ('datashare:///com.acts.datasharetest/entry/DB00/TBL00');

  3. 创建工具接口类对象。

    let abilityContext: Context;export default class EntryAbility extends UIAbility {onWindowStageCreate(windowStage: window.WindowStage) {abilityContext = this.context;dataShare.enableSilentProxy(abilityContext, dseUri);}
}

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

  1. 基本概念
  2. 构建第一个ArkTS应用
  3. ……

开发基础知识：https://qr21.cn/FV7h05

  1. 应用基础知识
  2. 配置文件
  3. 应用数据管理
  4. 应用安全管理
  5. 应用隐私保护
  6. 三方应用调用管控机制
  7. 资源分类与访问
  8. 学习ArkTS语言
  9. ……

基于ArkTS 开发：https://qr21.cn/FV7h05

  1. Ability开发
  2. UI开发
  3. 公共事件与通知
  4. 窗口管理
  5. 媒体
  6. 安全
  7. 网络与链接
  8. 电话服务
  9. 数据管理
  10. 后台任务(Background Task)管理
  11. 设备管理
  12. 设备使用信息统计
  13. DFX
  14. 国际化开发
  15. 折叠屏系列
  16. ……

鸿蒙开发面试真题（含参考答案）：https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/588054.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

精彩解读：短链接应用全方位探究

精彩解读：短链接应用全方位探究

title: 精彩解读&#xff1a;短链接应用全方位探究 date: 2024/4/2 17:44:50 updated: 2024/4/2 17:44:50 tags: 短链接定义映射算法原理简洁美化优势工作流程解析安全隐私保护商业营销应用技术趋势发展 1. 短链接的定义和原理 短链接是一种将长网址转换为短网址的服务&#…
阅读更多...
内网横向——域渗透之黄金票据复现

内网横向——域渗透之黄金票据复现

kerberos 协议 Kerberos是一种由MIT&#xff08;麻省理工大学&#xff09;提出的一种网络身份验证协议。它旨在通过使用密钥加密技术为客户端/服务器应用程序提供强身份验证。 在Kerberos协议中主要是有三个角色的存在&#xff1a; 访问服务的Client(以下表述为Client 或者用…
阅读更多...
redis链表结构和简单动态字符串(SDS)

redis链表结构和简单动态字符串(SDS)

1.双向链表 redis中的普通链表是双向链表。通过链表节点结构体可知有全驱节点和后继节点。 1.链表节点和链表 //adlist.h typedef struct listNode {struct listNode *prev; //前驱节点struct listNode *next; //后继节点void *value; //节点值 } list…
阅读更多...
33-4 XXE漏洞 - xxe判断

33-4 XXE漏洞 - xxe判断

判断是否存在 XXE 攻击漏洞&#xff1a; 1&#xff09;有源码情况&#xff1a; 查找相关函数&#xff0c;如 simplexml_load_string()&#xff0c;用于检测 XML 是否会被解析。 2&#xff09;无源码情况&#xff1a; 抓包检查报文是否包含 XML 传参&#xff0c;如果是 XML …
阅读更多...
Java项目：86 springboot电影评论网站系统设计与实现

Java项目：86 springboot电影评论网站系统设计与实现

作者主页&#xff1a;源码空间codegym 简介&#xff1a;Java领域优质创作者、Java项目、学习资料、技术互助 文中获取源码 项目介绍 本电影评论网站管理员和用户。 管理员功能有个人中心&#xff0c;用户管理&#xff0c;电影类别管理&#xff0c;电影信息管理&#xff0c;留…
阅读更多...
CLIP 图文检索，相似度计算

CLIP 图文检索，相似度计算

CLIP 是OpenAI提出的神经网络&#xff0c;它可以从自然语言监督中有效地学习视觉概念。 CLIP 可以应用于任何视觉分类基准&#xff0c;只需提供要识别的视觉类别的名称&#xff0c;类似于 GPT-2 和 GPT-3 的“零样本”功能。 相关paper 用法可以参考github 这里举几个使用CLI…
阅读更多...
时间管理系统的设计与实现|Springboot+ Mysql+Java+ B/S结构(可运行源码+数据库+设计文档)大学生

时间管理系统的设计与实现|Springboot+ Mysql+Java+ B/S结构(可运行源码+数据库+设计文档)大学生

本项目包含可运行源码数据库LW&#xff0c;文末可获取本项目的所有资料。 推荐阅读300套最新项目持续更新中..... 最新ssmjava项目文档视频演示可运行源码分享 最新jspjava项目文档视频演示可运行源码分享 最新Spring Boot项目文档视频演示可运行源码分享 2024年56套包含ja…
阅读更多...
JVM 组成

JVM 组成

文章目录 概要JVM 是 Java程序的运行环境&#xff08;java二进制字节码的运行环境&#xff09;JVM 的主要组成部分运行流程&#xff1a;程序计数器堆元空间方法区常量池运行时常量池 概要 JVM 是 Java程序的运行环境&#xff08;java二进制字节码的运行环境&#xff09; 好处&…
阅读更多...
在linux下conda 创建虚拟环境失败的解决方法

在linux下conda 创建虚拟环境失败的解决方法

报错内容一&#xff1a; Solving environment: failed CondaHTTPError: HTTP 000 CONNECTION FAILED for url <https://conda.anaconda.org/conda-forge/noarch/repodata.json> Elapsed: - An HTTP error occurred when trying to retrieve this URL. HTTP errors are…
阅读更多...
关系型数据库与非关系型数据库、Redis数据库

关系型数据库与非关系型数据库、Redis数据库

相比于其他的内存/缓存数据库&#xff0c;redis可以方便的实现持久化的功能&#xff08;保存至磁盘中&#xff09; 一、关系数据库与非关系型数据库 1.1 关系型数据库 一个结构化的数据库&#xff0c;创建在关系模型基础上一般面向于记录 SQL语句 (标准数据查询语言) 就是一种…
阅读更多...
可视化GIS开发：初识地图12大坐标系以及屏幕坐标

可视化GIS开发：初识地图12大坐标系以及屏幕坐标

hello&#xff0c;我是贝格前端工场&#xff0c;地图在可视化开发中随处可见&#xff0c;地图需要用到坐标来标明位置关系&#xff0c;并映射的屏幕上&#xff0c;我们才能看到&#xff0c;本文先介绍地图中的常用坐标系&#xff0c;欢迎评论区补充&#xff0c;转发和分享。 在…
阅读更多...
ubuntu20.04 运行 lio-sam 流程记录

ubuntu20.04 运行 lio-sam 流程记录

ubuntu20.04 运行 lio-sam 一、安装和编译1.1、安装 ROS11.2、安装 gtsam1.3、安装依赖1.4、下载源码1.5、修改文件1.6、编译和运行 二、官方数据集的运行2.1、casual_walk_2.bag2.2、outdoor.bag、west.bag2.3、park.bag 三、一些比较好的参考链接 记录流程&#xff0c;方便自…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023