diff --git a/zh-cn/application-dev/ability/fa-dataability.md b/zh-cn/application-dev/ability/fa-dataability.md index d977293ae807537524eebb0aa76c56cfcd031aaf..67dcdd8c71aeaff992259ea64c844249540bcb19 100644 --- a/zh-cn/application-dev/ability/fa-dataability.md +++ b/zh-cn/application-dev/ability/fa-dataability.md @@ -4,6 +4,28 @@ Data提供方可以自定义数据的增、删、改、查,以及文件打开等功能,并对外提供这些接口。 +## URI介绍 + +Data的提供方和使用方都通过URI(Uniform Resource Identifier)来标识一个具体的数据,例如数据库中的某个表或磁盘上的某个文件。HarmonyOS的URI仍基于URI通用标准,格式如下: + +![fa-dataability-uri](figures/fa-dataability-uri.png) + +- scheme:协议方案名,固定为“dataability”,代表Data Ability所使用的协议类型。 +- authority:设备ID。如果为跨设备场景,则为目标设备的ID;如果为本地设备场景,则不需要填写。 +- path:资源的路径信息,代表特定资源的位置信息。 +- query:查询参数。 +- fragment:可以用于指示要访问的子资源。 + +URI示例: + +- 跨设备场景:dataability://*device_id*/*com.domainname.dataability.persondata*/*person*/*10* +- 本地设备:dataability:///*com.domainname.dataability.persondata*/*person*/*10* + +``` +说明 +本地设备的“device_id”字段为空,因此在“dataability:”后面有三个“/”。 +``` + ## 接口说明 **表1** Data中相关生命周期API功能介绍 diff --git a/zh-cn/application-dev/ability/figures/fa-dataability-uri.png b/zh-cn/application-dev/ability/figures/fa-dataability-uri.png new file mode 100644 index 0000000000000000000000000000000000000000..140098297414775dfd478500c7304f8856a14dd5 Binary files /dev/null and b/zh-cn/application-dev/ability/figures/fa-dataability-uri.png differ