harmony 鸿蒙@ohos.app.ability.dataUriUtils (DataUriUtils)

2022-12-22
浏览 (588)

@ohos.app.ability.dataUriUtils (DataUriUtils)

The DataUriUtils module provides APIs to process URI objects. You can use the APIs to attach an ID to the end of a given URI and obtain, delete, or update the ID attached to the end of a given URI.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import dataUriUtils from '@ohos.app.ability.dataUriUtils';

dataUriUtils.getId

getId(uri: string): number

Obtains the ID attached to the end of a given URI.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
uri	string	Yes	Target URI object.

Return value

Type	Description
number	ID obtained.

Example

import dataUriUtils from '@ohos.app.ability.dataUriUtils';

try {
    let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
    console.info('get id: ${id}');
} catch(err) {
    console.error('get id err ,check the uri ${err}');
}

dataUriUtils.attachId

attachId(uri: string, id: number): string

Attaches an ID to the end of a given URI.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
uri	string	Yes	Target URI object.
id	number	Yes	ID to be attached.

Return value

Type	Description
string	URI object with the ID attached.

Example

import dataUriUtils from '@ohos.app.ability.dataUriUtils';

let id = 1122;
try {
    let uri = dataUriUtils.attachId(
        'com.example.dataUriUtils',
        id,
    );
    console.info('attachId the uri is: ${uri}');
} catch (err) {
    console.error('get id err ,check the uri ${err}');
}

dataUriUtils.deleteId

deleteId(uri: string): string

Deletes the ID from the end of a given URI.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
uri	string	Yes	URI object from which the ID is to be deleted.

Return value

Type	Description
string	URI object with the ID deleted.

Example

import dataUriUtils from '@ohos.app.ability.dataUriUtils';

try {
    let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
    console.info('delete id with the uri is: ${uri}');
} catch(err) {
    console.error('delete uri err, check the input uri ${err}');
}

dataUriUtils.updateId

updateId(uri: string, id: number): string

Updates the ID in a given URI.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
uri	string	Yes	Target URI object.
id	number	Yes	New ID.

Return value

Type	Description
string	URI object with the new ID.

Example

import dataUriUtils from '@ohos.app.ability.dataUriUtils';

try {
    let id = 1122;
    let uri = dataUriUtils.updateId(
        'com.example.dataUriUtils/1221',
        id
    );
} catch (err) {
    console.error('delete uri err, check the input uri ${err}');
}