Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4969e51c
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
4969e51c
编写于
3月 22, 2023
作者:
C
caochuan
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add query description to fileAccess
Signed-off-by:
N
caochuan
<
caochuan@huawei.com
>
上级
d3ac0d2d
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
93 addition
and
0 deletion
+93
-0
zh-cn/application-dev/reference/apis/js-apis-fileAccess.md
zh-cn/application-dev/reference/apis/js-apis-fileAccess.md
+93
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-fileAccess.md
浏览文件 @
4969e51c
...
...
@@ -1253,6 +1253,82 @@ try {
};
```
## FileAccessHelper.query<sup>10+</sup>
query(uri:string, metaJson: string) : Promise
<
string
>
通过uri查询文件或目录的相关信息,使用Promise异步回调。
**系统能力**
:SystemCapability.FileManagement.UserFileService
**需要权限**
:ohos.permission.FILE_ACCESS_MANAGER
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------------------------------------------------- |
| uri | string | 是 | 所选文件或目录的uri(从
[
FileInfo
](
#fileinfo
)
中获取) |
| metaJson | string | 是 | json字符串,包含查询属性
[
FILEKEY
](
#filekey10
)
|
**返回值:**
| 类型 | 说明 |
| :-------------------- | :------------------------------- |
| Promise
<
string
>
| 返回json字符串,包括查询属性和值 |
**示例:**
```
js
var
imageFileRelativePath
=
"
Download/queryTest/image/01.jpg
"
;
var
jsonStrSingleRelativepath
=
JSON
.
stringify
({
[
fileAccess
.
FileKey
.
RELATIVE_PATH
]:
""
});
try
{
// fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取
var
fileInfo
=
await
fileAccessHelper
.
getFileInfoFromRelativePath
(
imageFileRelativePath
);
let
queryResult
=
await
fileAccessHelper
.
query
(
fileInfo
.
uri
,
jsonStrSingleRelativepath
);
console
.
log
(
"
query_file_single faf query, queryResult.relative_path:
"
+
JSON
.
parse
(
queryResult
).
relative_path
);
}
catch
(
error
)
{
console
.
error
(
"
query_file_single faf query failed, error.code :
"
+
error
.
code
+
"
, errorMessage :
"
+
error
.
message
);
};
```
## FileAccessHelper.query<sup>10+</sup>
query(uri:string, metaJson: string, callback: AsyncCallback
<
string
>
) : void
通过uri查询文件或目录的相关信息,使用callback异步回调。
**系统能力**
:SystemCapability.FileManagement.UserFileService
**需要权限**
:ohos.permission.FILE_ACCESS_MANAGER
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------------------------------- |
| uri | string | 是 | 所选文件或目录的uri(从
[
FileInfo
](
#fileinfo
)
中获取) |
| metaJson | string | 是 | json字符串,包含查询属性
[
FILEKEY
](
#filekey10
)
|
| callback | AsyncCallback
<
string
>
| 是 | 返回json字符串,包括查询属性和值 |
**示例:**
```
js
var
imageFileRelativePath
=
"
Download/queryTest/image/01.jpg
"
;
var
jsonStrSingleRelativepath
=
JSON
.
stringify
({
[
fileAccess
.
FileKey
.
RELATIVE_PATH
]:
""
});
try
{
// fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取
var
fileInfo
=
await
fileAccessHelper
.
getFileInfoFromRelativePath
(
imageFileRelativePath
);
fileAccessHelper
.
query
(
fileInfo
.
uri
,
jsonStrSingleRelativepath
,
(
err
,
queryResult
)
=>
{
if
(
err
)
{
console
.
log
(
"
query_file_single faf query Failed, errCode:
"
+
err
.
code
+
"
, errMessage:
"
+
err
.
message
);
return
;
}
console
.
log
(
"
query_file_single faf query, queryResult.relative_path:
"
+
JSON
.
parse
(
queryResult
).
relative_path
);
})
}
catch
(
error
)
{
console
.
error
(
"
query_file_single faf query failed, error.code :
"
+
error
.
code
+
"
, errorMessage :
"
+
error
.
message
);
};
```
## RootIterator.next
next( ) : { value: RootInfo, done: boolean }
...
...
@@ -1334,3 +1410,20 @@ FileIterator表示文件夹的迭代器对象,可以通过next同步方法获
| READ | 0o0 | 读模式。 |
| WRITE | 0o1 | 写模式。 |
| WRITE_READ | 0o2 | 读写模式。 |
## FILEKEY<sup>10+</sup>
支持查询的键。
**系统能力:**
SystemCapability.FileManagement.UserFileService
| 名称 | 值 | 说明 |
| ------------- | ------------- | ----------------------------------- |
| DISPLAY_NAME | display_name | 文件名 |
| DATE_ADDED | date_added | 文件创建的日期,例如1501925454 |
| DATE_MODIFIED | date_modified | 文件的修改日期,例如1665310670 |
| RELATIVE_PATH | relative_path | 相对路径,例如Pictures/Screenshots/ |
| FILE_SIZE | size | 文件(夹)大小(单位:字节) |
| WIDTH | width | 图像文件的宽度(单位:像素) |
| HEIGHT | height | 图像文件的高度(单位:像素) |
| DURATION | duration | 音频和视频文件的时长(单位:毫秒) |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录