!2999 修改Preferences的示例程序

Merge pull request !2999 from PaDaBoo/master

zh-cn/application-dev/reference/apis/js-apis-data-preferences.md

@@ -10,7 +10,7 @@
 ## 导入模块
 
 ```
-import data_Preferences from '@ohos.data.preferences'
+import data_preferences from '@ohos.data.preferences'
 ```
 
 ## 属性
@@ -23,7 +23,7 @@ import data_Preferences from '@ohos.data.preferences'
 | MAX_VALUE_LENGTH | string | 是 | 否 | string类型value的最大长度限制，大小为8192字节。 |
 
 
-## data_Preferences.getPreferences
+## data_preferences.getPreferences
 
 getPreferences(context: Context, name: string, callback: AsyncCallback<Preferences>): void
 
@@ -42,20 +42,32 @@ getPreferences(context: Context, name: string, callback: AsyncCallback<Prefer
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
+  import data_preferences from '@ohos.data.preferences'
   var path = this.context.getDataBaseDir()
-  data_Preferences.getPreferences(this.context, 'mystore', function (err, preferences) {
+  data_preferences.getPreferences(this.context, 'mystore', function (err, preferences) {
       if (err) {
           console.info("Get the preferences failed, path: " + path + '/mystore')
           return;
       }
-      preferences.putSync('startup', 'auto')
-      preferences.flushSync()
+      preferences.put('startup', 'auto', function (err) {
+          if (err) {
+              console.info("Put the value of startup failed with err: " + err)
+              return
+          }
+          console.info("Put the value of startup successfully.")
+          preferences.flush(function (err) {
+              if (err) {
+                  console.info("Flush to file failed with err: " + err)
+                  return
+              }
+              console.info("Flushed to file successfully.")
+          })
+      })
   })
   ```
 
 
-## data_Preferences.getPreferences
+## data_preferences.getPreferences
 
 getPreferences(context: Context, name: string): Promise<Preferences>
 
@@ -77,19 +89,31 @@ getPreferences(context: Context, name: string): Promise<Preferences>
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
+  import data_preferences from '@ohos.data.preferences'
   var path = this.context.getDataBaseDir()
-  let promisePre = data_Preferences.getPreferences(this.context, 'mystore')
+  let promisePre = data_preferences.getPreferences(this.context, 'mystore')
   promisePre.then((preferences) => {
-      preferences.putSync('startup', 'auto')
-      preferences.flushSync()
+      preferences.put('startup', 'auto', function (err) {
+          if (err) {
+              console.info("Put the value of startup failed with err: " + err)
+              return
+          }
+          console.info("Put the value of startup successfully.")
+          preferences.flush(function (err) {
+              if (err) {
+                  console.info("Flush to file failed with err: " + err)
+                  return
+              }
+              console.info("Flushed to file successfully.")
+          })
+      })
   }).catch((err) => {
       console.info("Get the preferences failed, path: " + path + '/mystore')
   })
   ```
 
 
-## data_Preferences.deletePreferences
+## data_preferences.deletePreferences
 
 deletePreferences(context: Context, name: string, callback: AsyncCallback<void>): void
 
@@ -107,8 +131,8 @@ deletePreferences(context: Context, name: string, callback: AsyncCallback<voi
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
-  data_Preferences.deletePreferences(this.context, 'mystore', function (err) {
+  import data_preferences from '@ohos.data.preferences'
+  data_preferences.deletePreferences(this.context, 'mystore', function (err) {
       if (err) {
           console.info("Deleted failed with err: " + err)
           return
@@ -118,7 +142,7 @@ deletePreferences(context: Context, name: string, callback: AsyncCallback<voi
   ```
 
 
-## data_Preferences.deletePreferences
+## data_preferences.deletePreferences
 
 deletePreferences(context: Context, name: string): Promise<void>
 
@@ -140,8 +164,8 @@ deletePreferences(context: Context, name: string): Promise<void>
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
-  let promisedelPre = data_Preferences.deletePreferences(this.context, 'mystore')
+  import data_preferences from '@ohos.data.preferences'
+  let promisedelPre = data_preferences.deletePreferences(this.context, 'mystore')
   promisedelPre.then(() => {
       console.info("Deleted successfully.")
   }).catch((err) => {
@@ -150,7 +174,7 @@ deletePreferences(context: Context, name: string): Promise<void>
   ```
 
 
-## data_Preferences.removePreferencesFromCache
+## data_preferences.removePreferencesFromCache
 
 removePreferencesFromCache(context: Context, name: string, callback: AsyncCallback<void>): void
 
@@ -170,8 +194,8 @@ removePreferencesFromCache(context: Context, name: string, callback: AsyncCallba
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
-  data_Preferences.removePreferencesFromCache(this.context, 'mystore', function (err) {
+  import data_preferences from '@ohos.data.preferences'
+  data_preferences.removePreferencesFromCache(this.context, 'mystore', function (err) {
       if (err) {
           console.info("Removed preferences from cache failed with err: " + err)
           return
@@ -181,7 +205,7 @@ removePreferencesFromCache(context: Context, name: string, callback: AsyncCallba
   ```
 
 
-## data_Preferences.removePreferencesFromCache
+## data_preferences.removePreferencesFromCache
 
 removePreferencesFromCache(context: Context, name: string): Promise<void>
 
@@ -205,8 +229,8 @@ removePreferencesFromCache(context: Context, name: string): Promise<void>
 - 示例：
   ```
   import Ability from '@ohos.application.Ability'
-  import data_Preferences from '@ohos.data.preferences'
-  let promiserevPre = data_Preferences.removePreferencesFromCache(this.context, 'mystore')
+  import data_preferences from '@ohos.data.preferences'
+  let promiserevPre = data_preferences.removePreferencesFromCache(this.context, 'mystore')
   promiserevPre.then(() => {
       console.info("Removed preferences from cache successfully.")
   }).catch((err) => {
@@ -595,8 +619,20 @@ on(type: 'change', callback: Callback<{ key : string }>): void
       console.info("The key of " + key + " changed.")
   }
   preferences.on('change', observer)
-  preferences.put('startup', 'auto')
-  preferences.flush()  // observer will be called.
+  preferences.put('startup', 'auto', function (err) {
+      if (err) {
+          console.info("Put the value of startup failed with err: " + err)
+          return
+      }
+      console.info("Put the value of startup successfully.")
+      preferences.flush(function (err) {
+          if (err) {
+              console.info("Flush to file failed with err: " + err)
+              return
+          }
+          console.info("Flushed to file successfully.")    // observer will be called.
+      })
+  })  
   ```