diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md b/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md index bf2e97983d6ab1d440af2e712c708131822d2316..ca0f96d180ea62db1bfd7c1e3c71c83d2a819176 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-relationalStore.md @@ -3008,9 +3008,9 @@ promise.then(() => { ### setDistributedTables<sup>10+</sup> - setDistributedTables(tables: Array<string>, type?: number, config?: DistributedConfig): Promise<void> +setDistributedTables(tables: Array<string>, type: number, config: DistributedConfig, callback: AsyncCallback<void>): void -设置分布å¼åˆ—表,使用Promise异æ¥å›žè°ƒã€‚ +设置分布å¼åˆ—表,使用callback异æ¥å›žè°ƒã€‚ **需è¦æƒé™ï¼š** ohos.permission.DISTRIBUTED_DATASYNC @@ -3018,35 +3018,32 @@ promise.then(() => { **å‚数:** -| å‚æ•°å | 类型 | å¿…å¡« | 说明 | -| ------ | ------------------------------------------------------- | ---- | ------------------------------------------------------------ | -| tables | Array<string> | 是 | è¦è®¾ç½®çš„分布å¼åˆ—表表å。 | -| type | number | å¦ | 表的分布å¼ç±»åž‹ã€‚默认值是DISTRIBUTED_DEVICE。<br> ç›®å‰æ”¯æŒçš„å…¥å‚值为: DISTRIBUTED_DEVICEã€relationalStore.DistributedType.DISTRIBUTED_CLOUD。<br/> 当type为relationalStore.DistributedType.DISTRIBUTED_DEVICE时,表示表在ä¸åŒè®¾å¤‡ä¹‹é—´åˆ†å¸ƒå¼ã€‚<br/> 当type为relationalStore.DistributedType.DISTRIBUTED_CLOUD时,表示表在设备和云端之间分布å¼ã€‚ | -| config | [DistributedConfig<sup>10+</sup>](#distributedconfig10) | å¦ | 表的分布å¼é…置信æ¯ã€‚ä¸ä¼ 入时默认autoSync为false,å³åªæ”¯æŒæ‰‹åŠ¨åŒæ¥ã€‚ | - -**返回值**: - -| 类型 | 说明 | -| ------------------- | ------------------------- | -| Promise<void> | æ— è¿”å›žç»“æžœçš„Promise对象。 | +| å‚æ•°å | 类型 | å¿…å¡« | 说明 | +| -------- | ----------------------------------- | --- | --------------- | +| tables | Array<string> | 是 | è¦è®¾ç½®çš„分布å¼åˆ—表表å。 | +| type | number | 是 | 表的分布å¼ç±»åž‹ã€‚ç›®å‰æ”¯æŒçš„å…¥å‚值为: relationalStore.DistributedType.DISTRIBUTED_DEVICEã€relationalStore.DistributedType.DISTRIBUTED_CLOUD。<br> 当type为relationalStore.DistributedType.DISTRIBUTED_DEVICE时,表示表在ä¸åŒè®¾å¤‡ä¹‹é—´åˆ†å¸ƒå¼ã€‚<br> 当type为relationalStore.DistributedType.DISTRIBUTED_CLOUD时,表示表在设备和云端之间分布å¼ã€‚ | +| config | [DistributedConfig](#distributedconfig10) | 是 | 表的分布å¼é…置信æ¯ã€‚ | +| callback | AsyncCallback<void> | 是 | 指定callback回调函数。 | **示例:** ```js let config = new DistributedConfig(); config.autoSync = true; -let promise = store.setDistributedTables(["EMPLOYEE"], relationalStore.DistributedType.DISTRIBUTED_CLOUD, config); -promise.then(() => { +store.setDistributedTables(["EMPLOYEE"], relationalStore.DistributedType.DISTRIBUTED_CLOUD, config, function (err) { + if (err) { + console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); + return; + } console.info(`SetDistributedTables successfully.`); -}).catch((err) => { - console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); }) ``` + ### setDistributedTables<sup>10+</sup> -setDistributedTables(tables: Array<string>, type: number, config: DistributedConfig, callback: AsyncCallback<void>): void + setDistributedTables(tables: Array<string>, type?: number, config?: DistributedConfig): Promise<void> -设置分布å¼åˆ—表,使用callback异æ¥å›žè°ƒã€‚ +设置分布å¼åˆ—表,使用Promise异æ¥å›žè°ƒã€‚ **需è¦æƒé™ï¼š** ohos.permission.DISTRIBUTED_DATASYNC @@ -3054,24 +3051,28 @@ setDistributedTables(tables: Array<string>, type: number, config: Distribu **å‚数:** -| å‚æ•°å | 类型 | å¿…å¡« | 说明 | -| -------- | ----------------------------------- | --- | --------------- | -| tables | Array<string> | 是 | è¦è®¾ç½®çš„分布å¼åˆ—表表å。 | -| type | number | 是 | 表的分布å¼ç±»åž‹ã€‚ç›®å‰æ”¯æŒçš„å…¥å‚值为: DISTRIBUTED_DEVICEã€relationalStore.DistributedType.DISTRIBUTED_CLOUD。<br> 当type为relationalStore.DistributedType.DISTRIBUTED_DEVICE时,表示表在ä¸åŒè®¾å¤‡ä¹‹é—´åˆ†å¸ƒå¼ã€‚<br> 当type为relationalStore.DistributedType.DISTRIBUTED_CLOUD时,表示表在设备和云端之间分布å¼ã€‚ | -| config | [DistributedConfig](#distributedconfig10) | 是 | 表的分布å¼é…置信æ¯ã€‚ | -| callback | AsyncCallback<void> | 是 | 指定callback回调函数。 | +| å‚æ•°å | 类型 | å¿…å¡« | 说明 | +| ------ | ----------------------------------------- | ---- | ------------------------------------------------------------ | +| tables | Array<string> | 是 | è¦è®¾ç½®çš„分布å¼åˆ—表表å。 | +| type | number | å¦ | 表的分布å¼ç±»åž‹ã€‚默认值是relationalStore.DistributedType.DISTRIBUTED_DEVICE。<br> ç›®å‰æ”¯æŒçš„å…¥å‚值为: relationalStore.DistributedType.DISTRIBUTED_DEVICEã€relationalStore.DistributedType.DISTRIBUTED_CLOUD。<br/> 当type为relationalStore.DistributedType.DISTRIBUTED_DEVICE时,表示表在ä¸åŒè®¾å¤‡ä¹‹é—´åˆ†å¸ƒå¼ã€‚<br/> 当type为relationalStore.DistributedType.DISTRIBUTED_CLOUD时,表示表在设备和云端之间分布å¼ã€‚ | +| config | [DistributedConfig](#distributedconfig10) | å¦ | 表的分布å¼é…置信æ¯ã€‚ä¸ä¼ 入时默认autoSync为false,å³åªæ”¯æŒæ‰‹åŠ¨åŒæ¥ã€‚ | + +**返回值**: + +| 类型 | 说明 | +| ------------------- | ------------------------- | +| Promise<void> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```js let config = new DistributedConfig(); config.autoSync = true; -store.setDistributedTables(["EMPLOYEE"], relationalStore.DistributedType.DISTRIBUTED_CLOUD, config, function (err) { - if (err) { - console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); - return; - } +let promise = store.setDistributedTables(["EMPLOYEE"], relationalStore.DistributedType.DISTRIBUTED_CLOUD, config); +promise.then(() => { console.info(`SetDistributedTables successfully.`); +}).catch((err) => { + console.error(`SetDistributedTables failed, code is ${err.code},message is ${err.message}`); }) ``` @@ -3317,7 +3318,7 @@ promise.then((result) =>{ on(event: 'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void -注册数æ®åº“的观察者。当分布å¼æ•°æ®åº“ä¸çš„æ•°æ®å‘生更改时,将调用回调。 +注册数æ®åº“çš„æ•°æ®å˜æ›´çš„事件监å¬ã€‚当分布å¼æ•°æ®åº“ä¸çš„æ•°æ®å‘生更改时,将调用回调。 **系统能力:** SystemCapability.DistributedDataManager.RelationalStore.Core @@ -3358,7 +3359,7 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback<Array<stri | -------- | ----------------------------------- | ---- | ------------------------------------------- | | event | string | 是 | å–值为'dataChange',表示数æ®æ›´æ”¹ã€‚ | | type | [SubscribeType](#subscribetype) | 是 | 订阅类型。 | -| observer | Callback<Array<string>> \| Callback<Array<ChangeInfo>><sup>10+</sup> | 是 | 回调函数。<br>当type为SUBSCRIBE_TYPE_REMOTE,observer类型需为Callback<Array<string>>,其ä¸Array<string>为数æ®åº“ä¸çš„æ•°æ®å‘生改å˜çš„对端设备ID。<br> 当type为SUBSCRIBE_TYPE_CLOUD,observer类型需为Callback<Array<string>>,其ä¸Array<string>为数æ®åº“ä¸çš„æ•°æ®å‘生改å˜çš„云端å¸å·ã€‚ <br> 当type为SUBSCRIBE_TYPE_CLOUD_DETAILS,observer类型需为Callback<Array<ChangeInfo>>,其ä¸Array<ChangeInfo>为数æ®åº“端云åŒæ¥è¿‡ç¨‹çš„详情。 | +| observer | Callback<Array<string>> \| Callback<Array<ChangeInfo>> | 是 | 回调函数。<br>当type为SUBSCRIBE_TYPE_REMOTE,observer类型需为Callback<Array<string>>,其ä¸Array<string>为数æ®åº“ä¸çš„æ•°æ®å‘生改å˜çš„对端设备ID。<br> 当type为SUBSCRIBE_TYPE_CLOUD,observer类型需为Callback<Array<string>>,其ä¸Array<string>为数æ®åº“ä¸çš„æ•°æ®å‘生改å˜çš„云端å¸å·ã€‚ <br> 当type为SUBSCRIBE_TYPE_CLOUD_DETAILS,observer类型需为Callback<Array<ChangeInfo>>,其ä¸Array<ChangeInfo>为数æ®åº“端云åŒæ¥è¿‡ç¨‹çš„详情。 | **示例:** @@ -3379,7 +3380,7 @@ try { off(event:'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void -从数æ®åº“ä¸åˆ 除指定类型的指定观察者, 使用callback异æ¥å›žè°ƒã€‚ +å–消数æ®å˜æ›´çš„事件监å¬ã€‚ **系统能力:** SystemCapability.DistributedDataManager.RelationalStore.Core