FA模型訪問Stage模型DataShareExtensionAbility

概述

無論FA模型還是Stage模型，數據讀寫功能都包含客戶端和服務端兩部分。

• FA模型中，客戶端是由DataAbilityHelper提供對外接口，服務端是由DataAbility提供數據庫的讀寫服務。
• Stage模型中，客戶端是由DataShareHelper提供對外接口，服務端是由DataShareExtensionAbility提供數據庫的讀寫服務。
• 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

服務端由FA模型升級到Stage模型后，會導致FA模型的客戶端在API 9(含)之后的版本上無法訪問服務端。

為了解決上述問題，系統在框架側提供了一個解決方案，讓開發者平滑過渡到API 9(含)之后的版本。

基本原理

一種兼容方法是DataAbilityHelper根據傳入的URI的前綴是DataAbility還是DataShare來決定是否調DataShareHelper的接口。但是這種方法需要開發者修改原客戶端代碼的URI，做不到無感知切換。

因此DataAbilityHelper不能僅依賴URI的前綴決定訪問DataAbility還是DataShareExtensionAbility，系統采用的方法是：

1. 先按照傳入的URI拉起DataAbility；如果拉起失敗，再將傳入的URI的前綴轉換成DataShare再去嘗試拉起DataShareExtensionAbility。
2. 如果URI無對應的DataAbility和DataShareExtensionAbility，則拉起失敗；反之，必定會拉起DataAbility或者DataShareExtensionAbility。

約束與限制

1. 由DataAbility切換到DataShareExtensionAbility時，只能修改URI的前綴，不能修改URI的其他部分。
2. DataShareHelper并沒有實現原DataAbilityHelper對外API接口的所有功能，因此有部分接口是無法兼容的，具體如表1所示。
   表1 FA模型訪問stage模型DataShareExtensionAbility接口支持情況
   

審核編輯 黃宇