未验证 提交 7924cf04 编写于 作者: O openharmony_ci 提交者: Gitee

!12785 DataAbility相关资料说明修复

Merge pull request !12785 from dy/update_1220
# AbilityResult
定义Ability拉起、销毁之后返回的结果码和数据,可以通过[startAbilityForResult](js-apis-ability-context.md#abilitycontextstartabilityforresult)获取对端Ability销毁后返回的AbilityResult对象,被startAbilityForResult拉起的Ability对象可以通过[terminateSelfWithResult](js-apis-ability-context.md#abilitycontextterminateselfwithresult)返回AbilityResult对象。
定义Ability被拉起并退出后返回的结果码和数据,可以通过[startAbilityForResult](js-apis-ability-context.md#abilitycontextstartabilityforresult)获取被拉起Ability退出后返回的AbilityResult对象,被startAbilityForResult拉起的Ability对象可以通过[terminateSelfWithResult](js-apis-ability-context.md#abilitycontextterminateselfwithresult)返回AbilityResult对象。
> **说明:**
>
......@@ -10,6 +10,6 @@
| 名称 | 可读 | 可写 | 类型 | 必填 | 说明 |
| ----------- | -------- |-------- | -------------------- | ---- | ------------------------------------------------------------ |
| resultCode | 是 | 否 | number | 是 | 表示ability拉起、销毁之后返回的结果码。 |
| want | 是 | 否 | [Want](./js-apis-app-ability-want.md) | 否 | 表示ability销毁之后返回的数据。 |
| resultCode | 是 | 是 | number | 是 | 表示Ability被拉起并退出后返回的结果码。 |
| want | 是 | 是 | [Want](./js-apis-app-ability-want.md) | 否 | 表示Ability被拉起并退出后返回的数据。 |
# ConnectOptions
在连接指定的后台服务时作为入参用于接收连接过程中的状态变化,如作为[connectServiceExtensionAbility](js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextconnectserviceextensionability)的入参连接指定的ServiceExtensionAbility。
在连接指定的后台服务时作为入参,用于接收连接过程中的状态变化,如作为[connectServiceExtensionAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)的入参,连接指定的ServiceExtensionAbility。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
# DataAbilityOperation
定义dataAbility数据操作方式,可以作为[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)的入参查询数据库的信息。
定义DataAbility数据操作方式,可以作为[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)的入参,操作数据库的信息。
> **说明:**
>
......@@ -11,11 +11,11 @@
| 名称 | 类型 | 必填| 说明 |
| -------- | -------- | --------| -------- |
| uri | string | 是 | 指待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| type | featureAbility.DataAbilityOperationType | 是 | 指示操作类型。 |
| valuesBucket? | rdb.ValuesBucket | 否 | 指示要设置的数据值。 |
| uri | string | 是 | 指待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| type | featureAbility.DataAbilityOperationType | 是 | 指示数据操作类型。 |
| valuesBucket? | rdb.ValuesBucket | 否 | 指示要操作的数据值。 |
| valueBackReferences? | rdb.ValuesBucket | 否 | 指示包含一组键值对的valuesBucket对象。 |
| predicates? | dataAbility.DataAbilityPredicates | 否 | 指示要设置的筛选条件。如果此参数为空,则所有数据记录。 |
| predicates? | dataAbility.DataAbilityPredicates | 否 | 指示要设置的筛选条件。如果此参数为空,则操作所有数据记录。 |
| predicatesBackReferences? | Map\<number, number> | 否 | 指示用作谓词中筛选条件的反向引用。 |
| interrupted? | boolean | 否 | 指是否可以中断批处理操作。 |
| interrupted? | boolean | 否 | 指是否可以中断批处理操作。 |
| expectedCount? | number | 否 | 指示要更新或删除的预期行数。 |
# DataAbilityResult
定义dataAbility数据操作结果,通过[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)查询数据库信息时查询结果通过DataAbilityResult对象返回。
定义DataAbility数据操作结果,通过[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)操作数据库时,操作结果使用DataAbilityResult对象返回。
> **说明:**
>
......@@ -11,8 +11,8 @@
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| uri? | string | 否 | 指待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| count? | number | 否 | 指示受操作影响的行数。 |
| uri? | string | 否 | 指待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| count? | number | 否 | 指示受操作影响的数据数量。 |
**示例:**
......@@ -59,7 +59,7 @@ let operations = [
];
try {
let promise = DAHelper.executeBatch(dataAbilityUri, operations).then((data) => {
DAHelper.executeBatch(dataAbilityUri, operations).then((data) => {
for (let i = 0; i < data.length; i++) {
let dataAbilityResult = data[i];
console.log('dataAbilityResult.uri: ' + dataAbilityResult.uri);
......
# StartAbilityParameter
定义启动Ability参数,可以作为入参调用[startAbility](js-apis-ability-featureAbility.md#featureabilitystartability)启动指定的Ability。
定义启动Ability参数,可以作为入参调用[startAbility](js-apis-ability-featureAbility.md#featureabilitystartability)启动指定的Ability。
> **说明:**
>
......@@ -11,8 +11,8 @@
| 名称 | 类型 | 必填 | 说明 |
| ------------------- | -------- | ---- | -------------------------------------- |
| want | [Want](js-apis-application-want.md)| 是 | 表示需要包含有关目标启动能力的信息。 |
| abilityStartSetting | {[key: string]: any} | 否 | 表示能力的特殊属性,当开发者启动能力时,该属性可以作为调用中的输入参数传递。 |
| want | [Want](js-apis-application-want.md)| 是 | 启动Ability的want信息。 |
| abilityStartSetting | {[key: string]: any} | 否 | 启动Ability的特殊属性,当开发者启动Ability时,该属性可以作为调用中的输入参数传递。 |
**示例:**
```ts
......@@ -35,9 +35,11 @@ let startAbilityParameter = {
abilityStartSetting : abilityStartSetting
}
featureAbility.startAbility(startAbilityParameter, (err, data)=>{
console.log('errCode : ' + JSON.stringify(err));
console.log('data : ' + JSON.stringify(data));
try {
featureAbility.startAbility(startAbilityParameter, (err, data) => {
console.log('errCode : ' + JSON.stringify(err));
console.log('data : ' + JSON.stringify(data));
});
} catch(error) {
console.log("startAbility error: " + JSON.stringify(error));
}
......
......@@ -12,5 +12,5 @@
| ----------- | ------ | ---- | ---- | -------------- |
| appName | string | 是 | 否 | 应用名称。 |
| versionCode | number | 是 | 否 | 应用版本编码。 |
| versionName | string | 是 | 否 | 应用版本。 |
| versionName | string | 是 | 否 | 应用版本名称。 |
# AbilityDelegatorArgs
AbilityDelegatorArgs模块提供在应用程序启动期间,用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力。
AbilityDelegatorArgs模块提供在应用程序执行测试用例期间,获取测试用例参数AbilityDelegatorArgs对象的能力。
> **说明:**
>
......@@ -21,7 +21,7 @@ AbilityDelegatorArgs模块提供在应用程序启动期间,用于存储已注
| bundleName | string | 是 | 是 | 当前被测试应用的包名 |
| parameters | {[key:string]: string} | 是 | 是 | 当前启动单元测试的参数 |
| testCaseNames | string | 是 | 是 | 测试用例名称 |
| testRunnerClassName | string | 是 | 是 | 执行测试用例的测试执行器名称 |
| testRunnerClassName | string | 是 | 是 | 执行测试用例的测试执行器名称 |
**示例:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册