DataAbilityHelper

可以通过acquireDataAbilityHelper接口获取DataAbilityHelper对象。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块接口仅可在FA模型下使用。

使用说明

使用前根据具体情况引入如下模块

import ohos_data_ability from '@ohos.data.dataAbility';
import ohos_data_rdb from '@ohos.data.rdb';

1
2

DataAbilityHelper.openFile

openFile(uri: string, mode: string, callback: AsyncCallback<number>): void

打开指定uri对应的文件，返回文件描述符（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待打开文件的uri。
mode	string	是	指示文件打开模式，可以设置为‘r’表示只读访问，‘w’表示只写访问，‘rw’表示读写访问等。
callback	AsyncCallback<number>	是	指示文件打开的回调方法，返回文件描述符。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let mode = 'rw';
DAHelper.openFile('dataability:///com.example.DataAbility', mode, (error, data) => {
    if (error && error.code !== 0) {
        console.error('openFile fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('openFile success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12

DataAbilityHelper.openFile

openFile(uri: string, mode: string): Promise<number>

打开指定uri对应的文件，返回文件描述符（promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待打开文件的uri。
mode	string	是	指示文件打开模式，可以设置为‘r’表示只读访问，‘w’表示只写访问，‘rw’表示读写访问等。

返回值：

类型	说明
Promise<number>	返回文件说明符。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let mode = 'rw';
DAHelper.openFile('dataability:///com.example.DataAbility', mode).then((data) => {
    console.info('openFile data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8

DataAbilityHelper.on

on(type: 'dataChange', uri: string, callback: AsyncCallback<void>): void

注册观察者以监听uri指定数据的数据变化通知。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
type	string	是	指示监听操作类型，'dataChange'表示数据变化操作。
uri	string	是	指示待监听数据变化的uri。
callback	AsyncCallback<void>	是	指示数据变化时的回调方法。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
function onChangeNotify() {
    console.info('onChangeNotify call back');
};
DAHelper.on(
    'dataChange',
    'dataability:///com.example.DataAbility',
    onChangeNotify
);

1
2
3
4
5
6
7
8
9
10
11
12

DataAbilityHelper.off

off(type: 'dataChange', uri: string, callback?: AsyncCallback<void>): void

注消观察者以停止监听uri指定数据的数据变化通知。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
type	string	是	指示监听操作类型，'dataChange'表示数据变化操作。
uri	string	是	指示待取消监听数据变化的uri。
callback	AsyncCallback<void>	否	指示已注册的数据变化回调方法。如果设置数据变化回调为空，将会取消所有数据变化监听。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
function onChangeNotify() {
    console.info('onChangeNotify call back');
};
DAHelper.off(
    'dataChange',
    'dataability:///com.example.DataAbility',
    onChangeNotify
);
DAHelper.off(
    'dataChange',
    'dataability:///com.example.DataAbility',
);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

DataAbilityHelper.getType

getType(uri: string, callback: AsyncCallback<string>): void

获取给定uri指向数据的媒体资源类型（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待获取数据的uri。
callback	AsyncCallback<string>	是	指示获取媒体资源类型的回调方法，返回与uri指向数据匹配的媒体资源类型。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.getType('dataability:///com.example.DataAbility', (error, data) => {
    if (error && error.code !== 0) {
        console.error('getType fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('getType success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.getType

getType(uri: string): Promise<string>

获取给定uri指向数据的媒体资源类型（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待获取数据的uri。

返回值：

类型	说明
Promise<string>	返回与uri指向数据匹配的媒体资源类型。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.getType('dataability:///com.example.DataAbility').then((data) => {
    console.info('getType data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7

DataAbilityHelper.getFileTypes

getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>): void

获取支持的文件媒体资源类型（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待获取文件的uri。
mimeTypeFilter	string	是	指示待获取文件的媒体资源类型。
callback	AsyncCallback<Array<string>>	是	指示获取媒体资源类型的回调方法，返回匹配的媒体资源类型数组。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.getFileTypes( 'dataability:///com.example.DataAbility', 'image/*', (error, data) => {
    if (error && error.code !== 0) {
        console.error('getFileTypes fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('getFileTypes success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.getFileTypes

getFileTypes(uri: string, mimeTypeFilter: string): Promise<Array<string>>

获取支持的文件媒体资源类型（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待获取文件的uri。
mimeTypeFilter	string	是	指示待获取文件的媒体资源类型。

返回值：

类型	说明
Promise<Array<string>>	返回匹配的媒体资源类型数组。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.getFileTypes('dataability:///com.example.DataAbility', 'image/*').then((data) => {
    console.info('getFileTypes data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7

DataAbilityHelper.normalizeUri

normalizeUri(uri: string, callback: AsyncCallback<string>): void

将引用数据功能的给定uri转换为规范化uri（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要规范化的uri对象。
callback	AsyncCallback<string>	是	指示uri规范化的回调方法。如果数据功能支持uri规范化，则返回规范化uri对象；否则返回null。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.normalizeUri('dataability:///com.example.DataAbility', (error, data) => {
    if (error && error.code !== 0) {
        console.error('normalizeUri fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('normalizeUri success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.normalizeUri

normalizeUri(uri: string): Promise<string>

将引用数据功能的给定uri转换为规范化uri（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要规范化的uri对象。

返回值：

类型	说明
Promise<string>	如果数据功能支持uri规范化，则返回规范化uri对象；否则返回null。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.normalizeUri('dataability:///com.example.DataAbility',).then((data) => {
    console.info('normalizeUri data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7

DataAbilityHelper.denormalizeUri

denormalizeUri(uri: string, callback: AsyncCallback<string>): void

将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要反规范化的uri对象。
callback	AsyncCallback<string>	是	指示反规范化uri的回调方法。如果反规范化成功，则返回反规范化uri对象。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.denormalizeUri('dataability:///com.example.DataAbility', (error, data) => {
    if (error && error.code !== 0) {
        console.error('denormalizeUri fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('denormalizeUri success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.denormalizeUri

denormalizeUri(uri: string): Promise<string>

将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要规范化的uri对象。

返回值：

类型	说明
Promise<string>	如果反规范化成功，则返回反规范化uri对象。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.denormalizeUri('dataability:///com.example.DataAbility',).then((data) => {
    console.info('denormalizeUri data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7

DataAbilityHelper.notifyChange

notifyChange(uri: string, callback: AsyncCallback<void>): void

通知注册的观察者，uri指定数据的数据变化（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示数据变化的uri。
callback	AsyncCallback<void>	是	回调方法。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.notifyChange('dataability:///com.example.DataAbility', (error) => {
    if (error && error.code !== 0) {
        console.error('notifyChange fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('notifyChange success');
    }
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.notifyChange

notifyChange(uri: string): Promise<void>

通知注册的观察者，uri指定数据的数据变化（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示数据变化的uri。

返回值：

类型	说明
Promise<void>	返回值为Promise对象。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
DAHelper.notifyChange('dataability:///com.example.DataAbility').then(() => {
    console.info('================>notifyChangeCallback================>');
});

1
2
3
4
5
6
7

DataAbilityHelper.insert

insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback<number>): void

将单个数据记录插入数据库（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要插入数据的uri。
valuesBucket	rdb.ValuesBucket	是	指示要插入的数据记录。如果此参数为空，将插入一个空行。
callback	AsyncCallback<number>	是	指示数据插入的回调方法，返回插入数据记录的索引。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
const valueBucket = {
    'name': 'rose',
    'age': 22,
    'salary': 200.5,
    'blobType': 'u8',
};
DAHelper.insert('dataability:///com.example.DataAbility', valueBucket, (error, data) => {
    if (error && error.code !== 0) {
        console.error('insert fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('insert success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

DataAbilityHelper.insert

insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise<number>

将单个数据记录插入数据库（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要插入数据的uri。
valuesBucket	rdb.ValuesBucket	是	指示要插入的数据记录。如果此参数为空，将插入一个空行。

返回值：

类型	说明
Promise<number>	返回插入数据记录的索引。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
const valueBucket = {
    'name': 'rose1',
    'age': 221,
    'salary': 20.5,
    'blobType': 'u8',
};
DAHelper.insert('dataability:///com.example.DataAbility', valueBucket).then((data) => {
    console.info('insert data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8
9
10
11
12
13

DataAbilityHelper.batchInsert

batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback<number>): void

将多个数据记录插入数据库（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要插入数据的uri。
valuesBucket	Array<rdb.ValuesBucket>	是	指示要插入的数据记录数组。
callback	AsyncCallback<number>	是	指示批量数据插入的回调方法。返回插入的数据记录数。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
                     {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
                     {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',});
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => {
    if (error && error.code !== 0) {
        console.error('batchInsert fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('batchInsert success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14

DataAbilityHelper.batchInsert

batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise<number>

将多个数据记录插入数据库（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要插入数据的uri。
valuesBucket	Array<rdb.ValuesBucket>	是	指示要插入的数据记录数组。

返回值：

类型	说明
Promise<number>	返回插入的数据记录数。

示例：

import featureAbility from '@ohos.ability.featureAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
                     {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',},
                     {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',});
DAHelper.batchInsert('dataability:///com.example.DataAbility', cars).then((data) => {
    console.info('batchInsert data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8
9
10

DataAbilityHelper.delete

delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void

从数据库中删除一个或多个数据记录（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要删除数据的uri。
predicates	dataAbility.DataAbilityPredicates	是	指示筛选条件。当此参数为null时，应定义处理逻辑。
callback	AsyncCallback<number>	是	指示数据删除的回调方法。返回已删除的数据记录数。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.delete('dataability:///com.example.DataAbility', da, (error, data) => {
    if (error && error.code !== 0) {
        console.error('delete fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('delete success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13

DataAbilityHelper.delete

delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise<number>;

从数据库中删除一个或多个数据记录（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要删除数据的uri。
predicates	dataAbility.DataAbilityPredicates	否	指示筛选条件。当此参数为null时，应定义处理逻辑。

返回值：

类型	说明
Promise<number>	返回已删除的数据记录数。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.delete('dataability:///com.example.DataAbility', da).then((data) => {
    console.info('delete data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8
9

DataAbilityHelper.update

update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void

更新数据库中的数据记录（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要更新数据的uri。
valuesBucket	rdb.ValuesBucket	是	指示要更新的数据。
predicates	dataAbility.DataAbilityPredicates	是	指示筛选条件。当此参数为null时，应定义处理逻辑。
callback	AsyncCallback<number>	是	指示数据更新的回调方法，返回更新的数据记录数。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
const va = {
    'name': 'roe1',
    'age': 21,
    'salary': 20.5,
    'blobType': 'u8',
};
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.update('dataability:///com.example.DataAbility', va, da, (error, data) => {
    if (error && error.code !== 0) {
        console.error('update fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('update success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

DataAbilityHelper.update

update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.DataAbilityPredicates): Promise<number>;

更新数据库中的数据记录（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要更新数据的uri。
valuesBucket	rdb.ValuesBucket	是	指示要更新的数据。
predicates	dataAbility.DataAbilityPredicates	否	指示筛选条件。当此参数为null时，应定义处理逻辑。

返回值：

类型	说明
Promise<number>	Promise中包含更新的数据记录数。。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
const va = {
    'name': 'roe1',
    'age': 21,
    'salary': 20.5,
    'blobType': 'u8',
};
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.update('dataability:///com.example.DataAbility', va, da).then((data) => {
    console.info('update data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

DataAbilityHelper.query

query(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void

查询数据库中的数据（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要查询数据的uri。
columns	Array<string>	是	指示要查询的列。如果此参数为空，则查询所有列。
predicates	dataAbility.DataAbilityPredicates	是	指示筛选条件。当此参数为null时，应定义处理逻辑。
callback	AsyncCallback<ResultSet>	是	指示数据查询的回调方法，返回查询结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let cars=new Array('value1', 'value2', 'value3', 'value4');
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.query('dataability:///com.example.DataAbility', cars, da, (error, data) => {
    if (error && error.code !== 0) {
        console.error('query fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('query success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14

DataAbilityHelper.query

query(uri: string, columns?: Array<string>, predicates?: dataAbility.DataAbilityPredicates): Promise<ResultSet>;

查询数据库中的数据（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示要查询数据的uri。
columns	Array<string>	否	指示要查询的列。如果此参数为空，则查询所有列。
predicates	dataAbility.DataAbilityPredicates	否	指示筛选条件。当此参数为null时，应定义处理逻辑。

返回值：

类型	说明
Promise<ResultSet>	返回查询结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataAbility';
let DAHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.DataAbility'
);
let cars = new Array('value1', 'value2', 'value3', 'value4');
let da = new ohos_data_ability.DataAbilityPredicates();
DAHelper.query('dataability:///com.example.DataAbility', cars, da).then((data) => {
    console.info('query data: ${JSON.stringify(data)}');
});

1
2
3
4
5
6
7
8
9
10

DataAbilityHelper.call

call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback<PacMap>): void

调用DataAbility的扩展接口（callback形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'
method	string	是	指示被调用的方法名。
arg	string	是	指示需传入的参数。
extras	PacMap	是	指示扩展的键值对参数。
callback	AsyncCallback<PacMap>	是	指示数据操作的回调方法，返回操作结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';

let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.jsapidemo.UserDataAbility'
);
dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility',
    'method', 'arg', {'key1':'value1'}, (error, data) => {
    if (error && error.code !== 0) {
        console.error('call fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('call success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13

DataAbilityHelper.call

call(uri: string, method: string, arg: string, extras: PacMap): Promise<PacMap>

调用DataAbility的扩展接口（Promise形式）。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'
method	string	是	指示被调用的方法名。
arg	string	是	指示需传入的参数。
extras	PacMap	是	指示扩展的键值对参数。

返回值：

类型	说明
Promise<PacMap>	返回操作结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';

let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.jsapidemo.UserDataAbility'
);
dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility',
    'method', 'arg', {'key1':'value1'}).then((data) => {
    console.info('call success, data: ${data}');
}).catch((error) => {
    console.error('call failed, error: ${error}');
});

1
2
3
4
5
6
7
8
9
10
11

DataAbilityHelper.executeBatch

executeBatch(uri: string, operations: Array<DataAbilityOperation>, callback: AsyncCallback<Array<DataAbilityResult>>): void;

批量操作数据库中的数据。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'。
operations	Array<DataAbilityOperation>	是	指示数据操作数组，其中可以包含对数据库的多个不同操作。
callback	AsyncCallback<Array<DataAbilityResult>>	是	指示批量操作的回调方法，在DataAbilityResult数组中返回每个操作的结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';

// 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array();
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.jsapidemo.UserDataAbility'
);
dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op, (error, data) => {
    if (error && error.code !== 0) {
        console.error('executeBatch fail, error: ${JSON.stringify(error)}');
    } else {
        console.log('executeBatch success, data: ${JSON.stringify(data)}');
    }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14

DataAbilityHelper.executeBatch

executeBatch(uri: string, operations: Array<DataAbilityOperation>): Promise<Array<DataAbilityResult>>;

批量操作数据库中的数据。

系统能力：SystemCapability.Ability.AbilityRuntime.FAModel

参数：

参数名	类型	必填	说明
uri	string	是	指示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'。
operations	Array<DataAbilityOperation>	是	指示数据操作数组，其中可以包含对数据库的多个不同操作。

返回值：

类型	说明
Promise<Array<DataAbilityResult>>	在DataAbilityResult数组中返回每个操作的结果。

示例：

import featureAbility from '@ohos.ability.featureAbility';

// 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array();
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
    'dataability:///com.example.jsapidemo.UserDataAbility'
);
dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => {
    console.info('executeBatch success, data: ${data}');
}).catch((error) => {
    console.error('executeBatch failed, error: ${error}');
});

1
2
3
4
5
6
7
8
9
10
11
12
13

DataAbilityHelper

DataAbilityHelper

使用说明

DataAbilityHelper.openFile

DataAbilityHelper.openFile

DataAbilityHelper.on

DataAbilityHelper.off

DataAbilityHelper.getType

DataAbilityHelper.getType

DataAbilityHelper.getFileTypes

DataAbilityHelper.getFileTypes

DataAbilityHelper.normalizeUri

DataAbilityHelper.normalizeUri

DataAbilityHelper.denormalizeUri

DataAbilityHelper.denormalizeUri

DataAbilityHelper.notifyChange

DataAbilityHelper.notifyChange

DataAbilityHelper.insert

DataAbilityHelper.insert

DataAbilityHelper.batchInsert

DataAbilityHelper.batchInsert

DataAbilityHelper.delete

DataAbilityHelper.delete

DataAbilityHelper.update

DataAbilityHelper.update

DataAbilityHelper.query

DataAbilityHelper.query

DataAbilityHelper.call

DataAbilityHelper.call

DataAbilityHelper.executeBatch

DataAbilityHelper.executeBatch

Description