• 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
38import dataUriUtils from '@ohos.app.ability.dataUriUtils';
39
40try {
41    let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
42    console.info('get id: ${id}');
43} catch(err) {
44    console.error('get id err ,check the uri ${err}');
45}
46```
47
48
49
50## dataUriUtils.attachId
51
52attachId(uri: string, id: number): string
53
54将ID附加到uri的路径末尾。
55
56**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
57
58**参数:**
59
60| 参数名 | 类型   | 必填 | 说明                        |
61| ---- | ------ | ---- | --------------------------- |
62| uri  | string | 是   | 表示uri对象。 |
63| id   | number | 是   | 表示要附加的ID。            |
64
65**返回值:**
66
67| 类型   | 说明                  |
68| ------ | --------------------- |
69| string | 返回附加ID之后的uri对象。 |
70
71**示例:**
72
73```ts
74import dataUriUtils from '@ohos.app.ability.dataUriUtils';
75
76let id = 1122;
77try {
78    let uri = dataUriUtils.attachId(
79        'com.example.dataUriUtils',
80        id,
81    );
82    console.info('attachId the uri is: ${uri}');
83} catch (err) {
84    console.error('get id err ,check the uri ${err}');
85}
86
87```
88
89
90
91## dataUriUtils.deleteId
92
93deleteId(uri: string): string
94
95删除指定uri路径末尾的ID。
96
97**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
98
99**参数:**
100
101| 参数名 | 类型   | 必填 | 说明                        |
102| ---- | ------ | ---- | --------------------------- |
103| uri  | string | 是   | 表示要从中删除ID的uri对象。 |
104
105**返回值:**
106
107| 类型   | 说明                |
108| ------ | ------------------- |
109| string | 返回删除ID之后的uri对象。 |
110
111**示例:**
112
113```ts
114import dataUriUtils from '@ohos.app.ability.dataUriUtils';
115
116try {
117    let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
118    console.info('delete id with the uri is: ${uri}');
119} catch(err) {
120    console.error('delete uri err, check the input uri ${err}');
121}
122
123```
124
125
126
127## dataUriUtils.updateId
128
129updateId(uri: string, id: number): string
130
131更新指定uri中的ID。
132
133**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
134
135**参数:**
136
137| 参数名 | 类型   | 必填 | 说明                |
138| ---- | ------ | ---- | ------------------- |
139| uri  | string | 是   | 表示uri对象 |
140| id   | number | 是   | 表示要更新的ID            |
141
142**返回值:**
143
144| 类型   | 说明            |
145| ------ | --------------- |
146| string | 返回更新ID之后的uri对象。 |
147
148**示例:**
149
150```ts
151import dataUriUtils from '@ohos.app.ability.dataUriUtils';
152
153try {
154    let id = 1122;
155    let uri = dataUriUtils.updateId(
156        'com.example.dataUriUtils/1221',
157        id
158    );
159} catch (err) {
160    console.error('delete uri err, check the input uri ${err}');
161}
162```
163
164