鸿蒙开发Ability Kit（程序框架服务）：【DataAbility切换】 组件切换

DataAbility切换

FA模型中的DataAbility对应Stage模型中的DataShareExtensionAbility。

与ServiceExtensionAbility类似，Stage模型下的DataShareExtensionAbility为系统API，只有系统应用才可以创建。因此，FA模型的DataAbility的切换，对于系统应用和三方应用策略有所不同。下面分别介绍这两种场景。

系统应用DataAbility切换至DataShareExtensionAbility

迁移步骤和PageAbility基本一致。

1. 在Stage应用中创建DataShareExtensionAbility。

2. 将FA应用中DataAbility的业务代码迁移到新创建的DataShareExtensionAbility中。 DataAbility和DataShareExtensionAbility生命周期对比见下表。

   FA的DataAbility	Stage的DataShareExtensionAbility	对比描述
   onInitialized?(info: AbilityInfo): void	onCreate?(want: Want, callback: AsyncCallback): void	两者调用时机一致，函数名即入参都不一样，Stage模型下增加了入参want以便开发者在创建时获取参数。
   update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void	update?(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: ValuesBucket, callback: AsyncCallback): void	两者意义和调用时机一致，参数顺序和参数类型略有不同，需要简单改造。
   query?(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void	query?(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array, callback: AsyncCallback): void;	两者意义和调用时机一致，参数顺序和参数类型略有不同，需要简单改造。
   delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void	delete?(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback):	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   normalizeUri?(uri: string, callback: AsyncCallback): void	normalizeUri?(uri: string, callback: AsyncCallback): void	两者意义和调用时机一致，参数也一致。
   batchInsert?(uri: string, valueBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback): void	batchInsert?(uri: string, values: Array, callback: AsyncCallback): void	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   denormalizeUri?(uri: string, callback: AsyncCallback): void	denormalizeUri?(uri: string, callback: AsyncCallback): void	两者意义和调用时机一致，参数也一致。
   insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback): void	insert?(uri: string, value: ValuesBucket, callback: AsyncCallback): void	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   openFile?(uri: string, mode: string, callback: AsyncCallback): void	NA	Stage模型不支持uri跨进程访问，建议通过[want携带FD和文件信息]进行跨进程文件访问。
   getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array>): void	NA	Stage模型不支持uri跨进程访问，建议通过[want携带FD和文件信息]进行跨进程文件访问。
   getType?(uri: string, callback: AsyncCallback): void	NA	Stage模型不支持uri跨进程访问，建议通过[want携带FD和文件信息]进行跨进程文件访问。
   executeBatch?(ops: Array, callback: AsyncCallback<Array>): void	NA	DataShareExtensonAbility不提供该接口，开发者需根据业务功能重新实现。
   call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback): void	NA	DataShareExtensonAbility不提供该接口，开发者需根据业务功能重新实现。

三方应用DataAbility改造为公共模块

Stage模型三方应用不能对其他三方提供数据，应用需要根据具体业务选择切换方案。

DataAbility业务类型	切换DataShareExtension策略
对三方提供数据	需根据业务场景匹配到系统对应的场景化[ExtensionAbility]。
应用内使用的数据	对应用内其他组件提供数据，建议提取公共模块。