鸿蒙OS Ability DataAbilityOperation.builder
创建一个 DataAbilityOperation。
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| DataAbilityOperation | build（） | 创建一个 DataAbilityOperation 对象。 |
| DataAbilityOperation.Builder | withExpectedCount（int count） | 设置要更新，删除或声明查询的预期行数。 |
| DataAbilityOperation.Builder | withPredicates（（DataAbilityPredicates谓词） | 设置用于删除更新或声明查询数据的过滤条件。 |
| DataAbilityOperation.Builder | withPredicatesBackReference（int requestArgIndex，int previousResult） | Adds a back reference to be used as a filter criterion in withPredicates(ohos.data.dataability.DataAbilityPredicates). |
| DataAbilityOperation.Builder | withValueBackReferences（ValuesBucket backReferences） | 添加要在 withValuesBucket（ohos.data.rdb.ValuesBucket）中使用的反向引用。 |
| DataAbilityOperation.Builder | withValuesBucket（ValuesBucket值） | 设置要插入或更新的数据记录。 |
| 从类 java.lang 继承的方法。object |
|---|
| clone，equals，finalize，getClass，hashCode，notify，notifyAll，toString，wait，wait，wait |
方法细节
建立
公共 DataAbilityOperation build（）
创建一个 DataAbilityOperation 对象。
返回值：
返回 DataAbilityOperation 对象。
withValuesBucket
public DataAbilityOperation.Builder withValuesBucket(ValuesBucket values)
设置要插入或更新的数据记录。
只能通过插入或更新操作来调用此方法。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 价值观 | 指示要设置的数据值。 |
返回值：
返回一个包含给定 values 参数的 DataAbilityOperation.Builder 对象。
withPredicates
带有 Predicates 的 public DataAbilityOperation.Builder（DataAbilityPredicates 谓词）
设置用于删除更新或声明查询数据的过滤条件。
只能通过更新或删除操作来调用此方法。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 谓词 | 指示要设置的过滤条件。如果此参数为 null，则默认情况下将操作所有数据记录。 |
返回值：
返回包含给定过滤条件的对象。
withExpectedCount
带有ExpectedCount（int计数）的 public DataAbilityOperation.Builder
设置要更新，删除或声明查询的预期行数。
只能通过更新或删除操作来调用此方法。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 计数 | 指示要更新或删除的预期行数。 |
返回值：
返回包含给定 count 参数的 DataAbilityOperation.Builder 对象。
withPredicatesBackReference
具有 PredicatesBackReference 的 public DataAbilityOperation.Builder（int requestArgIndex，int previousResult）
在 withPredicates（ohos.data.dataability.DataAbilityPredicates）中 添加要用作过滤条件的 反向引用。此方法只能用于更新，删除和断言操作。
此方法将基于此方法中 requestArgIndex 和 previousResult 的值替换 withPredicates（ohos.data.dataability.DataAbilityPredicates）中指定的谓词参数数组中的特定数据。数据将由 DataAbilityOperation.Builder 创建的操作完成后获得的 DataAbilityResult 替换。
参数：
| 参数名称 | 参数说明 |
|---|---|
| requestArgIndex | 指示引用要替换其值的谓词参数的索引。 |
| previousResult | 指示引用历史 DataAbilityResult 的索引，该索引用于替换指定谓词参数的值。 |
返回值：
返回一个 DataAbilityOperation.Builder 对象，其中包含给定的 requestArgIndex 和 previousResult 参数。
withValueBackReferences
具有 ValueBackReferences 的 public DataAbilityOperation.Builder（ValuesBucket backReferences）
添加要在 withValuesBucket（ohos.data.rdb.ValuesBucket）中使用的反向引用 。此方法只能用于插入，更新和声明操作。
此方法将使用在 DataAbilityOperation.Builder 创建的操作完成后获得的指定 DataAbilityResult 替换withValuesBucket（ohos.data.rdb.ValuesBucket）中指定的特定值。
参数：
| 参数名称 | 参数说明 |
|---|---|
| 返回参考 | 指示包含一组键值对的 ValuesBucket 对象。在每对中，键指定要更新的值，并且值指定引用用于替换指定值的 DataAbilityResult 的索引。此参数不能为空。 |
返回值：
返回包含给定 backReferences 参数的 DataAbilityOperation.Builder 对象。