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