Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“047f3a766c93cb78ea1b4a582c08e8f277bbfdd7”上不存在“...paddle/v2/git@gitcode.net:s920243400/PaddleDetection.git”
未验证 提交 01c1b6f5 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!22692 [翻译完成】#I7TG15 

Merge pull request !22692 from Annie_wang/PR22305
上级 376090a0 24a00a63
显示空白变更内容
内联 并排
Showing with 95 addition and 93 deletion
en/application-dev/reference/apis/js-apis-data-preferences.md
浏览文件 @ 01c1b6f5
# @ohos.data.preferences (User Preferences) # @ohos.data.preferences (User Preferences)
The **user preferences** module provides APIs for processing data in the form of key-value (KV) pairs and supports persistence of the KV pairs when required. The **Preferences** module provides APIs for processing data in the form of key-value (KV) pairs, and supports persistence of the KV pairs when required, as well as modification and query of the data.
The key is of the string type, and the value can be a number, a string, a Boolean value, or an array of numbers, strings, or Boolean values. The key is of the string type, and the value can be a number, a string, a Boolean value, or an array of numbers, strings, or Boolean values.
...@@ -55,14 +55,14 @@ let preferences = null; ...@@ -55,14 +55,14 @@ let preferences = null;
try { try {
data_preferences.getPreferences(context, 'mystore', function (err, val) { data_preferences.getPreferences(context, 'mystore', function (err, val) {
if (err) { if (err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
preferences = val; preferences = val;
console.info("Obtained the preferences successfully."); console.info("Succeeded in getting preferences.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -78,14 +78,14 @@ class EntryAbility extends UIAbility { ...@@ -78,14 +78,14 @@ class EntryAbility extends UIAbility {
try { try {
data_preferences.getPreferences(this.context, 'mystore', function (err, val) { data_preferences.getPreferences(this.context, 'mystore', function (err, val) {
if (err) { if (err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
preferences = val; preferences = val;
console.info("Obtained the preferences successfully."); console.info("Succeeded in getting preferences.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -126,12 +126,12 @@ try { ...@@ -126,12 +126,12 @@ try {
let promise = data_preferences.getPreferences(context, 'mystore'); let promise = data_preferences.getPreferences(context, 'mystore');
promise.then((object) => { promise.then((object) => {
preferences = object; preferences = object;
console.info("Obtained the preferences successfully."); console.info("Succeeded in getting preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -148,12 +148,12 @@ class EntryAbility extends UIAbility { ...@@ -148,12 +148,12 @@ class EntryAbility extends UIAbility {
let promise = data_preferences.getPreferences(this.context, 'mystore'); let promise = data_preferences.getPreferences(this.context, 'mystore');
promise.then((object) => { promise.then((object) => {
preferences = object; preferences = object;
console.info("Obtained the preferences successfully."); console.info("Succeeded in getting preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to obtain the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -199,13 +199,13 @@ let context = featureAbility.getContext(); ...@@ -199,13 +199,13 @@ let context = featureAbility.getContext();
try { try {
data_preferences.deletePreferences(context, 'mystore', function (err) { data_preferences.deletePreferences(context, 'mystore', function (err) {
if (err) { if (err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Deleted the preferences successfully." ); console.info("Succeeded in deleting preferences." );
}) })
} catch (err) { } catch (err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -213,19 +213,18 @@ Stage model: ...@@ -213,19 +213,18 @@ Stage model:
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class EntryAbility extends UIAbility { class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
try { try {
data_preferences.deletePreferences(this.context, 'mystore', function (err) { data_preferences.deletePreferences(this.context, 'mystore', function (err) {
if (err) { if (err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Deleted the preferences successfully." ); console.info("Succeeded in deleting preferences." );
}) })
} catch (err) { } catch (err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -276,12 +275,12 @@ let context = featureAbility.getContext(); ...@@ -276,12 +275,12 @@ let context = featureAbility.getContext();
try { try {
let promise = data_preferences.deletePreferences(context, 'mystore'); let promise = data_preferences.deletePreferences(context, 'mystore');
promise.then(() => { promise.then(() => {
console.info("Deleted the preferences successfully."); console.info("Succeeded in deleting preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -289,18 +288,17 @@ Stage model: ...@@ -289,18 +288,17 @@ Stage model:
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class EntryAbility extends UIAbility { class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
try{ try{
let promise = data_preferences.deletePreferences(this.context, 'mystore'); let promise = data_preferences.deletePreferences(this.context, 'mystore');
promise.then(() => { promise.then(() => {
console.info("Deleted the preferences successfully."); console.info("Succeeded in deleting preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to delete the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -336,13 +334,13 @@ let context = featureAbility.getContext(); ...@@ -336,13 +334,13 @@ let context = featureAbility.getContext();
try { try {
data_preferences.removePreferencesFromCache(context, 'mystore', function (err) { data_preferences.removePreferencesFromCache(context, 'mystore', function (err) {
if (err) { if (err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Removed the preferences successfully."); console.info("Succeeded in removing preferences.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -350,19 +348,18 @@ Stage model: ...@@ -350,19 +348,18 @@ Stage model:
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class EntryAbility extends UIAbility { class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
try { try {
data_preferences.removePreferencesFromCache(this.context, 'mystore', function (err) { data_preferences.removePreferencesFromCache(this.context, 'mystore', function (err) {
if (err) { if (err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Removed the preferences successfully."); console.info("Succeeded in removing preferences.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -404,12 +401,12 @@ let context = featureAbility.getContext(); ...@@ -404,12 +401,12 @@ let context = featureAbility.getContext();
try { try {
let promise = data_preferences.removePreferencesFromCache(context, 'mystore'); let promise = data_preferences.removePreferencesFromCache(context, 'mystore');
promise.then(() => { promise.then(() => {
console.info("Removed the preferences successfully."); console.info("Succeeded in removing preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -423,12 +420,12 @@ class EntryAbility extends UIAbility { ...@@ -423,12 +420,12 @@ class EntryAbility extends UIAbility {
try { try {
let promise = data_preferences.removePreferencesFromCache(this.context, 'mystore'); let promise = data_preferences.removePreferencesFromCache(this.context, 'mystore');
promise.then(() => { promise.then(() => {
console.info("Removed the preferences successfully."); console.info("Succeeded in removing preferences.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to remove the preferences. code =" + err.code + ", message =" + err.message); console.error("Failed to remove preferences. code =" + err.code + ", message =" + err.message);
} }
} }
} }
...@@ -436,7 +433,7 @@ class EntryAbility extends UIAbility { ...@@ -436,7 +433,7 @@ class EntryAbility extends UIAbility {
## Preferences ## Preferences
Provides methods for obtaining and modifying data. Provides APIs for obtaining and modifying data.
Before calling any method of **Preferences**, you must obtain a **Preferences** instance by using [data_preferences.getPreferences](#data_preferencesgetpreferences). Before calling any method of **Preferences**, you must obtain a **Preferences** instance by using [data_preferences.getPreferences](#data_preferencesgetpreferences).
...@@ -463,13 +460,13 @@ Obtains the value of a key. This API uses an asynchronous callback to return the ...@@ -463,13 +460,13 @@ Obtains the value of a key. This API uses an asynchronous callback to return the
try { try {
preferences.get('startup', 'default', function (err, val) { preferences.get('startup', 'default', function (err, val) {
if (err) { if (err) {
console.info("Failed to obtain the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Obtained the value of 'startup' successfully. val: " + val); console.info("Obtained the value of 'startup' successfully. val: " + val);
}) })
} catch (err) { } catch (err) {
console.info("Failed to obtain the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -503,10 +500,10 @@ try { ...@@ -503,10 +500,10 @@ try {
promise.then((data) => { promise.then((data) => {
console.info("Got the value of 'startup'. Data: " + data); console.info("Got the value of 'startup'. Data: " + data);
}).catch((err) => { }).catch((err) => {
console.info("Failed to obtain the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to obtain the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -514,7 +511,7 @@ try { ...@@ -514,7 +511,7 @@ try {
getAll(callback: AsyncCallback<Object>): void; getAll(callback: AsyncCallback<Object>): void;
Obtains an **Object** instance that contains all KV pairs. This API uses an asynchronous callback to return the result. Obtains all KV pairs from the cached **Preferences** instance. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.Preferences.Core **System capability**: SystemCapability.DistributedDataManager.Preferences.Core
...@@ -522,7 +519,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses an asyn ...@@ -522,7 +519,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses an asyn
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ | | -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback<Object> | Yes | Callback invoked to return the result. If the operation is successful, **err** is **undefined** and **value** is the **Object** instance obtained. Otherwise, **err** is an error object.| | callback | AsyncCallback<Object> | Yes | Callback invoked to return the result. If the operation is successful, **err** is **undefined** and **value** provides all KV pairs obtained. Otherwise, **err** is an error object.|
**Example** **Example**
...@@ -530,7 +527,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses an asyn ...@@ -530,7 +527,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses an asyn
try { try {
preferences.getAll(function (err, value) { preferences.getAll(function (err, value) {
if (err) { if (err) {
console.info("Failed to get all KV pairs. code =" + err.code + ", message =" + err.message); console.error("Failed to get all key-values. code =" + err.code + ", message =" + err.message);
return; return;
} }
let allKeys = Object.keys(value); let allKeys = Object.keys(value);
...@@ -538,7 +535,7 @@ try { ...@@ -538,7 +535,7 @@ try {
console.info("getAll object = " + JSON.stringify(value)); console.info("getAll object = " + JSON.stringify(value));
}) })
} catch (err) { } catch (err) {
console.info("Failed to obtain all KV pairs. code =" + err.code + ", message =" + err.message); console.error("Failed to get all key-values. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -547,7 +544,7 @@ try { ...@@ -547,7 +544,7 @@ try {
getAll(): Promise<Object> getAll(): Promise<Object>
Obtains an **Object** instance that contains all KV pairs. This API uses a promise to return the result. Obtains all KV pairs from the cached **Preferences** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.DistributedDataManager.Preferences.Core **System capability**: SystemCapability.DistributedDataManager.Preferences.Core
...@@ -555,7 +552,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses a promi ...@@ -555,7 +552,7 @@ Obtains an **Object** instance that contains all KV pairs. This API uses a promi
| Type | Description | | Type | Description |
| --------------------- | ------------------------------------------- | | --------------------- | ------------------------------------------- |
| Promise<Object> | Promise used to return the **Object** instance obtained.| | Promise<Object> | Promise used to return the KV pairs obtained, in an **Object** instance.|
**Example** **Example**
...@@ -567,10 +564,10 @@ try { ...@@ -567,10 +564,10 @@ try {
console.info('getAll keys = ' + allKeys); console.info('getAll keys = ' + allKeys);
console.info("getAll object = " + JSON.stringify(value)); console.info("getAll object = " + JSON.stringify(value));
}).catch((err) => { }).catch((err) => {
console.info("Failed to obtain all KV pairs. code =" + err.code + ", message =" + err.message); console.error("Failed to get all key-values. code =" + err.code + ", message =" + err.message);
}) })
} catch (err) { } catch (err) {
console.info("Failed to obtain all KV pairs. code =" + err.code + ", message =" + err.message); console.error("Failed to get all key-values. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -596,13 +593,13 @@ Writes data to this **Preferences** instance. This API uses an asynchronous call ...@@ -596,13 +593,13 @@ Writes data to this **Preferences** instance. This API uses an asynchronous call
try { try {
preferences.put('startup', 'auto', function (err) { preferences.put('startup', 'auto', function (err) {
if (err) { if (err) {
console.info("Failed to put the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to put value of 'startup'. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Put the value of 'startup' successfully."); console.info("Successfully put the value of 'startup'.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to put the value of 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to put value of 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -634,12 +631,12 @@ Writes data to this **Preferences** instance. This API uses a promise to return ...@@ -634,12 +631,12 @@ Writes data to this **Preferences** instance. This API uses a promise to return
try { try {
let promise = preferences.put('startup', 'auto'); let promise = preferences.put('startup', 'auto');
promise.then(() => { promise.then(() => {
console.info("Put the value of 'startup' successfully."); console.info("Successfully put the value of 'startup'.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to put the value of 'startup'. code =" + err.code +", message =" + err.message); console.error("Failed to put value of 'startup'. code =" + err.code +", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to put the value of 'startup'. code =" + err.code +", message =" + err.message); console.error("Failed to put value of 'startup'. code =" + err.code +", message =" + err.message);
} }
``` ```
...@@ -665,7 +662,7 @@ Checks whether this **Preferences** instance contains a KV pair with the given k ...@@ -665,7 +662,7 @@ Checks whether this **Preferences** instance contains a KV pair with the given k
try { try {
preferences.has('startup', function (err, val) { preferences.has('startup', function (err, val) {
if (err) { if (err) {
console.info("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);
return; return;
} }
if (val) { if (val) {
...@@ -675,7 +672,7 @@ try { ...@@ -675,7 +672,7 @@ try {
} }
}) })
} catch (err) { } catch (err) {
console.info("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -712,10 +709,10 @@ try { ...@@ -712,10 +709,10 @@ try {
console.info("The key 'startup' is not contained."); console.info("The key 'startup' is not contained.");
} }
}).catch((err) => { }).catch((err) => {
console.info("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -741,13 +738,13 @@ Deletes a KV pair from this **Preferences** instance based on the specified key. ...@@ -741,13 +738,13 @@ Deletes a KV pair from this **Preferences** instance based on the specified key.
try { try {
preferences.delete('startup', function (err) { preferences.delete('startup', function (err) {
if (err) { if (err) {
console.info("Failed to delete the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to delete the key 'startup'. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Deleted the key 'startup'."); console.info("Deleted the key 'startup'.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to delete the key 'startup'. code =" + err.code + ", message =" + err.message); console.error("Failed to delete the key 'startup'. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -780,10 +777,10 @@ try { ...@@ -780,10 +777,10 @@ try {
promise.then(() => { promise.then(() => {
console.info("Deleted the key 'startup'."); console.info("Deleted the key 'startup'.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message); console.error("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message); console.error("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message);
} }
``` ```
...@@ -792,7 +789,7 @@ try { ...@@ -792,7 +789,7 @@ try {
flush(callback: AsyncCallback<void>): void flush(callback: AsyncCallback<void>): void
Saves the data of this **Preferences** instance to a file asynchronously. This API uses an asynchronous callback to return the result. Flushes the data in this **Preferences** instance to its persistent file. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.DistributedDataManager.Preferences.Core **System capability**: SystemCapability.DistributedDataManager.Preferences.Core
...@@ -808,13 +805,13 @@ Saves the data of this **Preferences** instance to a file asynchronously. This A ...@@ -808,13 +805,13 @@ Saves the data of this **Preferences** instance to a file asynchronously. This A
try { try {
preferences.flush(function (err) { preferences.flush(function (err) {
if (err) { if (err) {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Flushed data successfully."); console.info("Successfully flushed data.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -823,7 +820,7 @@ try { ...@@ -823,7 +820,7 @@ try {
flush(): Promise<void> flush(): Promise<void>
Saves the data of this **Preferences** instance to a file asynchronously. This API uses a promise to return the result. Flushes the data in this **Preferences** instance to its persistent file. This API uses a promise to return the result.
**System capability**: SystemCapability.DistributedDataManager.Preferences.Core **System capability**: SystemCapability.DistributedDataManager.Preferences.Core
...@@ -839,12 +836,12 @@ Saves the data of this **Preferences** instance to a file asynchronously. This A ...@@ -839,12 +836,12 @@ Saves the data of this **Preferences** instance to a file asynchronously. This A
try { try {
let promise = preferences.flush(); let promise = preferences.flush();
promise.then(() => { promise.then(() => {
console.info("Flushed data successfully."); console.info("Successfully flushed data.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
}) })
} catch (err) { } catch (err) {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -869,13 +866,13 @@ Clears this **Preferences** instance. This API uses an asynchronous callback to ...@@ -869,13 +866,13 @@ Clears this **Preferences** instance. This API uses an asynchronous callback to
try { try {
preferences.clear(function (err) { preferences.clear(function (err) {
if (err) { if (err) {
console.info("Failed to clear data. code =" + err.code + ", message =" + err.message); console.error("Failed to clear. code =" + err.code + ", message =" + err.message);
return; return;
} }
console.info("Cleared data successfully."); console.info("Successfully cleared data.");
}) })
} catch (err) { } catch (err) {
console.info("Failed to clear data. code =" + err.code + ", message =" + err.message); console.error("Failed to clear. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -900,12 +897,12 @@ Clears this **Preferences** instance. This API uses a promise to return the resu ...@@ -900,12 +897,12 @@ Clears this **Preferences** instance. This API uses a promise to return the resu
try { try {
let promise = preferences.clear(); let promise = preferences.clear();
promise.then(() => { promise.then(() => {
console.info("Cleared data successfully."); console.info("Successfully cleared data.");
}).catch((err) => { }).catch((err) => {
console.info("Failed to clear data. code =" + err.code + ", message =" + err.message); console.error("Failed to clear. code =" + err.code + ", message =" + err.message);
}) })
} catch(err) { } catch(err) {
console.info("Failed to clear data. code =" + err.code + ", message =" + err.message); console.error("Failed to clear. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -931,7 +928,7 @@ Subscribes to data changes. A callback will be triggered to return the new value ...@@ -931,7 +928,7 @@ Subscribes to data changes. A callback will be triggered to return the new value
try { try {
data_preferences.getPreferences(this.context, 'mystore', function (err, preferences) { data_preferences.getPreferences(this.context, 'mystore', function (err, preferences) {
if (err) { if (err) {
console.info("Failed to obtain the preferences."); console.error("Failed to get preferences.");
return; return;
} }
let observer = function (key) { let observer = function (key) {
...@@ -940,22 +937,22 @@ try { ...@@ -940,22 +937,22 @@ try {
preferences.on('change', observer); preferences.on('change', observer);
preferences.put('startup', 'manual', function (err) { preferences.put('startup', 'manual', function (err) {
if (err) { if (err) {
console.info("Failed to put the value of 'startup'. Cause: " + err); console.error("Failed to put the value of 'startup'. Cause: " + err);
return; return;
} }
console.info("Put the value of 'startup' successfully."); console.info("Successfully put the value of 'startup'.");
preferences.flush(function (err) { preferences.flush(function (err) {
if (err) { if (err) {
console.info("Failed to flush data. Cause: " + err); console.error("Failed to flush. Cause: " + err);
return; return;
} }
console.info("Flushed data successfully."); console.info("Successfully flushed data.");
}) })
}) })
}) })
} catch (err) { } catch (err) {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
} }
``` ```
...@@ -981,7 +978,7 @@ Unsubscribes from data changes. ...@@ -981,7 +978,7 @@ Unsubscribes from data changes.
try { try {
data_preferences.getPreferences(this.context, 'mystore', function (err, preferences) { data_preferences.getPreferences(this.context, 'mystore', function (err, preferences) {
if (err) { if (err) {
console.info("Failed to obtain the preferences."); console.error("Failed to get preferences.");
return; return;
} }
let observer = function (key) { let observer = function (key) {
...@@ -990,23 +987,23 @@ try { ...@@ -990,23 +987,23 @@ try {
preferences.on('change', observer); preferences.on('change', observer);
preferences.put('startup', 'auto', function (err) { preferences.put('startup', 'auto', function (err) {
if (err) { if (err) {
console.info("Failed to put the value of 'startup'. Cause: " + err); console.error("Failed to put the value of 'startup'. Cause: " + err);
return; return;
} }
console.info("Successfully put the value of 'startup'."); console.info("Successfully put the value of 'startup'.");
preferences.flush(function (err) { preferences.flush(function (err) {
if (err) { if (err) {
console.info("Failed to flush data. Cause: " + err); console.error("Failed to flush. Cause: " + err);
return; return;
} }
console.info("Flushed data successfully."); console.info("Successfully flushed data.");
}) })
preferences.off('change', observer); preferences.off('change', observer);
}) })
}) })
} catch (err) { } catch (err) {
console.info("Failed to flush data. code =" + err.code + ", message =" + err.message); console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
} }
``` ```
......
en/application-dev/reference/errorcodes/errorcode-datashare.md
浏览文件 @ 01c1b6f5
...@@ -23,7 +23,12 @@ The **DataShareHelper** class fails to be created. ...@@ -23,7 +23,12 @@ The **DataShareHelper** class fails to be created.
**Solution** **Solution**
1. Obtain the correct URI. 1. Obtain the correct URI.
2. Check that the context of the stage model is used. 2. Check that the context of the stage model is used.
3. Check whether the client has the read or write permission on data. Perform the following steps: 3. Check whether the client has the read or write permission on data. Perform the following steps:
(1) Obtain the data provider bundle name in the path of the URI. For example, the bundle name in uri = "datashare:///com.acts.datasharetest" is **com.acts.datasharetest**. (1) Obtain the data provider bundle name in the path of the URI. For example, the bundle name in uri = "datashare:///com.acts.datasharetest" is **com.acts.datasharetest**.
(2) Obtain the configuration based on the bundle name. For example, run **bm dump --bundle-name com.acts.datasharetest** to obtain the **DataShareExtension** configuration, and check whether the data consumer has **readPermission** or **writePermission**. (2) Obtain the configuration based on the bundle name. For example, run **bm dump --bundle-name com.acts.datasharetest** to obtain the **DataShareExtension** configuration, and check whether the data consumer has **readPermission** or **writePermission**.
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或