鸿蒙系统 鸿蒙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 对象。