diff --git a/zh-cn/application-dev/database/database-distributedobject-guidelines.md b/zh-cn/application-dev/database/database-distributedobject-guidelines.md index cb99e123fd35cdf38b3a95a1d32fe9b136200a2d..c4cf02f6b476a1f09b19d088540f9f574278f1c2 100644 --- a/zh-cn/application-dev/database/database-distributedobject-guidelines.md +++ b/zh-cn/application-dev/database/database-distributedobject-guidelines.md @@ -16,6 +16,7 @@ **表1** 分布式数据对象实例创建接口 + | 包名 | 接口名 | 描述 | | -------- | -------- | -------- | | ohos.data.distributedDataObject| createDistributedObject(source: object): DistributedObject | 创建一个分布式数据对象实例,用于数据操作。
- source:设置distributedObject的属性。
- DistributedObject:返回值是创建好的分布式对象。 | @@ -25,6 +26,7 @@ 创建一个随机的sessionId,可将其设置为一个分布式数据对象的sessionId。 **表2** 分布式数据对象sessionId创建接口 + | 包名 | 接口名 | 描述 | | -------- | -------- | -------- | | ohos.data.distributedDataObject| genSessionId(): string | 创建一个sessionId,可作为分布式数据对象的sessionId。 | @@ -34,6 +36,7 @@ 设置分布式数据对象的sessionId,sessionId是一次(多设备)协同的唯一标识,同步的多个数据对象需要关联同一个sessionId。 **表3** 分布式数据对象sessionId设置接口 + | 类名 | 接口名 | 描述 | | -------- | -------- | -------- | | DistributedDataObject | setSessionId(sessionId?: string): boolean | 为分布式数据对象设置sessionId。
 sessionId:分布式对象在可信组网中的标识ID。如果要退出分布式组网,设置为""或不设置均可。 | @@ -54,6 +57,7 @@ 订阅数据对象上下线需要指定Callback作为回调方法,订阅的数据对象上线/下线后,对端的数据对象会收到Callback回调。 **表5** 分布式数据对象数据上下线订阅接口 + | 类名 | 接口名 | 描述 | | -------- | -------- | -------- | | DistributedDataObject| on(type: 'status', callback: Callback<{ sessionId: string, networkId: string, status: 'online' \| 'offline' }>): void | 订阅数据对象上下线。 | @@ -72,6 +76,7 @@ - 成功恢复数据之后。 **表6** 分布式数据对象保存和撤回保存接口 + | 类名 | 接口名 | 描述 | | -------- | -------- | -------- | | DistributedDataObject | save(deviceId: string): Promise<SaveSuccessResponse> | 保存数据对象。 | @@ -267,6 +272,7 @@ ```js local_object.setSessionId(""); ``` + ## 相关实例 针对分布式数据对象,有以下相关实例可供参考: