DataAbilityHelper模塊(JS端SDK接口)
說明:
本模塊首批接口從API version 7開始支持。后續版本的新增接口,采用上角標單獨標記接口的起始版本。
本模塊接口僅可在FA模型下使用。
使用說明
使用前根據具體情況引入如下模塊
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataAbility'
import ohos_data_rdb from '@ohos.data.rdb'
開發前請熟悉鴻蒙開發指導文檔:[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
DataAbilityHelper.openFile
openFile(uri: string, mode: string, callback: AsyncCallback): void
在指定的遠程路徑中打開文件(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要打開的文件的路徑。 |
mode | string | 是 | 指示文件打開模式‘rwt’。 |
callback | AsyncCallback | 是 | 被指定的回調方法,返回文件描述符。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var mode = "rwt";
DAHelper.openFile(
"dataability:///com.example.DataAbility",
mode,
(err) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.openFile
openFile(uri: string, mode: string): Promise
在指定的遠程路徑中打開文件(promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要打開的文件的路徑。 |
mode | string | 是 | 指示文件打開模式‘rwt’。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回文件描述符。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var mode = "rwt";
DAHelper.openFile(
"dataability:///com.example.DataAbility",
mode).then((data) = > {
console.info("========================== >openFileCallback======================= >");
});
DataAbilityHelper.on
on(type: 'dataChange', uri: string, callback: AsyncCallback): void
注冊觀察者以觀察給定uri指定的數據callback通知。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
type | string | 是 | 數據更改。 |
uri | string | 是 | 指示要操作的數據的路徑。 |
callback | AsyncCallback | 是 | 指示數據更改時的回調。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
function onChangeNotify() {
console.info("========================== >onChangeNotify======================= >");
};
helper.on(
"dataChange",
"dataability:///com.example.DataAbility",
onChangeNotify
)
DataAbilityHelper.off
off(type: 'dataChange', uri: string, callback?: AsyncCallback): void
注消觀察者以停止觀察給定uri指定的數據callback通知。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
type | string | 是 | 數據更改。 |
uri | string | 是 | 指示要操作的數據的路徑。 |
callback | AsyncCallback | 否 | 指示已注冊的回調。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
function onChangeNotify() {
console.info("========================== >onChangeNotify======================= >");
};
helper.off(
"dataChange",
"dataability:///com.example.DataAbility",
)
helper.off(
"dataChange",
"dataability:///com.example.DataAbility",
onChangeNotify
)
DataAbilityHelper.getType
getType(uri: string, callback: AsyncCallback): void
獲取給定URI指定數據的MIME類型(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要操作的數據的路徑。 |
callback | AsyncCallback | 是 | 回調方法,返回與uri指定的數據匹配的MIME類型。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.getType(
"dataability:///com.example.DataAbility",
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.getType
getType(uri: string): Promise
獲取給定URI指定數據的MIME類型(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要操作的數據的路徑。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回與uri指定的數據匹配的MIME類型。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.getType(
"dataability:///com.example.DataAbility"
).then((data) = > {
console.info("========================== >getTypeCallback======================= >");
});
DataAbilityHelper.getFileTypes
getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback>): void
獲取支持的文件的MIME類型(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要獲取的文件的路徑。 |
mimeTypeFilter | string | 是 | 指示要獲取的文件的MIME類型。 |
callback | AsyncCallback> | 是 | 回調方法,返回匹配的MIME類型數組。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.getFileTypes(
"dataability:///com.example.DataAbility",
"image/*",
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.getFileTypes
getFileTypes(uri: string, mimeTypeFilter: string): Promise>
獲取支持的文件的MIME類型(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要獲取的文件的路徑。 |
mimeTypeFilter | string | 是 | 指示要獲取的文件的MIME類型。 |
返回值:
類型 | 說明 |
---|---|
Promise> | 返回匹配的MIME類型數組。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.getFileTypes(
"dataability:///com.example.DataAbility",
"image/*"
).then((data) = > {
console.info("========================== >getFileTypesCallback======================= >");
});
DataAbilityHelper.normalizeUri
normalizeUri(uri: string, callback: AsyncCallback): void
將引用數據功能的給定uri轉換為規范化uri(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要規范化的uri對象。 |
callback | AsyncCallback | 是 | 回調方法。如果數據功能支持uri規范化,則返回規范化uri對象;否則返回null。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.normalizeUri(
"dataability:///com.example.DataAbility",
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.normalizeUri
normalizeUri(uri: string): Promise
將引用數據功能的給定uri轉換為規范化uri(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要規范化的uri對象。 |
返回值:
類型 | 說明 |
---|---|
Promise | 如果數據功能支持uri規范化,則返回規范化uri對象;否則返回null。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.normalizeUri(
"dataability:///com.example.DataAbility",
).then((data) = > {
console.info("========================== >normalizeUriCallback======================= >");
});
DataAbilityHelper.denormalizeUri
denormalizeUri(uri: string, callback: AsyncCallback): void
將由normalizeUri(uri)生成的給定規范化uri轉換為非規范化uri(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要規范化的uri對象。 |
callback | AsyncCallback | 是 | 回調方法。如果反規范化成功,則返回反規范化uri對象。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.denormalizeUri(
"dataability:///com.example.DataAbility",
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.denormalizeUri
denormalizeUri(uri: string): Promise
將由normalizeUri(uri)生成的給定規范化uri轉換為非規范化uri(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要規范化的uri對象。 |
返回值:
類型 | 說明 |
---|---|
Promise | 如果反規范化成功,則返回反規范化uri對象。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.denormalizeUri(
"dataability:///com.example.DataAbility",
).then((data) = > {
console.info("========================== >denormalizeUriCallback======================= >");
});
DataAbilityHelper.notifyChange
notifyChange(uri: string, callback: AsyncCallback): void
通知已注冊的觀察者uri指定的數據資源的更改(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要操作的數據的路徑。 |
callback | AsyncCallback | 是 | 回調方法。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
helper.notifyChange(
"dataability:///com.example.DataAbility",
(err) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.notifyChange
notifyChange(uri: string): Promise
通知已注冊的觀察者uri指定的數據資源的更改(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要操作的數據的路徑。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回值為Promise對象。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
DAHelper.notifyChange(
"dataability:///com.example.DataAbility",
).then(() = > {
console.info("========================== >notifyChangeCallback======================= >");
});
DataAbilityHelper.insert
insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback): void
將單個數據記錄插入數據庫(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要插入的數據的路徑。 |
valuesBucket | rdb.ValuesBucket | 是 | 指示要插入的數據記錄。如果此參數為空,將插入一個空行。 |
callback | AsyncCallback | 是 | 回調方法,返回插入數據記錄的索引。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var 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,
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.insert
insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise
將單個數據記錄插入數據庫(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要插入的數據的路徑。 |
valuesBucket | rdb.ValuesBucket | 是 | 指示要插入的數據記錄。如果此參數為空,將插入一個空行。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回插入數據記錄的索引。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var 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("========================== >insertCallback======================= >");
});
DataAbilityHelper.batchInsert
batchInsert(uri: string, valuesBuckets: Array, callback: AsyncCallback): void
插入數據庫(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要插入的數據的路徑。 |
valuesBucket | Array | 是 | 指示要插入的數據記錄。 |
callback | AsyncCallback | 是 | 回調方法。返回插入的數據記錄數。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var 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,
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.batchInsert
batchInsert(uri: string, valuesBuckets: Array): Promise
將多個數據記錄插入數據庫(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要插入的數據的路徑。 |
valuesBucket | Array | 是 | 指示要插入的數據記錄。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回插入的數據記錄數。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var 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("========================== >batchInsertCallback======================= >");
});
DataAbilityHelper.delete
delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void
從數據庫中刪除一個或多個數據記錄(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要刪除的數據的路徑。 |
valuesBucket | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
callback | AsyncCallback | 是 | 回調方法。返回已刪除的數據記錄數。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.delete(
"dataability:///com.example.DataAbility",
da,
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.delete
delete(uri: string, predicates: dataAbility.DataAbilityPredicates): Promise
從數據庫中刪除一個或多個數據記錄(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要刪除的數據的路徑。 |
valuesBucket | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回已刪除的數據記錄數。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var 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("========================== >deleteCallback======================= >");
});
DataAbilityHelper.update
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void
更新數據庫中的數據記錄(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要更新的數據的路徑。 |
valuesBucket | rdb.ValuesBucket | 是 | 指示要更新的數據。 |
predicates | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
callback | AsyncCallback | 是 | 回調方法,返回更新的數據記錄數。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var 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,
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.update
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates): Promise
更新數據庫中的數據記錄(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要更新的數據的路徑。 |
valuesBucket | rdb.ValuesBucket | 是 | 指示要更新的數據。 |
predicates | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
返回值:
類型 | 說明 |
---|---|
Promise | Promise中包含更新的數據記錄數。 。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var 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("========================== >updateCallback======================= >");
});
DataAbilityHelper.query
query(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void
查詢數據庫中的數據(callback形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要查詢的數據的路徑。 |
columns | rdb.ValuesBucket | 是 | 指示要查詢的列。如果此參數為空,則查詢所有列。 |
predicates | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
callback | AsyncCallback | 是 | 回調方法,返回查詢結果。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var cars=new Array("value1", "value2", "value3", "value4");
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.query(
"dataability:///com.example.DataAbility",
cars,
da,
(err, data) = > {
console.info("========================== >Called======================= >");
});
DataAbilityHelper.query
query(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates): Promise
查詢數據庫中的數據(Promise形式)。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指示要查詢的數據的路徑。 |
columns | rdb.ValuesBucket | 是 | 指示要查詢的列。如果此參數為空,則查詢所有列。 |
predicates | dataAbility.DataAbilityPredicates | 是 | 指示篩選條件。當此參數為null時,應定義處理邏輯。 |
返回值:
類型 | 說明 |
---|---|
Promise | 返回查詢結果。 |
示例:
import featureAbility from '@ohos.ability.featureAbility'
import ohos_data_ability from '@ohos.data.dataability'
var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility"
);
var 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("========================== >queryCallback======================= >");
});
DataAbilityHelper.call
call(uri: string, method: string, arg: string, extras: PacMap): Promise
調用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('Operation succeeded: ' + data);
}).catch((error) = > {
console.error('Operation failed. Cause: ' + error);
});
DataAbilityHelper.call
call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback): void
調用DataAbility的擴展接口,使用callback方式作為異步方法。
系統能力 :SystemCapability.Ability.AbilityRuntime.FAModel
參數:
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
uri | string | 是 | 指定待處理的DataAbility。例:"dataability:///com.example.xxx.xxxx" |
method | string | 是 | 被調用的方法名。 |
arg | string | 是 | 需傳入的參數。 |
extras | [PacMap] | 是 | 鍵值對參數。 |
callback | AsyncCallback[[PacMap] | 是 | 返回值。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
示例:
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"}, (err, data) = > {
if (err) {
console.error('Operation failed. Cause: ' + err);
return;
}
console.info('Operation succeeded: ' + data);
});
PacMap
名稱 | 參數類型 | 必填 | 說明 |
---|---|---|---|
[key: string] | number | string | boolean |
審核編輯 黃宇
-
接口
+關注
關注
33文章
8685瀏覽量
151651 -
框架
+關注
關注
0文章
403瀏覽量
17518 -
SDK
+關注
關注
3文章
1045瀏覽量
46131 -
鴻蒙
+關注
關注
57文章
2388瀏覽量
42964
發布評論請先 登錄
相關推薦
評論