Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
1c9e6029
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
1c9e6029
编写于
1月 16, 2023
作者:
W
wangxiyue
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Add DataShareExtensionAbility Guide
Signed-off-by:
N
wangxiyue
<
wangxiyue8@huawei.com
>
上级
1dad82b7
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
71 addition
and
20 deletion
+71
-20
zh-cn/application-dev/database/database-datashare-guidelines.md
...application-dev/database/database-datashare-guidelines.md
+62
-13
zh-cn/application-dev/database/database-datashare-overview.md
...n/application-dev/database/database-datashare-overview.md
+9
-7
zh-cn/application-dev/database/figures/zh-cn_DataShare.png
zh-cn/application-dev/database/figures/zh-cn_DataShare.png
+0
-0
未找到文件。
zh-cn/application-dev/database/database-datashare-guidelines.md
浏览文件 @
1c9e6029
...
...
@@ -38,7 +38,50 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
### 数据提供方应用的开发(仅限系统应用)
1.
导入基础依赖包。
[
DataShareExtensionAbility
](
../reference/apis/js-apis-application-dataShareExtensionAbility.md
)
提供以下API,根据需要重写对应回调方法。
-
**onCreate**
DataShare客户端连接DataShareExtensionAbility服务端时,服务端回调此接口,执行初始化业务逻辑操作。该方法可以选择性重写。
-
**insert**
业务函数,客户端请求插入数据时回调此接口,服务端需要在此回调中实现插入数据功能,该方法可以选择性重写。
-
**update**
业务函数,客户端请求插入数据时回调此接口,服务端需要在此回调中实现更新数据功能,该方法可以选择性重写。
-
**delete**
业务函数,客户端请求插入数据时回调此接口,服务端需要在此回调中实现删除数据功能,该方法可以选择性重写。
-
**query**
业务函数,客户端请求插入数据时回调此接口,服务端需要在此回调中实现查询数据功能,该方法可以选择性重写。
-
**batchInsert**
业务函数,客户端请求插入数据时回调此接口,服务端需要在此回调中实现批量插入数据数据功能,该方法可以选择性重写。
-
**normalizeUri**
业务函数,客户端给定的URI转换为服务端使用的URI时回调此接口,该方法可以选择性重写。
-
**denormalizeUri**
业务函数,服务端使用的URI转换为客户端传入的初始URI时服务端回调此接口,该方法可以选择性重写。
开发者在实现一个数据共享服务时,需要在DevEco Studio工程中手动新建一个DataShareExtensionAbility,具体步骤如下。
1.
在工程Module对应的ets目录下,右键选择“New
>
Directory”,新建一个目录并命名为DataShareAbility。
2.
在DataShareAbility目录,右键选择“New
>
TypeScript File”,新建一个TypeScript文件并命名为DataShareAbility.ts。
3.
在DataShareAbility.ts文件中,增加导入DataShareExtensionAbility的依赖包,开发者可根据应用需求选择性重写其业务实现。例如数据提供方只提供插入、删除和查询服务,则可只重写这些接口。
4.
导入基础依赖包。
```
ts
import
Extension
from
'
@ohos.application.DataShareExtensionAbility
'
;
...
...
@@ -47,9 +90,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
import
dataSharePredicates
from
'
@ohos.data.dataSharePredicates
'
;
```
2
.
数据提供方(也称服务端)继承于DataShareExtensionAbility,开发者可根据应用需求选择性重写其业务实现。例如数据提供方只提供查询服务,则可只重写查询接口。
5
.
数据提供方(也称服务端)继承于DataShareExtensionAbility,开发者可根据应用需求选择性重写其业务实现。例如数据提供方只提供查询服务,则可只重写查询接口。
3
.
数据提供方的业务实现由开发者自定义。例如可以通过数据库、读写文件或访问网络等各方式实现数据提供方的数据存储。
6
.
数据提供方的业务实现由开发者自定义。例如可以通过数据库、读写文件或访问网络等各方式实现数据提供方的数据存储。
```
ts
const
DB_NAME
=
"
DB00.db
"
;
...
...
@@ -102,7 +145,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
};
```
4
.
在module.json5中定义DataShareExtensionAbility。
7
.
在module.json5中定义DataShareExtensionAbility。
| Json重要字段 | 备注说明 |
| ------------ | ------------------------------------------------------------ |
...
...
@@ -185,3 +228,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
console
.
log
(
"
dsHelper delete result:
"
+
data
);
});
```
## 相关示例
针对DataShareExtensionAbility开发,有以下相关示例可供参考:
[
DataShareExtensionAbility:跨应用数据共享(ArkTS)(API9)(Full SDK)
](
https://gitee.com/openharmony/applications_app_samples/tree/master/data/CrossAppDataShare
)
zh-cn/application-dev/database/database-datashare-overview.md
浏览文件 @
1c9e6029
...
...
@@ -4,6 +4,8 @@
DataShare即数据共享模块,用于应用管理其自身数据,也提供了向其他应用共享以及管理其数据的方法。目前仅支持同个设备上应用之间的数据共享。
DataShare需要与
[
DataShareExtensionAbility
](
../reference/apis/js-apis-application-dataShareExtensionAbility.md
)
配合使用。
在许多应用场景中都需要用到数据共享,比如将电话簿、短信、媒体库中的数据共享给其他应用等。当然,不是所有的数据都允许其他应用访问,比如帐号、密码等;有些数据也只允许其他应用查询而不允许其删改,比如短信等。所以对于各种数据共享场景,DataShare这样一个安全、便捷的可以跨应用的数据共享机制是十分必需的。
对于数据提供者来说,无需进行繁琐的封装,可直接使用DataShare框架实现向其他应用共享数据;对于数据访问方来说,因DataShare的访问方式不会因数据提供的方式而不同,所以只需要学习和使用一套接口即可,大大减少了学习时间和开发难度。
...
...
@@ -16,11 +18,11 @@ DataShare即数据共享模块,用于应用管理其自身数据,也提供
-
**数据提供方**
提供数据及实现相关业务的应用程序,也称为生产者或服务端
。
DataShareExtensionAbility,基于Stage模型,选择性实现对数据的增、删、改、查以及文件打开等功能,并对外共享这些数据。实现跨应用数据共享的相关业务
。
-
**数据访问方**
访问数据提供方所提供的数据或业务的应用程序,也称为消费者或客户端
。
DataShareHelper,由
[
createDataShareHelper()
](
../reference/apis/js-apis-data-dataShare.md#datasharecreatedatasharehelper
)
方法所创建的工具类,数据访问方利用工具类,便可访问数据提供方提供的数据
。
-
**数据集**
...
...
@@ -41,7 +43,7 @@ DataShare即数据共享模块,用于应用管理其自身数据,也提供
![](
figures/zh-cn_DataShare.png
)
-
DataShareExtAbility模块为数据提供方,实现跨应用数据共享的相关业务。
-
DataShareExt
ension
Ability模块为数据提供方,实现跨应用数据共享的相关业务。
-
DataShareHelper模块为数据访问方,提供各种访问数据的接口,包括增删改查等。
-
数据访问方与提供方通过IPC进行通信,数据提供方可以通过数据库实现,也可以通过其他数据存储方式实现。
...
...
zh-cn/application-dev/database/figures/zh-cn_DataShare.png
查看替换文件 @
1dad82b7
浏览文件 @
1c9e6029
31.7 KB
|
W:
|
H:
31.8 KB
|
W:
|
H:
2-up
Swipe
Onion skin
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录