Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
dcd5f7c6
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看板
未验证
提交
dcd5f7c6
编写于
2年前
作者:
O
openharmony_ci
提交者:
Gitee
2年前
浏览文件
操作
浏览文件
下载
差异文件
!9791 【data_object】分布式数据对象开发指导 文档优化修改
Merge pull request !9791 from wangxiyue/master
上级
189e2c38
cef0fae3
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
71 addition
and
88 deletion
+71
-88
zh-cn/application-dev/database/database-distributedobject-guidelines.md
...ion-dev/database/database-distributedobject-guidelines.md
+71
-88
未找到文件。
zh-cn/application-dev/database/database-distributedobject-guidelines.md
浏览文件 @
dcd5f7c6
...
...
@@ -93,84 +93,78 @@
```
2.
请求权限。
需要在
`config.json`
文件里进行配置请求权限(FA模型)
,示例代码如下:
需要在
`config.json`
文件里进行配置请求权限(FA模型)
。
```json
{
```
json
{
"module"
:
{
"reqPermissions"
:
[
{
"name": "ohos.permission.DISTRIBUTED_DATASYNC"
"name"
:
"ohos.permission.DISTRIBUTED_DATASYNC"
}
]
}
}
```
}
```
Stage模型下的权限请求请参见
[
权限声明-Stage模型
](
../security/accesstoken-guidelines.md#stage模型
)
。
这个权限还需要在应用首次启动的时候弹窗获取用户授权
,可以通过如下代码实现:
这个权限还需要在应用首次启动的时候弹窗获取用户授权
。
```js
import featureAbility from '@ohos.ability.featureAbility';
```
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}`)
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');
}
})
console
.
info
(
'
end grantPermission
'
);
}
grantPermission();
```
grantPermission
();
```
3.
获取分布式数据对象实例。
以下为创建分布式数据对象的代码示例:
```
js
var
local_o
bject
=
distributedObject
.
createDistributedObject
({
name
:
undefined
,
age
:
undefined
,
isVis
:
true
,
parent
:
undefined
,
list
:
undefined
let
localO
bject
=
distributedObject
.
createDistributedObject
({
name
:
undefined
,
age
:
undefined
,
isVis
:
true
,
parent
:
undefined
,
list
:
undefined
});
var
sessionId
=
distributedObject
.
genSessionId
();
let
sessionId
=
distributedObject
.
genSessionId
();
```
4.
加入同步组网。同步组网中的数据对象分为发起方和被拉起方。
以下为加入同步组网的代码示例:
```
js
// 发起方
var
local_o
bject
=
distributedObject
.
createDistributedObject
({
name
:
"
jack
"
,
age
:
18
,
isVis
:
true
,
parent
:
{
mother
:
"
jack mom
"
,
father
:
"
jack Dad
"
},
list
:
[{
mother
:
"
jack mom
"
},
{
father
:
"
jack Dad
"
}]
let
localO
bject
=
distributedObject
.
createDistributedObject
({
name
:
"
jack
"
,
age
:
18
,
isVis
:
true
,
parent
:
{
mother
:
"
jack mom
"
,
father
:
"
jack Dad
"
},
list
:
[{
mother
:
"
jack mom
"
},
{
father
:
"
jack Dad
"
}]
});
local
_o
bject
.
setSessionId
(
sessionId
);
local
O
bject
.
setSessionId
(
sessionId
);
// 被拉起方
var
remote_o
bject
=
distributedObject
.
createDistributedObject
({
name
:
undefined
,
age
:
undefined
,
isVis
:
true
,
parent
:
undefined
,
list
:
undefined
let
remoteO
bject
=
distributedObject
.
createDistributedObject
({
name
:
undefined
,
age
:
undefined
,
isVis
:
true
,
parent
:
undefined
,
list
:
undefined
});
// 收到status上线后remote
_o
bject同步数据,即name变成jack,age是18
remote
_o
bject
.
setSessionId
(
sessionId
);
// 收到status上线后remote
O
bject同步数据,即name变成jack,age是18
remote
O
bject
.
setSessionId
(
sessionId
);
```
5.
监听对象数据变更。可监听对端数据的变更,以callback作为变更回调实例。
以下为监听对象数据变更的代码示
例。
5.
监听对象数据变更。可监听对端数据的变更,以Callback作为变更回调实
例。
```
js
function
changeCallback
(
sessionId
,
changeData
)
{
...
...
@@ -178,99 +172,88 @@
if
(
changeData
!=
null
&&
changeData
!=
undefined
)
{
changeData
.
forEach
(
element
=>
{
console
.
info
(
"
changed !
"
+
element
+
"
"
+
local
_o
bject
[
element
]);
});
console
.
info
(
"
changed !
"
+
element
+
"
"
+
local
O
bject
[
element
]);
});
}
}
// 发起方要在changeCallback里刷新界面,则需要将正确的this绑定给changeCallback
local
_o
bject
.
on
(
"
change
"
,
this
.
changeCallback
.
bind
(
this
));
local
O
bject
.
on
(
"
change
"
,
this
.
changeCallback
.
bind
(
this
));
```
6.
修改对象属性,对象属性支持基本类型(数字类型、布尔类型、字符串类型)以及复杂类型(数组、基本类型嵌套等)。
以下为修改分布式数据对象属性的代码示例:
```
js
local
_o
bject
.
name
=
"
jack
"
;
local
_o
bject
.
age
=
19
;
local
_o
bject
.
isVis
=
false
;
local
_o
bject
.
parent
=
{
mother
:
"
jack mom
"
,
father
:
"
jack Dad
"
};
local
_o
bject
.
list
=
[{
mother
:
"
jack mom
"
},
{
father
:
"
jack Dad
"
}];
local
O
bject
.
name
=
"
jack
"
;
local
O
bject
.
age
=
19
;
local
O
bject
.
isVis
=
false
;
local
O
bject
.
parent
=
{
mother
:
"
jack mom
"
,
father
:
"
jack Dad
"
};
local
O
bject
.
list
=
[{
mother
:
"
jack mom
"
},
{
father
:
"
jack Dad
"
}];
```
> **说明:**
> 针对复杂类型的数据修改,目前支持对根属性的修改,暂不支持对下级属性的修改。
示例如下:
> 针对复杂类型的数据修改,目前支持对根属性的修改,暂不支持对下级属性的修改。
```
js
// 支持的修改方式
local
_o
bject
.
parent
=
{
mother
:
"
mom
"
,
father
:
"
dad
"
};
local
O
bject
.
parent
=
{
mother
:
"
mom
"
,
father
:
"
dad
"
};
// 不支持的修改方式
local
_o
bject
.
parent
.
mother
=
"
mom
"
;
local
O
bject
.
parent
.
mother
=
"
mom
"
;
```
7.
访问对象。可以通过直接获取的方式访问到分布式数据对象的属性,且该数据为组网内的最新数据。
以下为访问对象的代码示例:
```
js
console
.
info
(
"
name
"
+
local
_o
bject
[
"
name
"
]);
console
.
info
(
"
name
"
+
local
O
bject
[
"
name
"
]);
```
8.
删除监听数据变更。可以指定删除监听的数据变更回调;也可以不指定,这将会删除该分布式数据对象的所有数据变更回调。
以下为取消监听数据变更的代码示例:
```
js
// 删除变更回调changeCallback
local
_o
bject
.
off
(
"
change
"
,
changeCallback
);
local
O
bject
.
off
(
"
change
"
,
changeCallback
);
// 删除所有的变更回调
local
_o
bject
.
off
(
"
change
"
);
local
O
bject
.
off
(
"
change
"
);
```
9.
监听分布式对象的上下线。可以监听对端分布式数据对象的上下线。
以下为访问对象的代码示例:
```
js
function
statusCallback
(
sessionId
,
networkId
,
status
)
{
this
.
response
+=
"
status changed
"
+
sessionId
+
"
"
+
status
+
"
"
+
networkId
;
}
function
statusCallback
(
sessionId
,
networkId
,
status
)
{
this
.
response
+=
"
status changed
"
+
sessionId
+
"
"
+
status
+
"
"
+
networkId
;
}
local_o
bject
.
on
(
"
status
"
,
this
.
statusCallback
);
localO
bject
.
on
(
"
status
"
,
this
.
statusCallback
);
```
10.
保存和撤回已保存的数据对象。
```js
// 保存数据对象
g_o
bject.save("local").then((result) => {
console.info("save sessionId " + result.sessionId);
console.info("save version " + result.version);
console.info("save deviceId " + result.deviceId);
localO
bject.save("local").then((result) => {
console.info("save sessionId " + result.sessionId);
console.info("save version " + result.version);
console.info("save deviceId " + result.deviceId);
}, (result) => {
console.info("save local failed.");
console.info("save local failed.");
});
// 撤回保存的数据对象
g_o
bject.revokeSave().then((result) => {
console.info("revokeSave success.");
localO
bject.revokeSave().then((result) => {
console.info("revokeSave success.");
}, (result) => {
console.info("revokeSave failed.");
console.info("revokeSave failed.");
});
```
11.
删除监听分布式对象的上下线。可以指定删除监听的上下线回调;也可以不指定,这将会删除该分布式数据对象的所有上下线回调。
以下为取消监听数据变更的代码示例:
```js
// 删除上下线回调statusCallback
local
_o
bject.off("status", this.statusCallback);
local
O
bject.off("status", this.statusCallback);
// 删除所有的上下线回调
local
_o
bject.off("status");
local
O
bject.off("status");
```
12.
退出同步组网。分布式对象退出组网后,本地的数据变更对端不会同步。
以下为退出同步组网的代码示例:
```js
local
_o
bject.setSessionId("");
local
O
bject.setSessionId("");
```
## 相关实例
...
...
This diff is collapsed.
Click to expand it.
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录
新手
引导
客服
返回
顶部