• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.dataUriUtils (DataUriUtils模块)
2
3DataUriUtils模块提供用于处理uri对象的能力，包括获取、绑定、删除和更新指定uri对象的路径末尾的ID。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import dataUriUtils from '@ohos.app.ability.dataUriUtils';
13```
14
15## dataUriUtils.getId
16
17getId(uri: string): number
18
19获取指定uri路径末尾的ID。
20
21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
22
23**参数：**
24
25| 名称 | 类型   | 必填 | 描述                        |
26| ---- | ------ | ---- | --------------------------- |
27| uri  | string | 是   | 表示uri对象。 |
28
29**返回值：**
30
31| 类型   | 说明                     |
32| ------ | ------------------------ |
33| number | 返回uri路径末尾的ID。 |
34
35**示例：**
36
37```ts
38try {
39    let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
40    console.info('get id: ${id}');
41} catch(err) {
42    console.error('get id err ,check the uri ${err}');
43}
44```
45
46## dataUriUtils.attachId
47
48attachId(uri: string, id: number): string
49
50将ID附加到uri的路径末尾。
51
52**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
53
54**参数：**
55
56| 名称 | 类型   | 必填 | 描述                        |
57| ---- | ------ | ---- | --------------------------- |
58| uri  | string | 是   | 表示uri对象。 |
59| id   | number | 是   | 表示要附加的ID。            |
60
61**返回值：**
62
63| 类型   | 说明                  |
64| ------ | --------------------- |
65| string | 返回附加ID之后的uri对象。 |
66
67**示例：**
68
69```ts
70let id = 1122;
71try {
72    let uri = dataUriUtils.attachId(
73        'com.example.dataUriUtils',
74        id,
75    );
76    console.info('attachId the uri is: ${uri}');
77} catch (err) {
78    console.error('get id err ,check the uri ${err}');
79}
80
81```
82
83## dataUriUtils.deleteId
84
85deleteId(uri: string): string
86
87删除指定uri路径末尾的ID。
88
89**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
90
91**参数：**
92
93| 名称 | 类型   | 必填 | 描述                        |
94| ---- | ------ | ---- | --------------------------- |
95| uri  | string | 是   | 表示要从中删除ID的uri对象。 |
96
97**返回值：**
98
99| 类型   | 说明                |
100| ------ | ------------------- |
101| string | 返回删除ID之后的uri对象。 |
102
103**示例：**
104
105```ts
106try {
107    let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
108    console.info('delete id with the uri is: ${uri}');
109} catch(err) {
110    console.error('delete uri err, check the input uri ${err}');
111}
112
113```
114
115## dataUriUtils.updateId
116
117updateId(uri: string, id: number): string
118
119更新指定uri中的ID。
120
121**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
122
123**参数：**
124
125| 名称 | 类型   | 必填 | 描述                |
126| ---- | ------ | ---- | ------------------- |
127| uri  | string | 是   | 表示uri对象 |
128| id   | number | 是   | 表示要更新的ID            |
129
130**返回值：**
131
132| 类型   | 说明            |
133| ------ | --------------- |
134| string | 返回更新ID之后的uri对象。 |
135
136**示例：**
137
138```ts
139
140try {
141    let id = 1122;
142    let uri = dataUriUtils.updateId(
143        'com.example.dataUriUtils/1221',
144        id
145    );
146} catch (err) {
147    console.error('delete uri err, check the input uri ${err}');
148}
149```
150
151