HarmonyOS学习第16天：数据存储秘籍让应用数据稳稳“安家”

一、HarmonyOS 数据存储初印象

在 HarmonyOS 应用开发的广阔天地里，数据存储就像是应用的 “记忆仓库”，发挥着举足轻重的作用。无论是用户的个性化设置、应用产生的关键数据，还是从网络获取的信息，都需要可靠的数据存储方式来进行妥善保存和高效管理，从而确保应用在不同场景下都能稳定运行，为用户带来无缝且一致的体验。例如，一款音乐播放应用，它需要存储用户的播放历史、收藏的歌曲列表以及个性化的播放设置等信息，以便在用户下次打开应用时能够快速恢复到之前的状态，提供更加便捷的服务。

HarmonyOS 为开发者精心打造了一套丰富且强大的数据存储体系，涵盖了文件存储、SharedPreferences 存储、数据库存储（如 SQLite）等多种方式 ，每种存储方式都有其独特的优势和适用场景，就像工具箱里不同功能的工具，开发者可以根据具体的需求来灵活选择，从而为应用构建出最适合的数据存储解决方案。

二、文件存储：数据的 “保险箱”

（一）存储原理揭秘

文件存储是 HarmonyOS 中一种基础且常用的数据存储方式，它就像是一个 “保险箱”，将数据以文件的形式存储在本地设备中。无论是文本文件、二进制文件，还是各种多媒体文件，都能在这个 “保险箱” 中找到自己的位置。当应用需要存储数据时，会在设备的存储介质上创建一个对应的文件，并将数据按照特定的格式写入其中；而在读取数据时，则是从文件中读取相应的内容，并根据数据格式进行解析和处理 。

文件存储不仅为数据提供了物理级别的安全保护，确保数据不会轻易丢失或被非法访问，还通过合理的文件组织结构和访问机制，实现了数据的快速访问。就像在一个大型图书馆中，通过分类编号和索引系统，能够快速找到所需的书籍一样，文件存储通过文件路径和文件名等信息，能够高效地定位和读取数据，为应用的高效运行提供了有力支持。

（二）读写操作实战

在 HarmonyOS 中，进行文件的读写操作并不复杂，下面为大家详细介绍具体的操作步骤和实际代码示例：

1. 创建文件：

在创建文件时，首先需要获取应用的上下文对象，通过上下文对象获取文件路径，然后使用文件系统相关的 API 来创建文件。例如，在基于 ArkTS 开发的应用中，可以使用以下代码创建一个文件：

import fs from '@ohos.file.fs'; import common from '@ohos.app.ability.common'; // 获取应用文件路径 let context = getContext(this) as common.UIAbilityContext; let filesDir = context.filesDir; let filePath = filesDir + '/test.txt'; async function createFile() {     try {         let file = await fs.open(filePath, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);         file.close();         console.log('文件创建成功');     } catch (error) {         console.error('文件创建失败:', error);     } }

在上述代码中，首先通过getContext方法获取应用的上下文对象，然后从上下文对象中获取filesDir目录，这是应用的文件存储目录。接着，拼接出要创建的文件路径filePath，最后使用fs.open方法打开文件，如果文件不存在则创建它，并传入fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE标志表示以读写模式创建文件。创建完成后，关闭文件。

2. 写入文件：

文件创建好后，就可以向其中写入数据了。写入数据时，同样需要先打开文件，然后使用fs.write方法将数据写入文件中。以下是一个写入文件的示例代码：

async function writeFile() {     let file = await fs.open(filePath, fs.OpenMode.READ_WRITE);     let data = '这是要写入文件的内容';     await fs.write(file.fd, data);     file.close();     console.log('数据写入成功'); }

在这个示例中，先以读写模式打开之前创建的文件，然后定义要写入的数据data，接着使用fs.write方法将数据写入文件，最后关闭文件并提示数据写入成功。

3. 读取文件：

读取文件的操作与写入类似，先打开文件，然后使用fs.read方法读取文件内容。示例代码如下：

async function readFile() {     try {         let file = await fs.open(filePath, fs.OpenMode.READ_ONLY);         let stat = await fs.stat(filePath);         let buffer = new ArrayBuffer(stat.size);         await fs.read(file.fd, buffer);         let content = String.fromCharCode.apply(null, new Uint8Array(buffer));         file.close();         console.log('文件内容:', content);         return content;     } catch (error) {         console.error('文件读取失败:', error);     } }

在这段代码中，首先以只读模式打开文件，通过fs.stat方法获取文件的状态信息，包括文件大小等。根据文件大小创建一个ArrayBuffer缓冲区，用于存储读取的数据。然后使用fs.read方法将文件内容读取到缓冲区中，最后通过String.fromCharCode.apply(null, new Uint8Array(buffer))将缓冲区中的数据转换为字符串并返回。

4. 关闭文件：

在完成文件的读写操作后，一定要记得关闭文件，以释放系统资源。如上述代码中，在每次操作完成后，都通过file.close()方法关闭文件。如果不关闭文件，可能会导致文件资源被占用，影响应用的性能和稳定性，甚至可能导致数据丢失。

（三）应用场景聚焦

文件存储在 HarmonyOS 应用开发中有着广泛的应用场景，以下是一些常见的场景：

1. 存储图片、音频、视频等大文件：

对于图片、音频、视频等大文件，文件存储是一种非常合适的存储方式。例如，一款拍照应用在拍摄照片后，会将照片以文件的形式存储在设备中；音乐播放应用则会将下载的音乐文件存储起来，方便用户随时离线播放。以存储图片为例，应用可以在用户拍摄照片后，将照片数据直接写入到文件中，并按照一定的命名规则和目录结构进行存储，以便后续的访问和管理。

2. 存储应用配置文件：

应用的配置文件通常包含一些应用的基本设置、用户的个性化配置等信息，这些信息可以以文件的形式进行存储。例如，一个游戏应用可能会将用户的游戏难度设置、音效开关等配置信息存储在一个配置文件中。在应用启动时，读取该配置文件，根据用户的配置来初始化应用的相关设置，为用户提供个性化的体验。

三、SharedPreferences 存储：轻量级数据的 “贴心管家”

（一）独特优势剖析

SharedPreferences 是一种轻量级的数据存储方式，就像是一位贴心的 “管家”，专门负责管理应用中的少量简单数据 。它以键值对的形式存储数据，就像给每个数据都贴上了一个独特的 “标签”，方便快速查找和访问。例如，当我们需要保存用户的设置信息时，就可以将设置项作为键，对应的设置值作为值，存储到 SharedPreferences 中 。

这种存储方式特别适合保存应用设置、用户偏好等数据，因为它操作简单、高效，而且易于管理。比如，一个阅读应用可以使用 SharedPreferences 来保存用户的字体大小、阅读主题等偏好设置，当用户下次打开应用时，能够直接加载这些设置，为用户提供个性化的阅读体验。

（二）操作流程详解

在 HarmonyOS 中使用 SharedPreferences 进行数据存储和读取，主要包括以下几个步骤：

1. 获取上下文：

首先，需要获取应用的上下文对象，这是操作 SharedPreferences 的基础。在 HarmonyOS 中，可以通过getContext(this)方法获取上下文对象，其中this表示当前的组件或页面。

2. 获取存储路径：

通过上下文对象获取 SharedPreferences 的存储路径。例如，可以使用context.getPreferencesDir()方法获取偏好设置目录，这个目录用于存储 SharedPreferences 文件。

3. 创建存储对象：

使用PreferenceManager.getInstance().getPreferences(name)方法创建 SharedPreferences 对象，其中name是自定义的存储文件名，通过这个名字可以唯一标识一个 SharedPreferences 文件。例如：

import preferences from '@ohos.data.preferences'; let context = getContext(this); let preferencesManager = preferences.PreferencesManager.getInstance(); let sharedPreferences = preferencesManager.getPreferences('my_settings');

在上述代码中，首先获取上下文对象context，然后通过PreferencesManager的单例实例获取Preferences对象，命名为my_settings。

4. 数据写入：

创建好 SharedPreferences 对象后，就可以进行数据写入操作了。通过调用edit()方法获取Editor对象，使用put系列方法存储数据，最后调用commit()或apply()方法提交保存。例如：

let editor = sharedPreferences.edit(); editor.putString('username', 'John'); editor.putInt('age', 30); editor.commit();

在这段代码中，先获取Editor对象editor，然后使用putString方法存储字符串类型的用户名，使用putInt方法存储整型的年龄，最后调用commit方法提交保存数据。commit方法会立即将数据写入磁盘，而apply方法则是异步写入，不会阻塞主线程，在大多数情况下，apply方法更适合用于数据写入操作。

5. 数据读取：

读取数据时，直接使用 SharedPreferences 对象的get系列方法，根据键获取对应的值，并可以指定默认值。例如：

let username = sharedPreferences.getString('username', ''); let age = sharedPreferences.getInt('age', 0);

这里通过getString方法读取用户名，如果没有找到对应的键，则返回默认值''；通过getInt方法读取年龄，如果没有找到对应键，则返回默认值0。

（三）实际应用案例

SharedPreferences 在实际应用中有着广泛的应用，以下是一些常见的案例：

1. 存储用户登录状态：

在一个社交应用中，当用户登录成功后，可以使用 SharedPreferences 存储用户的登录状态。例如：

let editor = sharedPreferences.edit(); editor.putBoolean('isLoggedIn', true); editor.commit();

在应用每次启动时，可以读取这个值来判断用户是否已经登录：

let isLoggedIn = sharedPreferences.getBoolean('isLoggedIn', false); if (isLoggedIn) {     // 已登录，直接进入主界面 } else {     // 未登录，跳转到登录界面 }

通过这种方式，能够为用户提供更加便捷的登录体验，避免用户每次打开应用都需要重新登录。

2. 存储主题设置：

对于支持主题切换的应用，如一款音乐播放应用，用户可以选择自己喜欢的主题，如深色主题或浅色主题。应用可以使用 SharedPreferences 存储用户选择的主题：

let editor = sharedPreferences.edit(); editor.putString('theme', 'dark'); // 假设用户选择了深色主题 editor.commit();

在应用界面加载时，读取这个主题设置，并根据设置来切换界面的颜色和样式：

let theme = sharedPreferences.getString('theme', 'light'); if (theme === 'dark') {     // 应用深色主题样式 } else {     // 应用浅色主题样式 }

这样，用户下次打开应用时，仍然能够看到自己喜欢的主题风格，提升了用户的使用体验和满意度。

四、数据库存储（SQLite）：结构化数据的 “强大后盾”

（一）SQLite 在 HarmonyOS 中的角色

SQLite 作为一款轻量级的关系型数据库管理系统，在 HarmonyOS 应用开发中扮演着 “强大后盾” 的角色，尤其是在存储大量结构化数据时，展现出了卓越的优势 。它的设计理念是小巧、高效且自给自足，无需独立的服务器进程，数据库以文件形式存储在设备上，这使得它非常适合在资源受限的移动设备和嵌入式系统中使用。

SQLite 支持标准的 SQL 语言，这为开发者提供了强大的数据操作能力。通过 SQL 语句，开发者可以灵活地定义数据库的表结构、进行数据的插入、查询、更新和删除等操作 。例如，在一个电商应用中，商品信息、订单数据、用户信息等都可以以结构化的方式存储在 SQLite 数据库中，通过合理的表结构设计和 SQL 查询语句，能够高效地管理和检索这些数据。

（二）数据库操作全攻略

在 HarmonyOS 中使用 SQLite 进行数据库操作，主要包括以下几个关键步骤和操作方法：

1. 数据库创建：

在 HarmonyOS 中创建 SQLite 数据库，可以使用DatabaseHelper类来实现。首先，需要定义数据库的名称和版本号，然后通过DatabaseHelper的getRdbStore方法来获取数据库实例。如果数据库不存在，则会自动创建。示例代码如下：

import ohos.data.database.DatabaseHelper; import ohos.data.database.DatabaseConfig; import ohos.data.database.DataAbilityHelper; import ohos.data.rdb.RdbStore; public class DatabaseManager {     private static final String DATABASE_NAME = "my_database.db";     private static final int DATABASE_VERSION = 1;     private DataAbilityHelper dataAbilityHelper;     private RdbStore rdbStore;     public DatabaseManager(DataAbilityHelper dataAbilityHelper) {         this.dataAbilityHelper = dataAbilityHelper;         createDatabase();     }     private void createDatabase() {         DatabaseConfig config = new DatabaseConfig(DATABASE_NAME, DatabaseHelper.CREATE_IF_NECESSARY);         DatabaseHelper databaseHelper = new DatabaseHelper(config);         rdbStore = databaseHelper.getRdbStore(dataAbilityHelper.getContext(), DATABASE_NAME, DATABASE_VERSION, null);     } }

在上述代码中，首先定义了数据库的名称DATABASE_NAME和版本号DATABASE_VERSION，然后在createDatabase方法中，通过DatabaseConfig配置数据库的创建参数，使用DatabaseHelper创建数据库，并通过getRdbStore方法获取数据库实例rdbStore。

2. 表结构定义：

创建好数据库后，就需要定义表结构了。可以使用 SQL 语句来创建表，指定表名、列名、列的数据类型以及主键等约束条件。例如，创建一个存储用户信息的表users：

private void createUserTable() {     String createTableSQL = "CREATE TABLE IF NOT EXISTS users (" +             "id INTEGER PRIMARY KEY AUTOINCREMENT," +             "username TEXT," +             "password TEXT," +             "email TEXT)";     rdbStore.executeSql(createTableSQL); }

在这段代码中，使用CREATE TABLE语句创建了一个名为users的表，包含id（主键，自增长）、username（文本类型）、password（文本类型）和email（文本类型）四个列。

3. 数据插入：

插入数据可以使用ValuesBucket类来封装要插入的数据，然后通过rdbStore的insert方法将数据插入到表中。示例如下：

public void insertUser(String username, String password, String email) {     ValuesBucket valuesBucket = new ValuesBucket();     valuesBucket.putString("username", username);     valuesBucket.putString("password", password);     valuesBucket.putString("email", email);     rdbStore.insert("users", valuesBucket); }

在这个示例中，创建了一个ValuesBucket对象，将用户的username、password和email数据放入其中，然后使用rdbStore的insert方法将数据插入到users表中。

4. 数据查询：

查询数据可以使用rdbStore的query方法，通过编写 SQL 查询语句来获取所需的数据。例如，查询所有用户的信息：

public void queryUsers() {     String querySQL = "SELECT * FROM users";     ResultSet resultSet = rdbStore.query(querySQL, null);     while (resultSet.goToNextRow()) {         int id = resultSet.getInt(resultSet.getColumnIndexForName("id"));         String username = resultSet.getString(resultSet.getColumnIndexForName("username"));         String password = resultSet.getString(resultSet.getColumnIndexForName("password"));         String email = resultSet.getString(resultSet.getColumnIndexForName("email"));         System.out.println("User ID: " + id + ", Username: " + username + ", Password: " + password + ", Email: " + email);     }     resultSet.close(); }

在上述代码中，使用SELECT * FROM users查询语句获取users表中的所有数据，通过ResultSet遍历查询结果，并获取每一行数据的各个列的值。

5. 数据更新：

更新数据需要使用ValuesBucket封装更新后的数据，同时使用RdbPredicates指定更新条件，然后通过rdbStore的update方法进行更新。例如，更新用户的密码：

public void updateUserPassword(int id, String newPassword) {     ValuesBucket valuesBucket = new ValuesBucket();     valuesBucket.putString("password", newPassword);     RdbPredicates predicates = new RdbPredicates("users").equalTo("id", String.valueOf(id));     rdbStore.update(valuesBucket, predicates); }

在这个示例中，创建了一个ValuesBucket对象，放入新的密码值，使用RdbPredicates指定更新条件为id等于指定值，最后通过update方法更新users表中的数据。

6. 数据删除：

删除数据同样使用RdbPredicates指定删除条件，然后通过rdbStore的delete方法进行删除。例如，删除指定id的用户：

public void deleteUser(int id) {     RdbPredicates predicates = new RdbPredicates("users").equalTo("id", String.valueOf(id));     rdbStore.delete(predicates); }

在这段代码中，使用RdbPredicates指定删除条件为id等于指定值，然后通过delete方法删除users表中符合条件的数据。

（三）复杂数据管理场景应用

SQLite 在复杂数据管理场景中有着广泛的应用，以电商应用为例，它需要存储大量的商品信息、订单数据以及用户信息等，这些数据之间存在着复杂的关联关系，而 SQLite 能够很好地应对这种挑战 。

在商品信息管理方面，电商应用可以创建一个products表，用于存储商品的详细信息，如商品 ID、名称、价格、库存数量、描述、图片路径等。通过合理的表结构设计和索引优化，可以快速地查询和更新商品信息。例如，当用户在商品列表页面浏览商品时，应用可以通过 SQL 查询语句从products表中获取商品的基本信息，并展示给用户；当商品的库存数量发生变化时，应用可以及时更新products表中的库存字段。

在订单数据管理方面，电商应用可以创建一个orders表，用于存储订单的相关信息，如订单 ID、用户 ID、订单日期、订单状态、总金额等，同时创建一个order_items表，用于存储订单中包含的商品信息，如订单项 ID、订单 ID、商品 ID、商品数量等。通过这种方式，可以建立起订单与商品之间的关联关系。例如，当用户下单购买商品时，应用会在orders表中插入一条新的订单记录，并在order_items表中插入相应的订单项记录；当用户查询订单详情时，应用可以通过关联查询从这两个表中获取订单和商品的详细信息。

通过这些表结构的设计和 SQL 操作，电商应用能够高效地管理和处理复杂的数据，为用户提供稳定、可靠的服务。SQLite 的事务处理机制还能够确保数据的一致性和完整性，例如在订单处理过程中，当涉及到多个数据的更新操作时，可以将这些操作放在一个事务中执行，如果其中任何一个操作失败，整个事务将回滚，从而保证数据的正确性。

五、数据管理的 “智慧之道”

在 HarmonyOS 应用开发中，数据存储只是第一步，如何对存储的数据进行有效的管理同样至关重要。数据管理涵盖了数据的安全保障、高效维护以及迁移与备份等多个方面，下面为大家详细介绍。

（一）数据的安全保障

HarmonyOS 深知数据安全的重要性，通过一系列强大的措施来保障数据的安全，防止数据泄露和非法访问。在权限控制方面，HarmonyOS 采用了精细的权限管理机制 ，应用在访问敏感数据时，必须先向用户请求相应的权限，只有在用户授权后才能进行访问。例如，当应用需要读取用户的联系人信息时，会弹出权限请求对话框，用户可以选择允许或拒绝。这种方式确保了用户对自己数据的控制权，有效防止了应用滥用权限获取用户隐私数据。

数据加密也是 HarmonyOS 保障数据安全的重要手段之一。对于一些敏感数据，如用户的登录密码、支付信息等，HarmonyOS 会在数据存储和传输过程中进行加密处理 。在存储时，使用强大的加密算法将数据转换为密文，只有拥有正确密钥的应用才能解密并读取数据；在传输时，采用安全的传输协议，如 HTTPS，对数据进行加密传输，防止数据在传输过程中被窃取或篡改。例如，在一个金融应用中，用户的交易数据在存储到本地数据库时会被加密，当数据需要传输到服务器进行处理时，也会通过加密通道进行传输，确保了数据的安全性和保密性。

（二）数据的高效维护

为了提高数据存储的效率，HarmonyOS 提供了一系列数据维护的方法和策略。定期清理数据库是保持数据高效存储的重要措施之一。随着应用的使用，数据库中可能会积累大量的无用数据或过期数据，这些数据不仅占用存储空间，还会影响数据库的查询性能。因此，开发者可以定期清理数据库中的冗余数据，如删除已过期的订单数据、清理临时表等 。在一个电商应用中，当订单完成一段时间后，相关的订单数据可能不再需要频繁访问，此时就可以将这些数据从数据库中删除，以释放存储空间，提高数据库的整体性能。

优化数据库结构也是提高数据存储效率的关键。合理设计数据库的表结构、索引等，可以减少数据的冗余，提高数据的查询速度。例如，在设计表结构时，遵循数据库的范式原则，避免数据的重复存储；在创建索引时，根据查询需求选择合适的字段创建索引，以加快数据的检索速度 。在一个新闻应用中，为了快速查询用户感兴趣的新闻内容，可以在新闻标题、发布时间等字段上创建索引，这样在用户进行搜索或浏览新闻列表时，能够更快地获取到相关数据。

对于文件存储，合理管理文件的存储路径和命名规范也非常重要。通过建立清晰的文件目录结构，按照文件的类型、用途等进行分类存储，可以方便文件的查找和管理。例如，在一个图片编辑应用中，可以将用户编辑后的图片存储在特定的目录下，并按照一定的命名规则进行命名，如使用时间戳加上图片编号的方式命名，这样在需要查找某张图片时，能够快速定位到文件的位置。

（三）数据的迁移与备份

在应用升级或设备更换时，数据的迁移和备份是确保数据完整性和可用性的关键环节。HarmonyOS 为开发者提供了便捷的数据迁移和备份机制，帮助开发者轻松实现数据的迁移和备份操作。

在应用升级时，开发者可以利用 HarmonyOS 的数据迁移框架，将旧版本应用中的数据迁移到新版本应用中 。该框架会自动处理数据的备份、恢复和迁移过程，确保数据的一致性和完整性。例如，当一个社交应用进行版本升级时，用户的聊天记录、好友列表等数据可以通过数据迁移框架无缝迁移到新版本应用中，用户在升级应用后仍然能够正常使用这些数据，不会因为版本升级而丢失数据。

当用户更换设备时，HarmonyOS 支持通过云服务或本地备份等方式进行数据迁移 。用户可以将旧设备中的数据备份到云服务中，然后在新设备上登录相同的账号，从云服务中恢复数据；也可以通过本地备份的方式，将旧设备的数据备份到外部存储设备中，然后将外部存储设备连接到新设备，将数据恢复到新设备中。例如，在一个音乐播放应用中，用户更换设备后，可以通过云服务将自己收藏的歌曲列表、播放历史等数据迁移到新设备上，继续享受个性化的音乐播放体验。

六、总结与展望

HarmonyOS 提供的文件存储、SharedPreferences 存储以及 SQLite 数据库存储等多种数据存储方式，为开发者在不同的应用场景下进行数据持久化提供了丰富的选择。文件存储适用于存储大文件和各种类型的文件数据，其操作简单直接；SharedPreferences 存储则擅长管理轻量级的键值对数据，方便快捷；SQLite 数据库存储在处理大量结构化数据和复杂数据关系时表现出色，为应用提供了强大的数据管理能力。

在实际应用开发中，我们需要根据数据的特点和应用的需求，灵活选择合适的数据存储方式，并掌握其数据读写操作和管理技巧，以确保应用的数据能够得到妥善的存储和高效的利用。同时，要注重数据的安全保障、维护以及迁移备份等工作，提升应用的稳定性和用户体验。

展望未来，随着技术的不断发展，数据存储技术也将迎来新的变革和突破。例如，云存储技术将继续发展，为用户提供更便捷、高效、安全的存储服务；边缘计算的兴起，将使得数据处理和存储更加接近数据源，提高数据的处理速度和响应效率；量子存储等新兴技术也展现出了巨大的潜力，有望在未来实现更高的数据密度和更快的读取速度。作为开发者，我们要密切关注这些技术发展趋势，不断学习和探索新的技术和方法，为 HarmonyOS 应用开发带来更多的创新和可能性。

希望本文能为大家在 HarmonyOS 数据存储与管理方面提供有益的帮助，鼓励大家深入学习和实践，在 HarmonyOS 应用开发的道路上不断前行，创造出更多优秀的应用！