!23805 [翻译完成】#I7W570

Merge pull request !23805 from Annie_wang/PR23009

en/application-dev/database/data-persistence-by-preferences.md

@@ -30,23 +30,23 @@ The preference persistent file of an application is stored in the application sa
 
 The following table lists the APIs used for persisting user preference data. For more information about the APIs, see [User Preferences](../reference/apis/js-apis-data-preferences.md).
 
-  | API                                                                                            | Description                                                        | 
-|--------------------------------------------------------------------------------------------------|------------------------------------------------------------|
-| getPreferences(context: Context, name: string, callback: AsyncCallback<Preferences>): void | Obtain a **Preferences** instance.                                          | 
-| putSync(key: string, value: ValueType): void                | Writes data to the Preferences instance. You can use **flush()** to persist the **Preferences** instance data. An asynchronous API is also provided.   | 
-| hasSync(key: string): void                                   | Checks whether the **Preferences** instance contains a KV pair with the given key. The key cannot be empty. An asynchronous API is also provided.   | 
-| getSync(key: string, defValue: ValueType): void            | Obtains the value of the specified key. If the value is null or not of the default value type, **defValue** is returned. An asynchronous API is also provided.        | 
-| deleteSync(key: string): void                                   | Deletes the KV pair with the given key from the **Preferences** instance. An asynchronous API is also provided.                 | 
-| flush(callback: AsyncCallback<void>): void                                                 | Flushes the data of this **Preferences** instance to a file for data persistence.                      | 
-| on(type: 'change', callback: Callback<{ key : string }>): void                             | Subscribes to data changes of the specified key. When the value of the specified key is changed and saved by **flush()**, a callback will be invoked to return the new data.            | 
-| off(type: 'change', callback?: Callback<{ key : string }>): void                           | Unsubscribes from data changes.                                                 | 
-| deletePreferences(context: Context, name: string, callback: AsyncCallback<void>): void     | Deletes a **Preferences** instance from memory. If the **Preferences** instance has a persistent file, this API also deletes the persistent file.| 
+| API                                                          | Description                                                  |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| getPreferences(context: Context, name: string, callback: AsyncCallback<Preferences>): void | Obtains a **Preferences** instance.                          |
+| putSync(key: string, value: ValueType): void                 | Writes data to the Preferences instance. You can use **flush()** to persist the **Preferences** instance data. An asynchronous API is also provided. |
+| hasSync(key: string): void                                   | Checks whether the **Preferences** instance contains a KV pair with the given key. The key cannot be empty. An asynchronous API is also provided. |
+| getSync(key: string, defValue: ValueType): void              | Obtains the value of the specified key. If the value is null or not of the default value type, **defValue** is returned. An asynchronous API is also provided. |
+| deleteSync(key: string): void                                | Deletes the KV pair with the given key from the **Preferences** instance. An asynchronous API is also provided. |
+| flush(callback: AsyncCallback<void>): void             | Flushes the data of this **Preferences** instance to a file for data persistence. |
+| on(type: 'change', callback: Callback<{ key : string }>): void | Subscribes to data changes of the specified key. When the value of the specified key is changed and saved by **flush()**, a callback will be invoked to return the new data. |
+| off(type: 'change', callback?: Callback<{ key : string }>): void | Unsubscribes from data changes.                              |
+| deletePreferences(context: Context, name: string, callback: AsyncCallback<void>): void | Deletes a **Preferences** instance from memory. If the **Preferences** instance has a persistent file, this API also deletes the persistent file. |
 
 
 ## How to Develop
 
 1. Import the **@ohos.data.preferences** module.
-     
+   
    ```js
    import dataPreferences from '@ohos.data.preferences';
    ```
@@ -55,14 +55,16 @@ The following table lists the APIs used for persisting user preference data. For
 
    Stage model:
 
-     
+   
    ```js
    import UIAbility from '@ohos.app.ability.UIAbility';
+   import { BusinessError } from '@ohos.base';
+   import window from '@ohos.window';
    
    class EntryAbility extends UIAbility {
-     onWindowStageCreate(windowStage) {
+     onWindowStageCreate(windowStage: window.WindowStage) {
        try {
-         dataPreferences.getPreferences(this.context, 'mystore', (err, preferences) => {
+         dataPreferences.getPreferences(this.context, 'myStore', (err: BusinessError, preferences: dataPreferences.Preferences) => {
            if (err) {
              console.error(`Failed to get preferences. Code:${err.code},message:${err.message}`);
              return;
@@ -79,15 +81,16 @@ The following table lists the APIs used for persisting user preference data. For
 
    FA model:
 
-     
+   
    ```js
    import featureAbility from '@ohos.ability.featureAbility';
+   import { BusinessError } from '@ohos.base';
    
    // Obtain the context.
    let context = featureAbility.getContext();
    
    try {
-     dataPreferences.getPreferences(context, 'mystore', (err, preferences) => {
+     dataPreferences.getPreferences(this.context, 'myStore', (err: BusinessError, preferences: dataPreferences.Preferences) => {
        if (err) {
          console.error(`Failed to get preferences. Code:${err.code},message:${err.message}`);
          return;
@@ -102,7 +105,7 @@ The following table lists the APIs used for persisting user preference data. For
 
 3. Write data.
 
-   Use **putSync()** to write data to the cached **Preferences** instance. After data is written, you can use **flush()** to persist the **Preferences** instance data to a file if necessary.
+   Use **putSync()** to save data to the cached **Preferences** instance. After data is written, you can use **flush()** to persist the **Preferences** instance data to a file if necessary.
 
    > **NOTE**
    >
@@ -110,7 +113,7 @@ The following table lists the APIs used for persisting user preference data. For
 
    Example:
 
-     
+   
    ```js
    try {
      if (preferences.hasSync('startup')) {
@@ -142,7 +145,7 @@ The following table lists the APIs used for persisting user preference data. For
 
    Use **deleteSync()** to delete a KV pair.<br>Example:
 
-     
+   
    ```js
    try {
      preferences.deleteSync('startup');
@@ -157,7 +160,7 @@ The following table lists the APIs used for persisting user preference data. For
      
    ```js
    try {
-     preferences.flush((err) => {
+     preferences.flush((err: BusinessError) => {
        if (err) {
          console.error(`Failed to flush. Code:${err.code}, message:${err.message}`);
          return;
@@ -174,18 +177,20 @@ The following table lists the APIs used for persisting user preference data. For
      Specify an observer as the callback to return the data changes for an application. When the value of the subscribed key is changed and saved by **flush()**, the observer callback will be invoked to return the new data. Example:
      
    ```js
-   let observer = function (key) {
-     console.info('The key' + key + 'changed.');
+   interface observer {
+      key: string
    }
-   preferences.on('change', observer);
+   preferences.on('change', (key: observer) => {
+     console.info('The key' + key + 'changed.');
+   });
    // The data is changed from 'auto' to 'manual'.
-   preferences.put('startup', 'manual', (err) => {
+   preferences.put('startup', 'manual', (err: BusinessError) => {
      if (err) {
        console.error(`Failed to put the value of 'startup'. Code:${err.code},message:${err.message}`);
        return;
      }
      console.info("Succeeded in putting the value of 'startup'.");
-     preferences.flush((err) => {
+     preferences.flush((err: BusinessError) => {
        if (err) {
          console.error(`Failed to flush. Code:${err.code}, message:${err.message}`);
          return;
@@ -207,10 +212,10 @@ The following table lists the APIs used for persisting user preference data. For
 
    Example:
 
-     
+   
    ```js
    try {
-     dataPreferences.deletePreferences(this.context, 'mystore', (err, val) => {
+     dataPreferences.deletePreferences(this.context, 'myStore', (err: BusinessError) => {
        if (err) {
          console.error(`Failed to delete preferences. Code:${err.code}, message:${err.message}`);
          return;