鸿蒙OS开发文档 鸿蒙OS Ability DataAbilityOperation.builder

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 4

创建一个 DataAbilityOperation。

方法总结

修饰符和类型方法描述
DataAbilityOperationbuild()创建一个 DataAbilityOperation 对象。
DataAbilityOperation.BuilderwithExpectedCount(int count)设置要更新,删除或声明查询的预期行数。
DataAbilityOperation.BuilderwithPredicates((DataAbilityPredicates谓词)设置用于删除更新或声明查询数据的过滤条件。
DataAbilityOperation.BuilderwithPredicatesBackReference(int requestArgIndex,int previousResult)Adds a back reference to be used as a filter criterion in withPredicates(ohos.data.dataability.DataAbilityPredicates).
DataAbilityOperation.BuilderwithValueBackReferences(ValuesBucket backReferences)添加要在 withValuesBucket(ohos.data.rdb.ValuesBucket)中使用的反向引用。
DataAbilityOperation.BuilderwithValuesBucket(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 对象。