OpenHarmony文件访问接口（filemanagement_file_api）

概述

OpenHarmony文件访问接口（filemanagement_file_api）是开源鸿蒙操作系统中的核心文件系统接口，为应用程序提供了完整的文件IO操作能力。该项目基于Node-API（NAPI）技术，实现了JavaScript到C++的桥接，支持多种编程语言接口，包括JavaScript、C、C++、Rust等。

整体架构

在这里插入图片描述

1. 目录结构分析

foundation/filemanagement/file_api/
├── figures/                     # 项目图床和架构图
│   ├── file-api-architecture.png
│   └── file-api-架构图.png
├── interfaces/                  # 核心接口实现
│   ├── kits/                   # 对外提供的接口套件
│   │   ├── c/                  # C语言接口
│   │   ├── cj/                 # C++/JavaScript混合接口
│   │   ├── hyperaio/           # 高性能异步IO模块
│   │   ├── js/                 # JavaScript接口（核心）
│   │   ├── native/             # 原生接口
│   │   ├── rust/               # Rust接口
│   │   └── ts/                 # TypeScript接口
│   └── test/                   # 单元测试
├── utils/                      # 公共工具库
│   ├── filemgmt_libhilog/      # 日志组件
│   ├── filemgmt_libn/          # NAPI抽象层
│   └── filemgmt_libfs/         # 文件系统工具
├── bundle.json                 # 项目配置
├── file_api.gni               # 构建配置
└── README_zh.md               # 中文文档

2. 核心模块组成

文件访问接口由以下5个核心模块组成：

  • ohos.file.fs - 基础文件系统操作
  • ohos.file.statvfs - 文件系统统计信息
  • ohos.file.hash - 文件哈希计算
  • ohos.file.securityLabel - 文件安全标签
  • ohos.file.environment - 环境管理

各目录详细分析

1. interfaces/kits/js/ - JavaScript接口核心

这是文件访问接口的核心模块，提供了完整的JavaScript文件操作API。

1.1 模块结构
interfaces/kits/js/src/
├── common/                     # 公共组件
│   ├── napi/                  # NAPI抽象层实现
│   ├── ability_helper/        # 能力助手
│   └── file_helper/           # 文件操作助手
├── mod_file/                  # 文件操作模块
├── mod_fileio/                # 文件IO模块
├── mod_fs/                    # 文件系统模块
├── mod_hash/                  # 哈希计算模块
├── mod_environment/           # 环境管理模块
├── mod_securitylabel/         # 安全标签模块
├── mod_statfs/                # 文件系统统计模块
└── mod_statvfs/               # 虚拟文件系统统计模块
1.2 核心模块功能

mod_file模块：

  • 提供基础文件操作：创建、删除、复制、移动
  • 支持文本和二进制数据读写
  • 实现异步操作模式
  • 包含12个核心API接口

mod_fileio模块：

  • 提供文件描述符操作
  • 支持目录遍历和文件监控
  • 实现流式读写操作
  • 包含文件锁功能

mod_fs模块：

  • 提供完整的文件系统操作
  • 支持原子文件操作
  • 实现随机访问文件
  • 包含文件监控和任务信号
1.3 模块层次架构
应用层
mod_fs - 文件系统层
mod_file - 基础文件层
mod_fileio - 文件IO层
系统调用

2. interfaces/kits/c/ - C语言接口

提供C语言的原生接口，主要用于系统级开发。

interfaces/kits/c/
├── common/                    # 公共定义
│   └── error_code.h          # 错误码定义
├── environment/               # 环境管理接口
│   ├── environment.h
│   └── environment.c
└── fileio/                   # 文件IO接口├── fileio.h└── fileio.c

3. interfaces/kits/cj/ - C++/JavaScript混合接口

提供C++和JavaScript之间的桥接功能，包含大量的FFI（Foreign Function Interface）实现。

interfaces/kits/cj/src/
├── file_ffi.cpp              # 文件操作FFI
├── file_fs_ffi.cpp           # 文件系统FFI
├── copy_file.cpp             # 文件复制实现
├── move_file.cpp             # 文件移动实现
├── list_file.cpp             # 文件列表实现
├── stat_ffi.cpp              # 文件状态FFI
├── stream_ffi.cpp            # 流操作FFI
└── watcher_impl.cpp          # 文件监控实现

4. interfaces/kits/hyperaio/ - 高性能异步IO

基于Linux io_uring技术实现的高性能异步IO模块。

// 核心实现示例
int32_t HyperAio::CtxInit(ProcessIoResultCallBack *callBack)
{int32_t ret = io_uring_queue_init(URING_QUEUE_SIZE, &pImpl_->uring_, 0);if (ret < 0) {HILOGE("init io_uring failed, ret = %{public}d", ret);return ret;}ioResultCallBack_ = *callBack;stopThread_.store(false);harvestThread_ = std::thread(&HyperAio::HarvestRes, this);initialized_.store(true);return EOK;
}

5. interfaces/kits/native/ - 原生接口

提供原生C++接口，供其他模块调用。

interfaces/kits/native/
├── environment/               # 环境管理原生接口
├── fileio/                   # 文件IO原生接口
├── remote_uri/               # 远程URI处理
└── task_signal/              # 任务信号处理

6. interfaces/kits/rust/ - Rust接口

提供Rust语言的文件操作接口。

interfaces/kits/rust/
├── src/
│   ├── lib.rs                # 库入口
│   ├── ffi.rs                # FFI绑定
│   └── adapter.rs            # 适配器
└── include/└── rust_file.h           # C头文件

7. interfaces/kits/ts/ - TypeScript接口

提供TypeScript类型定义和接口。

interfaces/kits/ts/
├── streamrw/                 # 流读写接口
└── streamhash/               # 流哈希接口

调用流程分析

1. JavaScript到C++的完整调用链

JavaScript应用NAPI层LibN抽象层C++实现层系统调用层调用文件操作API参数解析和类型转换创建异步工作队列执行系统调用返回操作结果处理结果和错误回调函数调用返回结果给JavaScriptJavaScript应用NAPI层LibN抽象层C++实现层系统调用层

2. 具体实现示例

以文件复制操作为例：

// 1. JavaScript调用
file.copy({srcUri: "internal://app/source.txt",dstUri: "internal://app/destination.txt",success: () => console.log("复制成功"),fail: (err) => console.error("复制失败", err)
});// 2. NAPI层处理
static napi_value Copy(napi_env env, napi_callback_info info)
{// 参数解析auto [argc, argv] = NVal(env, info).ToArgcArgv();// 创建异步工作auto asyncCallbackInfo = make_unique<AsyncCopyCallbackInfo>();// 执行异步操作return NAsyncWorkPromise(env, asyncCallbackInfo.get(), "Copy", CopyExec, CopyComplete).val_;
}// 3. 异步执行函数
void CopyExec(napi_env env, void *data)
{auto *asyncCallbackInfo = (AsyncCopyCallbackInfo *)data;// 执行实际的文件复制操作int retval = FileCopy(path, pathDst);asyncCallbackInfo->result = (retval == SUCCESS) ? SUCCESS : FAILED;
}// 4. 完成回调
void CopyComplete(napi_env env, napi_status status, void *data)
{auto *asyncCallbackInfo = (AsyncCopyCallbackInfo *)data;// 调用JavaScript回调函数CallBackSuccess(env, asyncCallbackInfo->callback[0], 0, nullptr);
}

3. 异步操作机制

文件访问接口采用统一的异步操作模式：

  1. 参数解析：从JavaScript参数中提取必要信息
  2. URI验证：验证文件路径的合法性
  3. 异步工作创建：使用napi_create_async_work创建后台任务
  4. 执行函数：在后台线程执行实际的文件操作
  5. 完成回调：将结果通过回调函数返回给JavaScript

技术特点

1. 多语言支持

  • JavaScript：主要应用接口
  • C/C++：系统级实现
  • Rust：高性能组件
  • TypeScript：类型安全

2. 异步非阻塞设计

  • 所有文件操作都在后台线程执行
  • 使用NAPI异步工作队列机制
  • 支持Promise和Callback两种模式

3. 统一的错误处理

  • 标准化的错误码定义
  • 详细的错误信息返回
  • 统一的回调机制

4. 高性能优化

  • 基于io_uring的高性能异步IO
  • 内存池管理
  • 智能指针使用

5. 安全机制

  • URI路径验证
  • 权限检查
  • 沙箱隔离

构建和部署

1. 构建配置

文件访问接口使用GN（Generate Ninja）构建：

# file_api.gni
file_api_path = "//foundation/filemanagement/file_api"
src_path = "${file_api_path}/interfaces/kits/js/src"
utils_path = "${file_api_path}/utils"declare_args() {file_api_read_optimize = falsefile_api_feature_hyperaio = false
}

2. 依赖关系

文件访问接口依赖多个系统组件：

  • ability_base：能力框架
  • bundle_framework：应用框架
  • hilog：日志系统
  • napi：Node-API支持
  • libuv：异步IO库
  • openssl：加密库

3. 系统能力

文件访问接口提供以下系统能力：

  • SystemCapability.FileManagement.File.FileIO
  • SystemCapability.FileManagement.File.Environment
  • SystemCapability.FileManagement.File.DistributedFile

性能优化策略

1. 内存管理

  • 使用智能指针避免内存泄漏
  • 及时释放NAPI引用
  • 实现内存池管理

2. 并发控制

  • 异步操作避免阻塞主线程
  • 支持多个文件操作并发执行
  • 使用线程池管理后台任务

3. 缓存机制

  • 文件状态信息缓存
  • 路径解析结果缓存
  • 权限检查结果缓存

测试和验证

1. 单元测试

文件访问接口包含完整的单元测试套件：

interfaces/test/unittest/
├── class_atomicfile/          # 原子文件测试
├── class_file/               # 文件操作测试
├── hyperaio/                 # 高性能IO测试
├── js/                       # JavaScript接口测试
├── remote_uri/               # 远程URI测试
└── task_signal/              # 任务信号测试

2. 集成测试

  • 跨模块功能测试
  • 性能压力测试
  • 兼容性测试

总结

OpenHarmony文件访问接口是一个设计精良、架构清晰的大型系统接口。它通过分层架构、模块化设计、多语言支持等技术手段，为OpenHarmony生态系统提供了强大而灵活的文件操作能力。

主要优势：

  1. 架构清晰：分层设计，职责明确
  2. 技术先进：基于NAPI和io_uring等现代技术
  3. 性能优异：异步非阻塞，支持高并发
  4. 安全可靠：完善的权限控制和错误处理
  5. 易于扩展：模块化设计，支持多语言

技术亮点：

  • 自研的LibN抽象层
  • 统一的异步编程模型
  • 高性能的io_uring集成
  • 完善的类型系统
  • 标准化的错误处理

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若转载，请注明出处：http://www.pswp.cn/diannao/98005.shtml
繁体地址，请注明出处：http://hk.pswp.cn/diannao/98005.shtml
英文地址，请注明出处：http://en.pswp.cn/diannao/98005.shtml

如若内容造成侵权/违法违规/事实不符，请联系英文站点网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

云手机运行是否消耗自身流量？

云手机运行是否消耗自身流量？

云手机运行是否消耗自身流量&#xff0c;取决于具体的使用场景和设置&#xff1a;若用户在连接云手机时&#xff0c;使用的是家中Wi-Fi、办公室局域网等非移动数据网络&#xff0c;那么在云手机运行过程中&#xff0c;基本不会消耗用户自身的移动数据流量&#xff0c;在家中连接…
阅读更多...
JavaSe之多线程

JavaSe之多线程

一、多线程基本了解 1、多线程基本知识 1.进程:进入到内存中执行的应用程序 2.线程:内存和CPU之间开通的通道->进程中的一个执行单元 3.线程作用:负责当前进程中程序的运行.一个进程中至少有一个线程,一个进程还可以有多个线程,这样的应用程序就称之为多线程程序 4.简单理解…
阅读更多...
产品月报｜睿本云8月产品功能迭代

产品月报｜睿本云8月产品功能迭代

睿本云8月更新已陆续上线&#xff01; 睿本云8月产品月报&#xff0c;点击查收&#x1f447;小程序支付成功弹窗广告、企业会员增加卡券销售和卡券退货模块、工厂端可批量新增多门店订货单、门店端和工厂端新增“极速订货”、商品调拨业务支持自定义多种流程配置等功能迭代更新…
阅读更多...
融云：当我们谈论 AI 重构业务时，我们到底在谈论什么

融云：当我们谈论 AI 重构业务时，我们到底在谈论什么

所有业务都值得用 AI 重新做一次。 这句话正在从一句鼓舞人心的口号&#xff0c;演变为一场无人可避的商业现实。AI 带来的结构性机会&#xff0c;意味着企业有机会从根本上重构成本、效率与体验的曲线。但这一切最终都要回到一个无比务实的问题上&#xff1a; AI 究竟如何在我…
阅读更多...
org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1异常

org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 1异常

org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length 1异常问题解决一、问题背景二、错误现象三、原因分析核心问题&#xff1a;字符集不匹配四、解决过程试错路径记录五、最终方案1.创建launch.json文件&#xff0c;修改VSCode…
阅读更多...
【C语言】深入理解指针（5）

【C语言】深入理解指针（5）

目录 sizeof和strlen 1.sizeof 2.strlen 3. sizeof 和 strlen 的对比 sizeof和strlen 1.sizeof sizeo正名&#xff1a;sizeof是操作符&#xff0c;不是函数&#xff0c;sizeof是操作符&#xff0c;括号内如果有计算不会进行计算sizeof 是操作符&#xff0c;用于计算变量所…
阅读更多...
动态代理设计模式

动态代理设计模式

JDK动态代理实现 动态代理利用了JDK API,动态地在内存中构建代理对象,从而实现对目标对象的代理功能.动态代理又被称为JDK代理或接口代理. 静态代理与动态代理的区别: 静态代理在编译时就已经实现了,编译完成后代理类是一个实际的class文 动态代理是在运行时动态生成的,即编译…
阅读更多...
《Html泛型魔法学院：用霍格沃茨风格网页教授集合框架》

《Html泛型魔法学院：用霍格沃茨风格网页教授集合框架》

一、项目概述 这个创意教学网页&#xff0c;将Java泛型与集合框架知识融入霍格沃茨魔法世界主题。通过沉浸式UI设计和交互式代码练习&#xff0c;让抽象的技术概念变得生动有趣。主要技术栈包括&#xff1a; HTML5语义化结构Tailwind CSS框架Font Awesome图标库纯JavaScript交…
阅读更多...
学习PaddlePaddle--环境配置-PyCharm + Conda​

学习PaddlePaddle--环境配置-PyCharm + Conda​

第一阶段&#xff1a;安装与配置 Python 和 Conda​​ 虽然 PyCharm 可以管理环境&#xff0c;但我们先独立准备好 Conda 环境&#xff0c;这样更清晰可靠。 ​​1. 安装 Miniconda (Python 环境管理)​​ 1. ​​下载​​&#xff1a; • 访问 Miniconda 官网。 • 选择 ​​M…
阅读更多...
【数据库】Sql Server数据库中isnull、iif、case when三种方式的使用和空值判断

【数据库】Sql Server数据库中isnull、iif、case when三种方式的使用和空值判断

大家好&#xff0c;我是全栈小5&#xff0c;欢迎来到《小5讲堂》。 这是《Sql Server》系列文章&#xff0c;每篇文章将以博主理解的角度展开讲解。 温馨提示&#xff1a;博主能力有限&#xff0c;理解水平有限&#xff0c;若有不对之处望指正&#xff01; 目录前言ISNULL用法c…
阅读更多...
【蓝桥杯选拔赛真题64】C++最大空白区 第十四届蓝桥杯青少年创意编程大赛 算法思维 C++编程选拔赛真题解

【蓝桥杯选拔赛真题64】C++最大空白区 第十四届蓝桥杯青少年创意编程大赛 算法思维 C++编程选拔赛真题解

C++最大空白区 第十四届蓝桥杯青少年创意编程大赛C++选拔赛真题 博主推荐 所有考级比赛学习相关资料合集【推荐收藏】 1、C++专栏 电子学会C++一级历年真题解析 电子学会C++二级历年真题解析
阅读更多...
试用Augment编写python脚本实现智能家居3D环境交互响应

试用Augment编写python脚本实现智能家居3D环境交互响应

环境配置 VS Code中直接安装Augment扩展&#xff0c;然后邮箱登录就能获得7天的试用。 从如下位置安装3D建模软件Blender&#xff1a; https://www.blendercn.org/downloadme#xiazai Blender 是一款免费开源的 3D 创作套件。它支持整个三维流程&#xff1a;建模、绑定、动画…
阅读更多...
【架构师干货】系统架构设计

【架构师干货】系统架构设计

1. 软件架构概述 从需求分析到软件设计之间的过渡过程称为软件架构。只要软件架构设计好了&#xff0c;整个软件就不会出现坍塌性的错误&#xff0c;即不会崩溃。 架构设计就是需求分配&#xff0c;将满足需求的职责分配到组件上。 软件架构为软件系统提供了一个结构、行为和属…
阅读更多...
Java设计模式之结构型—享元模式

Java设计模式之结构型—享元模式

Java中最常用的设计模式-CSDN博客 把“不可变且可复用”的细粒度对象缓存起来&#xff0c;用“共享”代替“新建”&#xff0c;从而节省内存。 经典场景 字符串常量池、Integer.valueOf(-128~127)、Android Message.obtain() 游戏粒子、编辑器字形、地图瓦片、线程池中的任务…
阅读更多...
cursor+python轻松实现电脑监控

cursor+python轻松实现电脑监控

小伙伴们&#xff0c;今天我们利用cursor不写一行代码开发一个电脑的系统状态监控小应用&#xff01;下载安装cursor&#xff1a;网址&#xff1a;https://www.cursor.com/cn下载后双击安装输入提示词&#xff1a; 制作一个winswos应用&#xff0c;实现显示时间精确到秒&…
阅读更多...
信号调制与解调 matlab仿真

信号调制与解调 matlab仿真

信号调制与解调 matlab仿真 原始信号--频谱为cos(Wt*w)函数&#xff0c;外形如馒头调制解调傅里叶变换测试FT的频谱是否为锯齿波理想低通滤波器,截至频率Wm傅里叶变换频谱为锯齿波函数的时域信号函数傅里叶变换调制频率1理想低通滤波调制频率2理想低通滤波 % 调制定理演示Dem…
阅读更多...
IIS服务器下做浏览器缓存

IIS服务器下做浏览器缓存

你的这个问题问得非常好&#xff0c;很多开发者在同时使用重写和缓存时都会遇到。简单来说&#xff1a;你添加的 <staticContent> 和 <clientCache> 配置本身不会影响或干扰 重写规则的工作。它们各司其职&#xff0c;在 IIS 处理请求的不同阶段发挥作用。 但是&a…
阅读更多...
Flutter 3.35.2 以上版本中 数字转字符串的方法指南

Flutter 3.35.2 以上版本中 数字转字符串的方法指南

在 Flutter 3.35.2 (对应 Dart 2.19 及以上版本) 中&#xff0c;将数字转换为字符串主要依赖于 Dart 语言本身提供的原生方法。这些方法稳定且向后兼容。下面我为你介绍几种主要的方法和案例。 &#x1f522; 数字转字符串的基本方法方法名适用类型描述常用场景toString()int, …
阅读更多...
C#基础（⑤ProcessStartInfo类和Process类）

C#基础（⑤ProcessStartInfo类和Process类）

1. 它是什么&#xff1f;ProcessStartInfo 是 C# 里的一个类&#xff08;属于 System.Diagnostics 命名空间&#xff09;&#xff0c;作用是&#xff1a;定义要启动的程序路径&#xff08;比如 notepad.exe&#xff09;设置启动时的参数&#xff08;比如打开哪个文件&#xff0…
阅读更多...
《设计模式之禅》笔记摘录 - 19.备忘录模式

《设计模式之禅》笔记摘录 - 19.备忘录模式

备忘录模式的定义备忘录模式(Memento Pattern)提供了一种弥补真实世界缺陷的方法&#xff0c;让“后悔药”在程界序的世界中真实可行&#xff0c;其定义如下&#xff1a;Without violating encapsulation, capture and externalize an objects internal state so that the obje…
阅读更多...
最新文章

Copyright @ 2022~2023