Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
655cd798
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
未验证
提交
655cd798
编写于
2月 21, 2023
作者:
葛
葛亚芳
提交者:
Gitee
2月 21, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/database/database-datashare-guidelines.md.
Signed-off-by:
N
葛亚芳
<
geyafang@huawei.com
>
上级
59ae2046
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
74 addition
and
24 deletion
+74
-24
zh-cn/application-dev/database/database-datashare-guidelines.md
...application-dev/database/database-datashare-guidelines.md
+74
-24
未找到文件。
zh-cn/application-dev/database/database-datashare-guidelines.md
浏览文件 @
655cd798
...
@@ -38,7 +38,50 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -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
```
ts
import
Extension
from
'
@ohos.application.DataShareExtensionAbility
'
;
import
Extension
from
'
@ohos.application.DataShareExtensionAbility
'
;
...
@@ -47,9 +90,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -47,9 +90,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
import
dataSharePredicates
from
'
@ohos.data.dataSharePredicates
'
;
import
dataSharePredicates
from
'
@ohos.data.dataSharePredicates
'
;
```
```
2
.
数据提供方(也称服务端)继承于DataShareExtensionAbility,开发者可根据应用需求选择性重写其业务实现。例如数据提供方只提供查询服务,则可只重写查询接口。
5
.
数据提供方(也称服务端)继承于DataShareExtensionAbility,开发者可根据应用需求选择性重写其业务实现。例如数据提供方只提供查询服务,则可只重写查询接口。
3
.
数据提供方的业务实现由开发者自定义。例如可以通过数据库、读写文件或访问网络等各方式实现数据提供方的数据存储。
6
.
数据提供方的业务实现由开发者自定义。例如可以通过数据库、读写文件或访问网络等各方式实现数据提供方的数据存储。
```
ts
```
ts
const
DB_NAME
=
"
DB00.db
"
;
const
DB_NAME
=
"
DB00.db
"
;
...
@@ -66,7 +109,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -66,7 +109,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
// 重写onCreate接口
// 重写onCreate接口
onCreate
(
want
,
callback
)
{
onCreate
(
want
,
callback
)
{
result
=
this
.
context
.
cacheDir
+
'
/datashare.txt
'
result
=
this
.
context
.
cacheDir
+
'
/datashare.txt
'
;
// 业务实现使用RDB
// 业务实现使用RDB
rdb
.
getRdbStore
(
this
.
context
,
{
rdb
.
getRdbStore
(
this
.
context
,
{
name
:
DB_NAME
,
name
:
DB_NAME
,
...
@@ -76,7 +119,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -76,7 +119,9 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
rdbStore
.
executeSql
(
DDL_TBL_CREATE
,
[],
function
(
err
)
{
rdbStore
.
executeSql
(
DDL_TBL_CREATE
,
[],
function
(
err
)
{
console
.
log
(
'
DataShareExtAbility onCreate, executeSql done err:
'
+
JSON
.
stringify
(
err
));
console
.
log
(
'
DataShareExtAbility onCreate, executeSql done err:
'
+
JSON
.
stringify
(
err
));
});
});
if
(
callback
)
{
callback
();
callback
();
}
});
});
}
}
...
@@ -103,7 +148,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -103,7 +148,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
};
};
```
```
4
.
在module.json5中定义DataShareExtensionAbility。
7
.
在module.json5中定义DataShareExtensionAbility。
| Json重要字段 | 备注说明 |
| Json重要字段 | 备注说明 |
| ------------ | ------------------------------------------------------------ |
| ------------ | ------------------------------------------------------------ |
...
@@ -168,7 +213,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -168,7 +213,7 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
let
valuesBucket
=
{
"
name
"
:
"
ZhangSan
"
,
"
age
"
:
21
,
"
isStudent
"
:
false
,
"
Binary
"
:
new
Uint8Array
([
1
,
2
,
3
])
};
let
valuesBucket
=
{
"
name
"
:
"
ZhangSan
"
,
"
age
"
:
21
,
"
isStudent
"
:
false
,
"
Binary
"
:
new
Uint8Array
([
1
,
2
,
3
])
};
let
updateBucket
=
{
"
name
"
:
"
LiSi
"
,
"
age
"
:
18
,
"
isStudent
"
:
true
,
"
Binary
"
:
new
Uint8Array
([
1
,
2
,
3
])
};
let
updateBucket
=
{
"
name
"
:
"
LiSi
"
,
"
age
"
:
18
,
"
isStudent
"
:
true
,
"
Binary
"
:
new
Uint8Array
([
1
,
2
,
3
])
};
let
predicates
=
new
dataSharePredicates
.
DataSharePredicates
();
let
predicates
=
new
dataSharePredicates
.
DataSharePredicates
();
let
valArray
=
new
Array
(
"
*
"
)
;
let
valArray
=
[
'
*
'
]
;
// 插入一条数据
// 插入一条数据
dsHelper
.
insert
(
dseUri
,
valuesBucket
,
(
err
,
data
)
=>
{
dsHelper
.
insert
(
dseUri
,
valuesBucket
,
(
err
,
data
)
=>
{
console
.
log
(
"
dsHelper insert result:
"
+
data
);
console
.
log
(
"
dsHelper insert result:
"
+
data
);
...
@@ -187,3 +232,8 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
...
@@ -187,3 +232,8 @@ DataShare即数据共享模块,提供了向其他应用共享以及管理其
});
});
```
```
## 相关示例
针对DataShareExtensionAbility开发,有以下相关示例可供参考:
[
DataShareExtensionAbility:跨应用数据共享(ArkTS)(API9)(Full SDK)
](
https://gitee.com/openharmony/applications_app_samples/tree/master/data/CrossAppDataShare
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录