一、引言
在鸿蒙开发的过程中，资源管理是一个至关重要的环节。RawFile 作为鸿蒙系统中用于管理原始资源文件的重要机制，为开发者提供了便捷的文件操作方式。本文将详细介绍 RawFile 的相关特性，并结合代码示例展示其在实际开发中的应用。
二、RawFile 概述
RawFile 主要用于存放原始资源文件，这些文件不会经过编译处理，而是以原始形式存在并被应用程序使用。这种特性使得 RawFile 在处理一些特定类型的资源时具有独特的优势。
（一）可存放的文件类型
- 音频和视频文件：例如游戏中的背景音乐、音效，或者应用中的视频教程等。这些文件以原始的音频和视频编码格式存放在 RawFile 中，应用程序可以直接读取并播放。
- 图片资源：像应用的启动画面、特定场景的背景图片等非矢量图，以常见的图片格式（如.png、.jpg、.bmp 等）存于 RawFile 中，方便应用程序加载和显示。
- 文本文件：包括各种配置文件、说明文档、许可证文件等（比如各类a.json文件）。应用程序可以在启动时读取配置文件来获取初始参数或开关设置。
- 字体文件：如果应用需要使用特殊字体，可以将字体文件（如.ttf、.otf 格式）放置在 RawFile 中，然后在应用中加载并应用到相应的文本显示上。
（二）特性优势
- 保持原始格式：RawFile 中的文件不会被编译器进行额外的处理或转换，这保证了文件能够按照其原本的特性被应用程序读取和使用。例如，音频文件可以直接被音频播放库按照其原始编码格式进行解码播放。
- 方便资源管理：将原始资源文件集中存放在 RawFile 文件夹中，有助于对应用的资源进行统一管理和组织。开发人员可以清晰地知道哪些文件是原始资源，方便在开发过程中进行查找、替换和更新等操作。
三、RawFile 的功能特性
RawFile 提供了一系列操作 RawFile 目录和文件的功能，包括遍历、打开、搜索、读取和关闭。不过需要注意的是，RawFile 是非线程安全的，但 close 和 open 相关接口是线程安全的。
（一）遍历
遍历功能允许开发人员在 RawFile 目录下逐个访问其中的文件和子目录。这在需要批量处理资源文件时非常有用，例如一个多媒体应用可能需要遍历 RawFile 目录下所有的音频文件，以便展示音频列表。
（二）打开
打开操作是获取对 RawFile 文件访问权限的第一步。只有成功打开文件后，才能对其进行读取等后续操作。
（三）搜索
搜索功能可以在 RawFile 目录或文件内容中查找符合特定条件的文件或信息。比如，搜索所有扩展名为.mp3 的音频文件。
（四）读取
读取操作用于从已打开的 RawFile 文件中获取数据内容。例如，读取文本文件的文本内容、读取图片文件的二进制数据等。
（五）关闭
关闭操作的作用是释放对已打开的 RawFile 文件的访问权限，防止资源泄漏。
四、代码示例
以下是一个简单的代码示例，展示了如何在鸿蒙开发中使用 RawFile 获取文件内容：
import { BusinessError } from '@kit.BasicServicesKit';
async function getCityData() {
try {
// 异步获取 city.json 文件(假设是数组文件)的内容
const value = await getContext(this).resourceManager.getRawFileContent('city.json');
// 创建一个 UTF - 8 解码器
let textDecode = util.TextDecoder.create('utf-8')
// 将 Uint8Array 类型的文件内容解码为字符串
let cData = textDecode.decodeToString(value);
// 解析 JSON 数据并赋值给 cityList
this.cityList = JSON.parse(cData) as ArticleModel[];
console.log('city.json 文件内容获取并解析成功');
} catch (error) {
if (error instanceof BusinessError) {
const code = error.code;
const message = error.message;
console.error(`getRawFileContent failed, error code: ${code}, message: ${message}.`);
} else {
console.error('Unexpected error:', error);
}
}
}
// 调用异步函数
this.getCityData();
代码解释
-
导入错误处理类：
import { BusinessError } from '@kit.BasicServicesKit';导入了用于处理业务错误的BusinessError类。 -
异步获取文件内容：使用
await关键字异步获取city.json文件的内容，返回的是Uint8Array类型。 -
解码文件内容：创建
TextDecoder对象，将Uint8Array类型的文件内容解码为字符串。 -
解析 JSON 数据：使用
JSON.parse方法将解码后的字符串解析为 JavaScript 对象，并将其强制转换为ArticleModel类型的数组赋值给this.cityList。 - 错误处理：捕获可能出现的错误，并根据错误类型输出相应的错误信息。
五、总结
RawFile 在鸿蒙开发中扮演着重要的角色，它为开发者提供了一种方便、高效的方式来管理和使用原始资源文件。通过了解 RawFile 的功能特性和使用方法，开发者可以更好地利用这一机制，提升应用程序的开发效率和资源管理能力。同时，在使用过程中要注意其线程安全问题，合理处理文件操作，避免出现数据不一致或资源泄漏等问题。
