From f064d9e2efe9794a73cf42b565b1a7f180696efa Mon Sep 17 00:00:00 2001 From: wusongqing Date: Mon, 11 Jul 2022 16:46:32 +0800 Subject: [PATCH] update docs against 6384 Signed-off-by: wusongqing --- en/application-dev/ability/fa-dataability.md | 25 ++++++++++++++++++ .../ability/figures/fa-dataability-uri.png | Bin 0 -> 6315 bytes 2 files changed, 25 insertions(+) create mode 100644 en/application-dev/ability/figures/fa-dataability-uri.png diff --git a/en/application-dev/ability/fa-dataability.md b/en/application-dev/ability/fa-dataability.md index f7bcf858e1..b92e9bb5f6 100644 --- a/en/application-dev/ability/fa-dataability.md +++ b/en/application-dev/ability/fa-dataability.md @@ -1,9 +1,34 @@ # Data Ability Development + ## When to Use + A Data ability helps applications manage access to data stored by themselves and other applications. It also provides APIs for sharing data with other applications either on the same device or across devices. Data ability providers can customize data access-related APIs such as data inserting, deleting, updating, and querying, as well as file opening, and share data with other applications through these open APIs. +## URI Introduction + +A Uniform Resource Identifier (URI) is used to identify a specific data item, such as a table in the database or a file on the disk. URIs used in OpenHarmony comply with the commonly used URI standard. A URI consists of the components: + +![fa-dataability-uri](figures/fa-dataability-uri.png) + +- **scheme**: name of the scheme used by the Data ability. The value is fixed at **dataability**. +- **authority**: device ID. To access data on a remote device, set this component to the ID of the remote device. To access data on the local device, leave this component empty. +- **path**: location of the specific resource to access. +- **query**: query parameters. +- **fragment**: subordinate resources to access. + +Example URIs: + +- Cross-device communication: **dataability://***device_id***/***com.domainname.dataability.persondata***/***person***/***10* +- Local-device communication: **dataability:///***com.domainname.dataability.persondata***/***person***/***10* + + +> **NOTE** +> +> In the case of local-device communication, **device_id** is empty, and therefore, there are three slashes (/) after **dataability:**. + + ## Available APIs **Table 1** Data ability lifecycle APIs diff --git a/en/application-dev/ability/figures/fa-dataability-uri.png b/en/application-dev/ability/figures/fa-dataability-uri.png new file mode 100644 index 0000000000000000000000000000000000000000..d89ada0ee9b2f9f655a6c3d8b0df17d6b1ca9326 GIT binary patch literal 6315 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