From 41453da226f464c304c8942ec32ba1610d37fc14 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=91=9B=E4=BA=9A=E8=8A=B3?= Date: Fri, 17 Jun 2022 03:16:28 +0000 Subject: [PATCH] =?UTF-8?q?3.2Beta1=E5=88=86=E6=94=AF=EF=BC=9Aupdate=20js-?= =?UTF-8?q?apis-data-distributedobject.md=EF=BC=9A=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E5=8C=96=E6=B5=8B=E8=AF=95=E9=97=AE=E9=A2=98=E5=90=B8=E6=80=AA?= =?UTF-8?q?+=E6=B7=BB=E5=8A=A0=E6=A8=A1=E5=9D=97=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E7=AE=80=E4=BB=8B=EF=BC=9A=E9=9C=80=E5=90=8C=E6=AD=A5=E7=BF=BB?= =?UTF-8?q?=E8=AF=91=20Signed-off-by:=20@ge-yafang=20?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../apis/js-apis-data-distributedobject.md | 92 +++++++++---------- 1 file changed, 44 insertions(+), 48 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md b/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md index ecf0cf125a..e6e28af5db 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md @@ -1,6 +1,9 @@ # 分布式数据对象 +本模块提供管理基本数据对象的相关能力，包括创建、查询、删除、修改、订阅等；同时支持相同应用多设备间的分布式数据对象协同能力。 + > **说明：** +> > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -38,7 +41,7 @@ createDistributedObject(source: object): DistributedObject ``` -## distributedObject.genSessionId() +## distributedObject.genSessionId genSessionId(): string @@ -112,19 +115,19 @@ on(type: 'change', callback: Callback<{ sessionId: string, fields: Array<stri | callback | Callback<{ sessionId: string, fields: Array<string> }> | 是 | 变更回调对象实例。
sessionId：标识变更对象的sessionId；
fields：标识对象变更的属性名。 | **示例：** - ```js - import distributedObject from '@ohos.data.distributedDataObject'; - var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false, - parent:{mother:"jack mom",father:"jack Dad"}}); - g_object.on("change", function (sessionId, changeData) { - console.info("change" + sessionId); - if (changeData != null && changeData != undefined) { - changeData.forEach(element => { - console.info("changed !" + element + " " + g_object[element]); - }); - } - }); - ``` +```js +import distributedObject from '@ohos.data.distributedDataObject'; +var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false,parent:{mother:"jack mom",father:"jack Dad"}}); +globalThis.changeCallback = (sessionId, changeData) => { + console.info("change" + sessionId); + if (changeData != null && changeData != undefined) { + changeData.forEach(element => { + console.info("changed !" + element + " " + g_object[element]); + }); + } +} +g_object.on("change", globalThis.changeCallback); +``` ### off('change') @@ -142,20 +145,14 @@ off(type: 'change', callback?: Callback<{ sessionId: string, fields: Array<st **示例：** - ```js - import distributedObject from '@ohos.data.distributedDataObject'; - var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false, - parent:{mother:"jack mom",father:"jack Dad"}}); - g_object.on("change", function (sessionId, changeData) { - console.info("change" + sessionId); - }); - //删除数据变更回调changeCallback - g_object.off("change", function (sessionId, changeData) { - console.info("change" + sessionId); - }); - //删除所有的数据变更回调 - g_object.off("change"); - ``` +```js +import distributedObject from '@ohos.data.distributedDataObject'; +var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false,parent:{mother:"jack mom",father:"jack Dad"}}); +//删除数据变更回调changeCallback +g_object.off("change", globalThis.changeCallback); +//删除所有的数据变更回调 +g_object.off("change"); +``` ### on('status') @@ -172,14 +169,14 @@ on(type: 'status', callback: Callback<{ sessionId: string, networkId: string, st | callback | Callback<{ sessionId: string, networkId: string, status: 'online' \| 'offline' }> | 是 | 监听上下线回调实例。
sessionId：标识变更对象的sessionId；
networkId：标识对象设备的networkId；
status：标识对象为'online'(上线)或'offline'(下线)的状态。 | **示例：** - ```js - import distributedObject from '@ohos.data.distributedDataObject'; - var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false, - parent:{mother:"jack mom",father:"jack Dad"}}); - g_object.on("status", function (sessionId, networkId, status) { - this.response += "status changed " + sessionId + " " + status + " " + networkId; - }); - ``` +```js +import distributedObject from '@ohos.data.distributedDataObject'; +globalThis.statusCallback = (sessionId, networkId, status) => { + globalThis.response += "status changed " + sessionId + " " + status + " " + networkId; +} +var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false,parent:{mother:"jack mom",father:"jack Dad"}}); +g_object.on("status", globalThis.statusCallback); +``` ### off('status') @@ -198,15 +195,14 @@ off(type: 'status', callback?: Callback<{ sessionId: string, deviceId: string, s **示例：** - ```js - import distributedObject from '@ohos.data.distributedDataObject'; - g_object.on("status", function (sessionId, networkId, status) { - this.response += "status changed " + sessionId + " " + status + " " + networkId; - }); - //删除上下线回调changeCallback - g_object.off("status", function (sessionId, networkId, status) { - this.response += "status changed " + sessionId + " " + status + " " + networkId; - }); - //删除所有的上下线回调 - g_object.off("status"); - ``` +```js +import distributedObject from '@ohos.data.distributedDataObject'; +var g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false,parent:{mother:"jack mom",father:"jack Dad"}}); +globalThis.statusCallback = (sessionId, networkId, status) => { + globalThis.response += "status changed " + sessionId + " " + status + " " + networkId; +} +//删除上下线回调changeCallback +g_object.off("status",globalThis.statusCallback); +//删除所有的上下线回调 +g_object.off("status"); +``` -- GitLab