diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileio.md b/zh-cn/application-dev/reference/apis/js-apis-fileio.md index 8850e5c9c6048e0ec01dd1b028fe6da9ea9c2a95..59a49d7fac2fe24536805b92bec6adce7d269906 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md @@ -3,13 +3,7 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -该模块提供文件存储相关的常用功能，向应用程序提供用于IO的JS接口，包括: - -- 用于管理文件的基本文件接口 -- 用于管理目录的基本目录接口 -- 用于获取文件信息的统计接口 -- 用于流式读写文件的流式接口 - +该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。 ## 导入模块 @@ -20,20 +14,11 @@ import fileio from '@ohos.fileio'; ## 使用说明 -使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱绝对路径，“文件/目录应用沙箱路径”=“应用目录路径”+“文件/目录名”。 -应用目录路径dir的获取方式及对应的接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 -通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在应用沙箱路径为： - -```js -let path = dir + "/xxx.txt"; -``` - - -文件描述符fd： - - -```js -let fd = fileio.openSync(path); +使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考： + ```js + import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); + let path = context.getFilesDir(); ``` @@ -1201,7 +1186,7 @@ ftruncate(fd: number, len: number, callback:AsyncCallback<void>): void | -------- | ------------------------- | ---- | ---------------- | | fd | number | 是 | 待截断文件的文件描述符。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 | - | callback | AsyncCallback<void> | 是 | 异步截断文件的信息之后的回调。 | + | callback | AsyncCallback<void> | 是 | 回调函数，本调用无返回值。 | **示例：** ```js @@ -1273,7 +1258,7 @@ truncate(path: string, len: number, callback:AsyncCallback<void>): void | -------- | ------------------------- | ---- | -------------------------------- | | path | string | 是 | 待截断文件的应用沙箱路径。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 | -| callback | AsyncCallback<void> | 是 | 异步截断文件的信息之后的回调。 | +| callback | AsyncCallback<void> | 是 | 回调函数，本调用无返回值。 | **示例：** ```js @@ -1352,8 +1337,8 @@ readText(filePath: string, options: { | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | ------------------------------------------------------------ | | filePath | string | 是 | 待读取文件的应用沙箱路径。 | -| options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | -| callback | AsyncCallback<string> | 是 | 异步通过文本方式读取文件之后的回调。 | +| options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | +| callback | AsyncCallback<string> | 是 | 回调函数，返回读取文件的内容。 | **示例：** ```js @@ -1403,12 +1388,12 @@ lstat(path: string): Promise<Stat> **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | -------------------------------------- | -| path | string | 是 | 目标文件的应用沙箱路径，指向链接。 | +| path | string | 是 | 目标文件的应用沙箱路径。 | **返回值：** | 类型 | 说明 | | ---------------------------- | ---------- | - | Promise<[Stat](#stat)> | Promise对象。返回表示文件状态的具体信息。 | + | Promise<[Stat](#stat)> | promise对象，返回文件对象，表示文件的具体信息，详情见stat。 | **示例：** ```js @@ -1431,8 +1416,8 @@ lstat(path:string, callback:AsyncCallback<Stat>): void **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------- | ---- | -------------------------------------- | -| path | string | 是 | 目标文件的应用沙箱路径，指向链接。 | -| callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取链接信息之后的回调。 | +| path | string | 是 | 目标文件的应用沙箱路径。 | +| callback | AsyncCallback<[Stat](#stat)> | 是 | 回调函数，返回文件的具体信息。 | **示例：** ```js @@ -1453,7 +1438,7 @@ lstatSync(path:string): Stat **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | -------------------------------------- | -| path | string | 是 | 目标文件的应用沙箱路径，指向链接。 | +| path | string | 是 | 目标文件的应用沙箱路径。 | **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md index a17aa78769392598ca9e4e25697fe8043320442b..ad36bb9398ef2b675f411c49f8eb2b2d14e4290b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md @@ -63,13 +63,19 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback<FileInfo[]>) - 示例 ```js - filemanager.getRoot((err, fileInfo) => { + let option = { + "dev":{ + name:"", + } + }; + filemanager.getRoot(option,(err, fileInfo)=>{ if(Array.isArray(fileInfo)) { for (var i = 0; i < fileInfo.length; i++) { console.log("file:"+JSON.stringify(fileInfo)); } - } + } }); + ``` ## filemanager.listFile @@ -105,7 +111,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ```js // 获取目录下所有文件 // 通过listFile、getRoot获取的文件uri - let media_path = file.uri + let media_path = file.path filemanager.listFile(media_path, "file") .then((fileInfo) => { if(Array.isArray(fileInfo)) { @@ -114,6 +120,9 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num } } }).catch((err) => { + + + console.log(err) }); ``` @@ -145,14 +154,30 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num - 示例 ```js - // 通过listFile、getRoot获取的文件uri - let media_path = file.uri - filemanager.listFile(media_path, "file", (err, fileInfo) => { - if(Array.isArray(fileInfo)) { - for (var i = 0; i < fileInfo.length; i++) { - console.log("file:"+JSON.stringify(fileInfo)); - } - } + // 通过listFile、getRoot获取的文件path + let fileInfos = await filemanager.getRoot(); + let media_path = ""; + for (let i = 0; i < fileInfos.length; i++) { + if (fileInfos[i].name == "image_album") { + media_path = fileInfos[i].path; + } else if (fileInfos[i].name == "audio_album") { + media_path = fileInfos[i].path; + } else if (fileInfos[i].name == "video_album") { + media_path = fileInfos[i].path; + } else if (fileInfos[i].name == "file_folder") { + media_path = fileInfos[i].path; + } + } + + filemanager.listFile(media_path, "file") + .then((fileInfo) => { + if(Array.isArray(fileInfo)) { + for (var i = 0; i < fileInfo.length; i++) { + console.log("file:"+JSON.stringify(fileInfo)); + } + } + }).catch((err) => { + console.log(err) }); ``` @@ -230,7 +255,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ```js // 创建文件，返回文件uri // 通过listFile、getRoot获取的文件uri - let media_path = file.uri + let media_path = file.path // 待保存文件的后缀 let name = "xxx.jpg" filemanager.createFile(media_path, name, (err, uri) => { diff --git a/zh-cn/application-dev/reference/apis/js-apis-statfs.md b/zh-cn/application-dev/reference/apis/js-apis-statfs.md index fb5a81bd330d1e919c282620af2932e024e0091f..d213902e4c4f46d228f1765e417ea2371306fb36 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-statfs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-statfs.md @@ -10,19 +10,6 @@ ```js import statfs from '@ohos.statfs'; ``` - -## 使用说明 - -使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 - -“文件/目录应用沙箱路径”=“应用目录路径”+“文件/目录名” - -通过上述接口获取到应用目录路径dir，以文件名“xxx.txt”为例，文件所在应用沙箱路径为： - -```js -let path = dir + "xxx.txt"; -``` - ## statfs.getFreeBytes getFreeBytes(path:string):Promise<number> @@ -72,8 +59,12 @@ getFreeBytes(path:string, callback:AsyncCallback<number>): void - 示例： ```js - statfs.getFreeBytes(path, function(err, number){ - console.info("getFreeBytes callback successfully:"+ number); + import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); + context.getFilesDir().then(function (path) { + statfs.getFreeBytes(path, function(err, number){ + console.info("getFreeBytes callback successfully:"+ number); + }); }); ``` @@ -126,8 +117,12 @@ getTotalBytes(path: string, callback: AsyncCallback<number>): void - 示例： ```js - statfs.getTotalBytes(path, function(err, number){ - console.info("getTotalBytes callback successfully:"+ number); + import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); + context.getFilesDir().then(function (path) { + statfs.getTotalBytes(path, function(err, number){ + console.info("getTotalBytes callback successfully:"+ number); + }); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-file.md b/zh-cn/application-dev/reference/apis/js-apis-system-file.md index a54f28518195eca0fbe95c243cbb86df74d2b81c..20943aa0858c764e861f857122a2d6bbedd73837 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-file.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-file.md @@ -154,7 +154,7 @@ export default { file.list({ uri: 'internal://app/pic', success: function(data) { - console.log(data.fileList); + console.log(JSON.stringify(data.fileList)); }, fail: function(data, code) { console.error('call fail callback fail, code: ' + code + ', data: ' + data); diff --git a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md index 9e0aac9d0251f33d2a47b7d1da6b6e32aede650b..d08b87900767d7c91a25bce5629468448c8901a1 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md @@ -54,7 +54,7 @@ getAllVolumes(callback: AsyncCallback<Array<Volume>>): void ```js let uuid = ""; - volumemanager.getAllVolumes(uuid, function(error, volumes){ + volumemanager.getAllVolumes(function(error, volumes){ // do something }); ```