From cfdab8182535652fdda6c6c392516a172b0da6ab Mon Sep 17 00:00:00 2001 From: zhoujun62 Date: Wed, 6 Jul 2022 10:55:11 +0800 Subject: [PATCH] IssueNo:#I5FPEV:Refresh the explanation of uri in DataAbility Description: Refresh the explanation of uri in DataAbility Sig:SIG_ApplicationFramework Feature or Bugfix:Feature Binary Source:No Signed-off-by: zhoujun62 --- .../application-dev/ability/fa-dataability.md | 22 ++++++++++++++++++ .../ability/figures/fa-dataability-uri.png | Bin 0 -> 8862 bytes 2 files changed, 22 insertions(+) create mode 100644 zh-cn/application-dev/ability/figures/fa-dataability-uri.png diff --git a/zh-cn/application-dev/ability/fa-dataability.md b/zh-cn/application-dev/ability/fa-dataability.md index d977293ae8..67dcdd8c71 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 GIT binary patch literal 8862 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 literal 0 HcmV?d00001 -- GitLab