!5666 翻译完成：4164 修改dataAbility开发资料

Merge pull request !5666 from wusongqing/TR4164

en/application-dev/ability/fa-dataability.md

@@ -6,32 +6,40 @@ Data ability providers can customize data access-related APIs such as data inser
 
 ## Available APIs
 
-**Table 1** Data ability lifecycle callbacks
+**Table 1** Data ability lifecycle APIs
 |API|Description|
 |:------|:------|
-|onInitialized|Called during ability initialization to initialize the relational database (RDB).|
-|update|Updates data in the database.|
-|query|Queries data in the database.|
-|delete|Deletes one or multiple data records from the database.|
-|normalizeUri|Normalizes the URI. A normalized URI applies to cross-device use, persistence, backup, and restore. When the context changes, it ensures that the same data item can be referenced.|
-|batchInsert|Inserts multiple data records into the database.|
-|denormalizeUri|Converts a normalized URI generated by **normalizeUri** into a denormalized URI.|
-|insert|Inserts a data record into the database.|
-|openFile|Opens a file.|
-|getFileTypes|Obtains the MIME type of a file.|
-|getType|Obtains the MIME type matching the data specified by the URI.|
-|executeBatch|Operates data in the database in batches.|
-|call|A customized API.|
+|onInitialized?(info: AbilityInfo): void|Called during ability initialization to initialize the relational database (RDB).|
+|update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void|Updates data in the database.|
+|query?(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>): void|Queries data in the database.|
+|delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void|Deletes one or more data records from the database.|
+|normalizeUri?(uri: string, callback: AsyncCallback\<string>): void|Normalizes the URI. A normalized URI applies to cross-device use, persistence, backup, and restore. When the context changes, it ensures that the same data item can be referenced.|
+|batchInsert?(uri: string, valueBuckets: Array\<rdb.ValuesBucket>, callback: AsyncCallback\<number>): void|Inserts multiple data records into the database.|
+|denormalizeUri?(uri: string, callback: AsyncCallback\<string>): void|Converts a normalized URI generated by **normalizeUri** into a denormalized URI.|
+|insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>): void|Inserts a data record into the database.|
+|openFile?(uri: string, mode: string, callback: AsyncCallback\<number>): void|Opens a file.|
+|getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback\<Array\<string>>): void|Obtains the MIME type of a file.|
+|getType?(uri: string, callback: AsyncCallback\<string>): void|Obtains the MIME type matching the data specified by the URI.|
+|executeBatch?(ops: Array\<DataAbilityOperation>, callback: AsyncCallback\<Array\<DataAbilityResult>>): void|Operates data in the database in batches.|
+|call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback\<PacMap>): void|Calls a custom API.|
 
 
 ## How to Develop
 ### Creating a Data Ability
 
-1. To meet the basic requirements of the database storage service, implement the **Insert**, **Query**, **Update**, and **Delete** APIs in the **Data** class to provide batch data processing. The traversal logic has been implemented by the **BatchInsert** and **ExecuteBatch** APIs.
+1. To meet the basic requirements of the database storage service, implement the **Insert**, **Query**, **Update**, and **Delete** APIs in the **Data** class. The **BatchInsert** and **ExecuteBatch** APIs have already implemented the traversal logic, but not batch data processing.
 
     The following code snippet shows how to create a Data ability:
 
    ```javascript
+    import dataAbility from '@ohos.data.dataAbility'
+    import dataRdb from '@ohos.data.rdb'
+
+    const TABLE_NAME = 'book'
+    const STORE_CONFIG = { name: 'book.db' }
+    const SQL_CREATE_TABLE = 'CREATE TABLE IF NOT EXISTS book(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, introduction TEXT NOT NULL)'
+    let rdbStore: dataRdb.RdbStore = undefined
+
     export default {
     onInitialized(abilityInfo) {
         console.info('DataAbility onInitialized, abilityInfo:' + abilityInfo.bundleName)
@@ -50,7 +58,7 @@ Data ability providers can customize data access-related APIs such as data inser
         for (let i = 0;i < valueBuckets.length; i++) {
             console.info('DataAbility batch insert i=' + i)
             if (i < valueBuckets.length - 1) {
-                rdbStore.insert(TABLE_NAME, valueBuckets[i], (num: number) => {
+                rdbStore.insert(TABLE_NAME, valueBuckets[i], (err: any, num: number) => {
                     console.info('DataAbility batch insert ret=' + num)
                 })
             } else {
@@ -76,7 +84,7 @@ Data ability providers can customize data access-related APIs such as data inser
     };
    ```
 
-2. Submodule Configuration
+2. Configure the submodule.
 
    | JSON Field| Description                                                    |
    | ------------ | ------------------------------------------------------------ |
@@ -89,15 +97,15 @@ Data ability providers can customize data access-related APIs such as data inser
 
    ```json
    "abilities":[{
-    "srcPath": "DataAbility",
-    "name": ".DataAbility",
-    "icon": "$media:icon",
-    "srcLanguage": "ets",
-    "description": "$string:description_dataability",
-    "type": "data",
-    "visible": true,
-    "uri": "dataability://ohos.samples.etsdataability.DataAbility"    
-   }]
+       "srcPath": "DataAbility",
+       "name": ".DataAbility",
+       "icon": "$media:icon",
+       "srcLanguage": "ets",
+       "description": "$string:description_dataability",
+       "type": "data",
+       "visible": true,
+       "uri": "dataability://ohos.samples.etsdataability.DataAbility"
+    }]
    ```
 
 ### Accessing a Data ability
@@ -118,6 +126,10 @@ The basic dependency packages include:
    For details about the APIs provided by **DataAbilityHelper**, see [DataAbilityHelper Module](../reference/apis/js-apis-dataAbilityHelper.md).
    ```js
    // Different from the URI defined in the config.json file, the URI passed in the parameter has an extra slash (/), because there is a DeviceID parameter between the second and the third slash (/).
+   import featureAbility from '@ohos.ability.featureAbility'
+   import ohos_data_ability from '@ohos.data.dataAbility'
+   import ohos_data_rdb from '@ohos.data.rdb'
+
    var urivar = "dataability:///com.ix.DataAbility"
    var DAHelper = featureAbility.acquireDataAbilityHelper(
     urivar
@@ -137,7 +149,7 @@ The basic dependency packages include:
     urivar,
     valuesBucket,
     (error, data) => {
-        expect(typeof(data)).assertEqual("number")
+        console.log("DAHelper insert result: " + data)
     }
    );
    ```
@@ -156,7 +168,7 @@ The basic dependency packages include:
     urivar,
     da,
     (error, data) => {
-        expect(typeof(data)).assertEqual("number")
+        console.log("DAHelper delete result: " + data)
     }
    );
    ```
@@ -176,7 +188,7 @@ The basic dependency packages include:
     valuesBucket,
     da,
     (error, data) => {
-        expect(typeof(data)).assertEqual("number")
+        console.log("DAHelper update result: " + data)
     }
    );
    ```
@@ -197,7 +209,7 @@ The basic dependency packages include:
     valArray,
     da,
     (error, data) => {
-        expect(typeof(data)).assertEqual("object")
+        console.log("DAHelper query result: " + data)
     }
    );
    ```
@@ -217,7 +229,7 @@ The basic dependency packages include:
     urivar,
     cars,
     (error, data) => {
-        expect(typeof(data)).assertEqual("number")
+        console.log("DAHelper batchInsert result: " + data)
     }
    );
    ```
@@ -241,12 +253,12 @@ The basic dependency packages include:
             valuesBucket: {"executeBatch" : "value1",},
             predicates: da,
             expectedCount:0,
-            PredicatesBackReferences: {},
+            predicatesBackReferences: null,
             interrupted:true,
         }
     ],
     (error, data) => {
-        expect(typeof(data)).assertEqual("object")
+        console.log("DAHelper executeBatch result: " + data)
     }
    );
    ```
@@ -265,21 +277,15 @@ The basic dependency packages include:
             },
             predicates: da,
             expectedCount:0,
-            PredicatesBackReferences: {},
+            predicatesBackReferences: null,
             interrupted:true,
         }
     ]
    );
    ```
 
-## Development Example
-
-The following sample is provided to help you better understand how to develop a Data ability:
-
-- [DataAbility](https://gitee.com/openharmony/app_samples/tree/master/ability/DataAbility)
-
-This sample shows how to:
+## Samples
 
-Create a Data ability in the **data.ts** file in the **DataAbility** directory.
+The following sample is provided to help you better understand how to develop Data abilities:
 
-Encapsulate the process of accessing the Data ability in the **MainAbility** directory.
+- [`DataAbility`: Creation and Access of Data Abilities (eTS, API version 8)](https://gitee.com/openharmony/app_samples/tree/master/ability/DataAbility)