# distributeddatamgr_data_share **Repository Path**: openharmony-sig/distributeddatamgr_data_share ## Basic Information - **Project Name**: distributeddatamgr_data_share - **Description**: 数据共享组件 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2021-12-22 - **Last Updated**: 2025-05-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🚨 **重要提示 | IMPORTANT** > > **⚠️ 此代码仓已归档。新地址请访问 [distributeddatamgr_data_share](https://gitcode.com/openharmony-sig/distributeddatamgr_data_share)。| ⚠️ This repository has been archived. For the new address, please visit [distributeddatamgr_data_share](https://gitcode.com/openharmony-sig/distributeddatamgr_data_share).** > --- > # 数据共享 ## 简介 **数据共享（Data Share）** 是应用管理自身和其他应用存储数据的访问，提供与其他应用共享数据的方法，既支持同个设备上应用之间的数据共享，也支持跨设备上应用之间的数据共享。 **图 1** 逻辑架构图 ![](figures/逻辑架构图.png) DataShareHelper(JS)模块为数据访问者提供操作DataShareExtAbility模块的JS接口。 ResultSet模块提供跨应用查询数据库的结果集的接口。 DataShareExtAbility模块提供跨应用增删改查的接口。 ## 目录 ``` //foundation/distributeddatamgr/data_share ├── frameworks # 框架层代码 │ └── js # JS API的实现 │ │ └── napi # napi代码实现 │ └── native # 内部接口实现 └── interfaces # 接口代码 └── inner_api # 内部接口声明 └── native # C/C++接口 ``` ## 约束 **数据共享（Data Share）** 受到所使用数据库或RPC/IPC通信的约束与限制，例如支持的数据模型，Key的长度、Value的长度、每个应用程序最多支持同时打开数据库数量、针对每个应用程序的流控等。 ## 接口说明 **导入模块** ```ts import dataShare from '@ohos.data.dataShare' import dataAbility from '@ohos.data.dataability' ``` **表 1** JS API的主要接口

接口名	描述
createDataShareHelper(context: Context, uri: string): DataShareHelper	创建DataShare工具类。
on(type: 'dataChange', uri: string, callback: AsyncCallback<void>): void	注册观察者，观察uri指定的数据callback通知。
off(type: 'dataChange', uri: string, callback?: AsyncCallback<void>): void	注销观察者，停止观察uri指定的数据callback通知。
insert(uri: string, values: DataShareValuesBucket, callback: AsyncCallback<number>): void	将单个数据记录插入数据库（callback形式）。
delete(uri: string, predicates: DataSharePredicates, callback: AsyncCallback<number>): void	从数据库中删除一个或多个数据记录（callback形式）。
update(uri: string, predicates: DataSharePredicates, values: DataShareValuesBucket, callback: AsyncCallback<number>): void	更新数据库中的数据记录（callback形式）。
query(uri: string, predicates: DataSharePredicates,columns: Array\, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void	查询数据库中的数据（callback形式）。

## 相关仓分布式数据管理子系统 [distributeddatamgr_appdatamgr](https://gitee.com/openharmony/distributeddatamgr_appdatamgr) [distributeddatamgr_datamgr](https://gitee.com/openharmony/distributeddatamgr_datamgr) [**distributeddatamgr_data_share**](https://gitee.com/openharmony-sig/distributeddatamgr_data_share)