Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
6dd94101
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
6dd94101
编写于
6月 01, 2022
作者:
W
wufengshan
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
补充权限描述和示例代码
Signed-off-by:
N
wufengshan
<
wufengshan@huawei.com
>
上级
c64464dc
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
42 addition
and
13 deletion
+42
-13
zh-cn/application-dev/database/database-distributedobject-guidelines.md
...ion-dev/database/database-distributedobject-guidelines.md
+39
-12
zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md
...tion-dev/reference/apis/js-apis-data-distributedobject.md
+3
-1
未找到文件。
zh-cn/application-dev/database/database-distributedobject-guidelines.md
浏览文件 @
6dd94101
...
...
@@ -62,11 +62,38 @@
以一次分布式数据对象同步为例,说明开发步骤。
1.
准备工作,导入@ohos.data.distributedDataObject模块到开发环境。
```
js
import
distributedObject
from
'
@ohos.data.distributedDataObject
'
```
```
js
import
distributedObject
from
'
@ohos.data.distributedDataObject
'
;
```
2.
请求权限。需要在
`config.json`
里面进行配置请求权限,示例代码如下:
```
{
"module": {
"reqPermissions": [
{
"name": "ohos.permission.DISTRIBUTED_DATASYNC"
}
]
}
}
```
这个权限还需要在应用首次启动的时候弹窗获取用户授权,可以通过如下代码实现:
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
;
function
grantPermission
()
{
console
.
info
(
'
grantPermission
'
);
let
context
=
featureAbility
.
getContext
();
context
.
requestPermissionsFromUser
([
'
ohos.permission.DISTRIBUTED_DATASYNC
'
],
666
,
function
(
result
)
{
console
.
info
(
`result.requestCode=
${
result
.
requestCode
}
`
)
})
console
.
info
(
'
end grantPermission
'
);
}
grantPermission
();
```
2
.
获取分布式数据对象实例。
3
.
获取分布式数据对象实例。
以下为创建分布式数据对象的代码示例:
```
js
...
...
@@ -76,7 +103,7 @@
```
3
.
加入同步组网。同步组网中的数据对象分为发起方和被拉起方。
4
.
加入同步组网。同步组网中的数据对象分为发起方和被拉起方。
以下为加入同步组网的代码示例:
...
...
@@ -93,7 +120,7 @@
//收到status上线后remote_object同步数据,即name变成jack,age是18
```
4
.
监听对象数据变更。可监听对端数据的变更,以callback作为变更回调实例。
5
.
监听对象数据变更。可监听对端数据的变更,以callback作为变更回调实例。
以下为监听对象数据变更的代码示例。
...
...
@@ -112,7 +139,7 @@
local_object
.
on
(
"
change
"
,
this
.
changeCallback
.
bind
(
this
));
```
5
.
修改对象属性,对象属性支持基本类型(数字类型、布尔类型、字符串类型)以及复杂类型(数组、基本类型嵌套等)。
6
.
修改对象属性,对象属性支持基本类型(数字类型、布尔类型、字符串类型)以及复杂类型(数组、基本类型嵌套等)。
以下为修改分布式数据对象属性的代码示例:
```
js
...
...
@@ -132,13 +159,13 @@
local_object
.
parent
.
mother
=
"
mom
"
;
```
6
.
访问对象。可以通过直接获取的方式访问到分布式数据对象的属性,且该数据为组网内的最新数据。
7
.
访问对象。可以通过直接获取的方式访问到分布式数据对象的属性,且该数据为组网内的最新数据。
以下为访问对象的代码示例:
```
js
console
.
info
(
"
name
"
+
local_object
[
"
name
"
]);
```
7
.
删除监听数据变更。可以指定删除监听的数据变更回调;也可以不指定,这将会删除该分布式数据对象的所有数据变更回调。
8
.
删除监听数据变更。可以指定删除监听的数据变更回调;也可以不指定,这将会删除该分布式数据对象的所有数据变更回调。
以下为取消监听数据变更的代码示例:
```
js
...
...
@@ -147,7 +174,7 @@
//删除所有的变更回调
local_object
.
off
(
"
change
"
);
```
8
.
监听分布式对象的上下线。可以监听对端分布式数据对象的上下线。
9
.
监听分布式对象的上下线。可以监听对端分布式数据对象的上下线。
以下为访问对象的代码示例:
```
js
function
statusCallback
(
sessionId
,
networkId
,
status
)
{
...
...
@@ -156,7 +183,7 @@
local_object
.
on
(
"
status
"
,
this
.
statusCallback
);
```
9
.
删除监听分布式对象的上下线。可以指定删除监听的上下线回调;也可以不指定,这将会删除该分布式数据对象的所有上下线回调。
10
.
删除监听分布式对象的上下线。可以指定删除监听的上下线回调;也可以不指定,这将会删除该分布式数据对象的所有上下线回调。
以下为取消监听数据变更的代码示例:
```
js
...
...
@@ -165,7 +192,7 @@
//删除所有的上下线回调
local_object
.
off
(
"
status
"
);
```
1
0
.
退出同步组网。分布式对象退出组网后,本地的数据变更对端不会同步。
1
1
.
退出同步组网。分布式对象退出组网后,本地的数据变更对端不会同步。
以下为退出同步组网的代码示例:
```js
...
...
zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md
浏览文件 @
6dd94101
...
...
@@ -68,6 +68,8 @@ setSessionId(sessionId?: string): boolean
设置同步的sessionId,当可信组网中有多个设备时,多个设备间的对象如果设置为同一个sessionId,就能自动同步。
**需要权限:**
ohos.permission.DISTRIBUTED_DATASYNC
**系统能力:**
SystemCapability.DistributedDataManager.DataObject.DistributedObject。
**参数:**
...
...
@@ -136,7 +138,7 @@ off(type: 'change', callback?: Callback<{ sessionId: string, fields: Array<st
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 事件类型,固定为'change',表示数据变更。 |
| callback | Callback
<
{
sessionId:
string
,
fields:
Array
&
lt
;
string
&
gt
;
}
>
| 否 | 需要删除的变更回调,若不设置则删除该对象所有的数据变更回调。
<br>
sessionId:标识变更对象的sessionId;
<br>
fields:标识对象变更的属性名。 |
| callback | Callback
<
{
sessionId:
string
,
fields:
Array
&
lt
;
string
&
gt
;
}
>
| 否 | 需要删除的
数据
变更回调,若不设置则删除该对象所有的数据变更回调。
<br>
sessionId:标识变更对象的sessionId;
<br>
fields:标识对象变更的属性名。 |
**示例:**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录