OpenHarmony源码解析之JavaScript(文件管理API)

开发 前端
文件管理在手机、平板、智慧屏等设备上都是一个很重要的功能,通过文件管理相关 API 我们可以实现对指定文件的删除、复制、移动、压缩解压缩等操作。

[[436543]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

1、简介

文件管理在手机、平板、智慧屏等设备上都是一个很重要的功能,通过文件管理相关 API 我们可以实现对指定文件的删除、复制、移动、压缩解压缩等操作。本篇文章通过一个小DEMO来演示该如何使用官方提供的API来实现对指定文件的相关操作。

1.1 OpenHarmony架构图

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

1.2 文件管理Demo效果演示

2、基础知识

注意:

API Version 6 开始支持。

目前只能对应用私有目录下的文件操作权限,想实现类似文件管理的应用还需等更高权限的开放。

2.1 主要API

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

2.2 参考资料

HarmonyOS js-apis-fileio( 文件管理)

OpenHarmony js-apis-fileio.md( 文件管理)

3、示例Demo

目前文件管理API支持在手机、平板、智慧屏上调用,暂不支持智能穿戴设备上调用。使用该功能模块对文件/目录进行操作前,需要先获取其绝对路径,获取方式及其接口用法请参考Ability上下文。

3.1 获取Ability上下文

在使用AbilityContext的功能前,需要通过getContext()先获取Context对象。在使用AbilityContext的功能前,需要通过getContext()先获取Context对象。

示例

  1. import ability_featureability from '@ohos.ability.featureAbility' 
  2. var context = ability_featureability.getContext();   

3.2 获取应用目录路径

目录类型如下图所示:

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

“文件/目录绝对路径”=“应用目录路径”+“文件/目录名”,通过上述接口获取到应用目录路径dir,文件名为“xxx.txt”,文件所在绝对路径为:

let path = dir + "xxx.txt";

示例

  1. context.getFilesDir() 
  2.           .then((data) => { 
  3.               console.info('Cache directory obtained. Data: ' + data + "getFilesDir"); 
  4.               this.filePath = data; 
  5.               this.mDirPath = this.filePath + "/cache_files/"
  6.               this.findFile(); 
  7.           }).catch((error) => { 
  8.           console.error('Failed to obtain the cache directory. Cause:' + error.message); 
  9.       }) 

3.3 创建测试文件

在对文件操作之前我们首先创建几个测试文件,通过以下代码就可以成功创建文件

示例

  1. createTestFiles() { 
  2.        for (let i = 0;i < 4; i++) { 
  3.            file.writeText({ 
  4.                uri: 'internal://app//cache_files/' + "file-manager-test" + i + ".txt"
  5.                text: 'Text that just for test.' + i, 
  6.                success: function () { 
  7.                    console.log('call writeText success.'); 
  8.                }, 
  9.                fail: function (data, code) { 
  10.                    console.error('call fail callback fail, code: ' + code + ', data: ' + data); 
  11.                }, 
  12.            }); 
  13.        } 
  14.    } 

3.4 导入文件管理模块

  1. import fileio from '@ohos.fileio'

3.5 获取文件详细信息

以异步方法获取文件信息,使用callback形式返回结果

  1. fileio.stat(path, function (err, stat) {     
  2.     }); 

 以同步方法获取文件的信息

  1. let stat = fileio.statSync(path); 

 以异步方式为例,我们可以获取到文件的大小等信息,代码如下:

  1. let path = that.mDirPath + any[i].uri.substring(index + 1); 
  2.                       fileio.stat(path, function (err, stat) { 
  3.                           console.info("Get file stat success:" + "fileSize:" + stat.size + 
  4.                           "-------" + "fileName:" + any[i].uri.substring(index + 1)); 
  5.                       }); 

 日志截图如下:

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

3.6 删除文件

以异步方法删除文件,使用callback形式返回结果

  1. fileio.unlink(path, function(err) { 
  2.     if (!err) { 
  3.         // 文件删除成功 
  4.     } 
  5. }); 

 以同步方法删除文件

  1. fileio.unlinkSync(path); 

 以异步方式为例,执行文件的删除操作,代码如下:

  1. fileio.unlink(filePath, function (err) { 
  2.             if (!err) { 
  3.                 prompt.showToast({ 
  4.                     message: "删除成功" 
  5.                 });  
  6.             } 
  7.         }); 

 通过对比查看删除前后的日志文件可以验证文件删除成功:

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

3.7 创建文件夹

以异步方法创建目录,使用callback形式返回结果

  1. fileio.mkdir(path, function(err) { 
  2.     if (!err) { 
  3.         // 创建文件夹成功 
  4.     } 
  5. }); 

 以同步方法创建目录

  1. fileio.mkdirSync(path); 

以同步创建目录方式,创建dir_test_ 测试文件夹,代码如下:

  1. for (let i = 0;i < 4; i++) { 
  2.                    fileio.mkdirSync(data + "/cache_files/dir_test_" + i); 
  3.                } 

 通过日志我们可以验证文件夹创建成功

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

3.8 文件的复制、移动操作

以异步方法复制文件,使用callback形式返回结果

  1. fileio.copyFile(src, dest, function (err) {  
  2. }); 

以同步方法复制文件

  1. fileio.copyFileSync(src, dest); 

src:待复制文件的路径或待复制文件的描述符,dest:目标文件路径或目标文件描述符,具体代码如下:

  1. fileio.copyFile(filePath, dest, function (err) { 
  2.              if(!err){ 
  3.                 prompt.showToast({ 
  4.                     message: "复制成功" 
  5.                 }); 
  6.             } 
  7.         }); 

 通过查询目标路径下面文件信息来验证操作是否成功

 OpenHarmony 源码解析之JavaScript(文件管理API)-鸿蒙HarmonyOS技术社区

文章相关附件可以点击下面的原文链接前往下载

https://harmonyos.51cto.com/resource/1524

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2021-09-16 15:08:08

鸿蒙HarmonyOS应用

2021-08-30 18:09:57

鸿蒙HarmonyOS应用

2023-04-12 15:31:11

系统服务管理鸿蒙

2022-03-29 10:04:44

APIHarmony文件管理

2022-02-14 14:47:11

SystemUIOpenHarmon鸿蒙

2021-11-18 10:28:03

鸿蒙HarmonyOS应用

2021-12-14 14:45:38

鸿蒙HarmonyOS应用

2022-05-17 10:42:36

reboot源码解析

2022-06-13 14:18:39

电源管理子系统耗电量服务

2022-05-20 10:32:49

事件循环器事件队列鸿蒙

2021-09-18 14:40:37

鸿蒙HarmonyOS应用

2021-12-17 16:42:09

鸿蒙HarmonyOS应用

2022-07-05 16:03:29

电源管理子系统鸿蒙

2021-11-08 15:04:47

鸿蒙HarmonyOS应用

2022-01-06 16:17:58

鸿蒙HarmonyOS应用

2021-12-08 15:07:51

鸿蒙HarmonyOS应用

2022-02-17 20:57:07

OpenHarmon操作系统鸿蒙

2022-03-10 14:45:23

HarmonyAPI操作系统

2022-01-20 14:33:29

openharmonwayland协议鸿蒙

2021-12-06 06:19:03

鸿蒙HarmonyOS应用
点赞
收藏

51CTO技术栈公众号