Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e242618c
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
e242618c
编写于
8月 22, 2022
作者:
O
openharmony_ci
提交者:
Gitee
8月 22, 2022
浏览文件
操作
浏览文件
下载
差异文件
!8318 【轻量级 PR】:update zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md.
Merge pull request !8318 from 葛亚芳/N/A
上级
bffa29c3
0427f459
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
0 addition
and
242 deletion
+0
-242
zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md
.../application-dev/reference/apis/js-apis-data-dataShare.md
+0
-242
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md
浏览文件 @
e242618c
...
@@ -91,85 +91,12 @@ dataShare.createDataShareHelper(this.context, uri).then((data) => {
...
@@ -91,85 +91,12 @@ dataShare.createDataShareHelper(this.context, uri).then((data) => {
DataShare管理工具实例,可使用此实例访问或管理服务端的数据。在调用DataShareHelper提供的方法前,需要先通过
[
createDataShareHelper
](
#datasharecreatedatasharehelper
)
构建一个实例。
DataShare管理工具实例,可使用此实例访问或管理服务端的数据。在调用DataShareHelper提供的方法前,需要先通过
[
createDataShareHelper
](
#datasharecreatedatasharehelper
)
构建一个实例。
此接口仅可在Stage模型下使用。
### openFile
openFile(uri: string, mode: string, callback: AsyncCallback
<
number
>
): void
打开指定路径的文件。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------- | ---- | ---------------------------------- |
| uri | string | 是 | 指示要打开的文件的路径。 |
| mode | string | 是 | 指示文件打开模式,如“r”表示只读访问,“w”表示只写访问(擦除文件中当前的任何数据),“wa”表示附加到任何现有数据的写访问,“rw”表示对任何现有数据的读写访问。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数。当打开指定路径的文件成功,err为undefined,data为获取到的文件描述符;否则为错误对象。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
dataShareHelper
.
openFile
(
uri
,
"
rwt
"
,
(
err
,
data
)
=>
{
if
(
err
!=
undefined
)
{
console
.
info
(
"
openFile failed, error message :
"
+
err
);
}
else
{
console
.
info
(
"
openFile succeed, data :
"
+
data
);
let
fd
=
data
;
}
});
```
### openFile
openFile(uri: string, mode: string): Promise
<
number
>
打开指定路径的文件。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要打开的文件的路径 |
| mode | string | 是 | 指示文件打开模式,如“r”表示只读访问,“w”表示只写访问(擦除文件中当前的任何数据),“wa”表示附加到任何现有数据的写访问,“rw”表示对任何现有数据的读写访问。 |
**返回值:**
| 类型 | 说明 |
| --------------- | ---------------- |
| Promise
<
number
>
| Promise对象。返回文件描述符。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
dataShareHelper
.
openFile
(
uri
,
"
rwt
"
).
then
((
data
)
=>
{
console
.
info
(
"
openFile succeed, data :
"
+
data
);
let
fd
=
data
;
}).
catch
((
err
)
=>
{
console
.
info
(
"
openFile failed, error message :
"
+
err
);
})
```
### on('dataChange')
### on('dataChange')
on(type: 'dataChange', uri: string, callback: AsyncCallback
<
void
>
): void
on(type: 'dataChange', uri: string, callback: AsyncCallback
<
void
>
): void
订阅指定URI对应数据的数据变更事件。若用户(订阅者)已注册了观察者,当有其他用户触发了变更通知时(调用了下文中的notifyChange方法),订阅者将会接收到callback通知。使用callback异步回调。
订阅指定URI对应数据的数据变更事件。若用户(订阅者)已注册了观察者,当有其他用户触发了变更通知时(调用了下文中的notifyChange方法),订阅者将会接收到callback通知。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -197,8 +124,6 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback<void>): void
...
@@ -197,8 +124,6 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback<void>): void
取消订阅指定URI对应的数据资源的变更通知。使用callback异步回调。
取消订阅指定URI对应的数据资源的变更通知。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -226,8 +151,6 @@ insert(uri: string, value: ValuesBucket, callback: AsyncCallback<number>):
...
@@ -226,8 +151,6 @@ insert(uri: string, value: ValuesBucket, callback: AsyncCallback<number>):
将单条数据插入数据库。使用callback异步回调。
将单条数据插入数据库。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -263,8 +186,6 @@ insert(uri: string, value: ValuesBucket): Promise<number>
...
@@ -263,8 +186,6 @@ insert(uri: string, value: ValuesBucket): Promise<number>
将单条数据插入数据库。使用Promise异步回调。
将单条数据插入数据库。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -303,8 +224,6 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callbac
...
@@ -303,8 +224,6 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callbac
从数据库中删除一条或多条数据记录。使用callback异步回调。
从数据库中删除一条或多条数据记录。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -339,8 +258,6 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates): Promis
...
@@ -339,8 +258,6 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates): Promis
从数据库中删除一条或多条数据记录。使用Promise异步回调。
从数据库中删除一条或多条数据记录。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -378,8 +295,6 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns:
...
@@ -378,8 +295,6 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns:
查询数据库中的数据。使用callback异步回调。
查询数据库中的数据。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -416,8 +331,6 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns:
...
@@ -416,8 +331,6 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns:
查询数据库中的数据。使用Promise异步回调。
查询数据库中的数据。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -457,8 +370,6 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value:
...
@@ -457,8 +370,6 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value:
更新数据库中的数据记录。使用callback异步回调。
更新数据库中的数据记录。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -500,8 +411,6 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value:
...
@@ -500,8 +411,6 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value:
更新数据库中的数据记录。使用Promise异步回调。
更新数据库中的数据记录。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -546,8 +455,6 @@ batchInsert(uri: string, values: Array<ValuesBucket>, callback: AsyncCallb
...
@@ -546,8 +455,6 @@ batchInsert(uri: string, values: Array<ValuesBucket>, callback: AsyncCallb
将批量数据插入数据库。使用callback异步回调。
将批量数据插入数据库。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -581,8 +488,6 @@ batchInsert(uri: string, values: Array<ValuesBucket>): Promise<number&g
...
@@ -581,8 +488,6 @@ batchInsert(uri: string, values: Array<ValuesBucket>): Promise<number&g
将批量数据插入数据库。使用Promise异步回调。
将批量数据插入数据库。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -613,149 +518,12 @@ dataShareHelper.batchInsert(uri, vbs).then((data) => {
...
@@ -613,149 +518,12 @@ dataShareHelper.batchInsert(uri, vbs).then((data) => {
});
});
```
```
### getType
getType(uri: string, callback: AsyncCallback
<
string
>
): void
获取URI所指定的数据的MIME类型。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | --------------------------------------------- |
| uri | string | 是 | 表示指定的数据路径。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数。当获取URI所指定的数据的MIME类型成功,err为undefined,data为获取到的与URI指定的数据匹配的MIME类型;否则为错误对象。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
dataShareHelper
.
getType
(
uri
,
(
err
,
data
)
=>
{
if
(
err
!=
undefined
)
{
console
.
log
(
"
getType failed, error message :
"
+
err
);
}
else
{
console
.
log
(
"
getType succeed, data :
"
+
data
);
let
result
=
data
;
}
});
```
### getType
getType(uri: string): Promise
<
string
>
获取URI所指定数据的MIME类型。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | -------------------- |
| uri | string | 是 | 表示指定的数据路径。 |
**返回值:**
| 类型 | 说明 |
| ---------------- | ----------------------------------- |
| Promise
<
string
>
| Promise对象。返回与URI指定的数据匹配的MIME类型。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
dataShareHelper
.
getType
(
uri
).
then
((
data
)
=>
{
console
.
log
(
"
getType succeed, data :
"
+
data
);
}).
catch
((
err
)
=>
{
console
.
log
(
"
getType failed, error message :
"
+
err
);
});
```
### getFileTypes
getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback
<
Array
<
string
>>
): void
获取支持的文件的MIME类型。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要获取的文件的路径。 |
| mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如:
<br
/>
“
\*
/
\*
”:获取支持的所有类型。
<br/>
“image/
\*
”:获取主类型image,子类型为任何类型的MIME。
<br
/>
”
\*
/jpg”:获取子类型为jpg,主类型为任何类型的MIME。 |
| callback | AsyncCallback
<Array
\<
string
>
> | 是 | 回调函数。当获取支持的文件的MIME类型成功,err为undefined,data为获取到的匹配的MIME类型数组;否则为错误对象。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
let
mimeTypeFilter
=
"
image/*
"
;
dataShareHelper
.
getFileTypes
(
uri
,
mimeTypeFilter
,
(
err
,
data
)
=>
{
if
(
err
!=
undefined
)
{
console
.
log
(
"
getFileTypes failed, error message :
"
+
err
);
}
else
{
console
.
log
(
"
getFileTypes succeed, data :
"
+
data
);
}
});
```
### getFileTypes
getFileTypes(uri: string, mimeTypeFilter: string): Promise
<
Array
<
string
>>
获取支持的文件的MIME类型。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要获取的文件的路径。 |
| mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如:
<br
/>
“
\*
/
\*
”:获取支持的所有类型。
<br/>
“image/
\*
”:获取主类型image,子类型为任何类型的MIME。
<br
/>
”
\*
/jpg”:获取子类型为jpg,主类型为任何类型的MIME。 |
**返回值:**
| 类型 | 说明 |
| ------------------------ | ------------------------ |
| Promise
<
Array
<
string
>>
| Promise对象。返回匹配的MIME类型数组。 |
**示例:**
```
ts
import
Ability
from
'
@ohos.application.Ability
'
let
uri
=
(
"
datashare:///com.samples.datasharetest.DataShare
"
);
let
mimeTypeFilter
=
"
image/*
"
;
dataShareHelper
.
getFileTypes
(
uri
,
mimeTypeFilter
).
then
((
data
)
=>
{
console
.
log
(
"
getFileTypes succeed, data :
"
+
data
);
}).
catch
((
err
)
=>
{
console
.
log
(
"
getFileTypes failed, error message :
"
+
err
);
});
```
### normalizeUri
### normalizeUri
normalizeUri(uri: string, callback: AsyncCallback
<
string
>
): void
normalizeUri(uri: string, callback: AsyncCallback
<
string
>
): void
将给定的DataShare URI转换为规范化URI,规范化URI可供跨设备使用,DataShare URI仅供本地环境中使用。使用callback异步回调。
将给定的DataShare URI转换为规范化URI,规范化URI可供跨设备使用,DataShare URI仅供本地环境中使用。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -785,8 +553,6 @@ normalizeUri(uri: string): Promise<string>
...
@@ -785,8 +553,6 @@ normalizeUri(uri: string): Promise<string>
将给定的DataShare URI转换为规范化URI,规范化URI可供跨设备使用,DataShare URI仅供本地环境中使用。使用Promise异步回调。
将给定的DataShare URI转换为规范化URI,规范化URI可供跨设备使用,DataShare URI仅供本地环境中使用。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -819,8 +585,6 @@ denormalizeUri(uri: string, callback: AsyncCallback<string>): void
...
@@ -819,8 +585,6 @@ denormalizeUri(uri: string, callback: AsyncCallback<string>): void
将指定的URI转换为非规范化URI。使用callback异步回调。
将指定的URI转换为非规范化URI。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -850,8 +614,6 @@ denormalizeUri(uri: string): Promise<string>
...
@@ -850,8 +614,6 @@ denormalizeUri(uri: string): Promise<string>
将指定的URI转换为非规范化URI。使用Promise异步回调。
将指定的URI转换为非规范化URI。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -884,8 +646,6 @@ notifyChange(uri: string, callback: AsyncCallback<void>): void
...
@@ -884,8 +646,6 @@ notifyChange(uri: string, callback: AsyncCallback<void>): void
通知已注册的观察者指定URI对应的数据资源已发生变更。使用callback异步回调。
通知已注册的观察者指定URI对应的数据资源已发生变更。使用callback异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
@@ -911,8 +671,6 @@ notifyChange(uri: string): Promise<void>
...
@@ -911,8 +671,6 @@ notifyChange(uri: string): Promise<void>
通知已注册的观察者指定URI对应的数据资源已发生变更。使用Promise异步回调。
通知已注册的观察者指定URI对应的数据资源已发生变更。使用Promise异步回调。
此接口仅可在Stage模型下使用。
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**系统能力:**
SystemCapability.DistributedDataManager.DataShare.Consumer
**参数:**
**参数:**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录