在鴻蒙（HarmonyOS）應用開發中，數據存儲是構建功能完整、用戶體驗良好的應用程序的關鍵環節。鴻蒙系統提供了多種數據存儲解決方案，其中SQLite數據庫和Preferences（偏好設置）是最常用的兩種方式。本文將深入探討這兩種存儲技術的使用場景、實現方法以及最佳實踐，幫助開發者根據應用需求選擇最合適的存儲方案。

一、數據存儲概述

在移動應用開發中，數據存儲通常分為以下幾種類型：

1. 輕量級鍵值存儲：如Preferences，適合存儲簡單的配置信息

2. 結構化數據存儲：如SQLite，適合存儲復雜的關系型數據

3. 文件存儲：適合存儲大容量非結構化數據

4. 云存儲：用于需要跨設備同步的數據

鴻蒙系統為開發者提供了全面的數據存儲API，其中Preferences和SQLite因其易用性和高效性成為最常用的本地存儲方案。

二、Preferences（偏好設置）詳解

2.1 Preferences簡介

Preferences是鴻蒙提供的一種輕量級數據存儲解決方案，它以鍵值對的形式存儲數據，適用于保存用戶偏好設置、應用配置信息等小規模數據。

核心特點：

• 采用XML文件格式存儲

• 線程安全

• 支持基本數據類型（String、int、boolean等）

• 數據量不宜過大（建議不超過1MB）

2.2 Preferences實現方法

2.2.1 初始化Preferences

import ohos.data.preferences.Preferences;// 獲取Preferences實例
// 參數1：上下文對象
// 參數2：存儲文件名（無需后綴）
Preferences preferences = PreferencesHelper.getPreferences(context, "user_settings");

2.2.2 數據存取操作

存儲數據：

// 存儲不同類型的數據
preferences.putString("username", "鴻蒙開發者");
preferences.putInt("login_count", 5);
preferences.putBoolean("is_first_launch", false);
preferences.putFloat("font_size", 16.0f);
preferences.putLong("last_login_time", System.currentTimeMillis());// 提交保存（同步寫入磁盤）
preferences.flush();

讀取數據：

// 讀取數據（第二個參數為默認值）
String username = preferences.getString("username", "");
int loginCount = preferences.getInt("login_count", 0);
boolean isFirstLaunch = preferences.getBoolean("is_first_launch", true);
float fontSize = preferences.getFloat("font_size", 14.0f);
long lastLoginTime = preferences.getLong("last_login_time", 0L);

刪除數據：

// 刪除單個鍵值
preferences.delete("username");// 清空所有數據
preferences.clear();

2.3 Preferences最佳實踐

1. 合理組織鍵名：使用有意義的命名，如"user_pref_theme_color"而非簡單的"color"

2. 避免存儲大對象：不適合存儲圖片、大文本等數據

3. 及時flush：重要數據操作后立即調用flush()確保數據持久化

4. 分組管理：不同模塊的配置使用不同的Preferences文件

5. 加密敏感數據：對于密碼等敏感信息應先加密再存儲

三、SQLite數據庫詳解

3.1 SQLite簡介

SQLite是鴻蒙內置的輕量級關系型數據庫，具有以下特點：

• 無需服務器，零配置

• 支持標準SQL語法

• 支持事務處理

• 單文件存儲

• 適合存儲結構化數據

3.2 SQLite實現方法

3.2.1 創建數據庫幫助類

import ohos.data.rdb.*;public class UserDBHelper extends RdbOpenHelper {private static final String DB_NAME = "user_db";private static final int DB_VERSION = 2;// 用戶表SQLprivate static final String CREATE_TABLE_USER = "CREATE TABLE IF NOT EXISTS user (" +"id INTEGER PRIMARY KEY AUTOINCREMENT, " +"name TEXT NOT NULL, " +"age INTEGER DEFAULT 0, " +"email TEXT UNIQUE, " +"create_time TEXT DEFAULT (datetime('now','localtime')))";public UserDBHelper(Context context) {super(context, DB_NAME, null, DB_VERSION);}@Overridepublic void onCreate(RdbStore store) {// 創建初始表結構store.executeSql(CREATE_TABLE_USER);}@Overridepublic void onUpgrade(RdbStore store, int oldVersion, int newVersion) {// 數據庫升級邏輯if (oldVersion < 2) {// 版本2新增address字段store.executeSql("ALTER TABLE user ADD COLUMN address TEXT");}}
}

3.2.2 初始化數據庫

// 數據庫配置
StoreConfig config = StoreConfig.newDefaultConfig("user_db.db");
// 設置是否加密
config.setEncryptKey("your_encryption_key".getBytes());// 初始化數據庫
UserDBHelper helper = new UserDBHelper(context);
RdbStore rdbStore = helper.getRdbStore(config);

3.2.3 CRUD操作實現

1. 插入數據

ValuesBucket values = new ValuesBucket();
values.putString("name", "李四");
values.putInteger("age", 28);
values.putString("email", "lisi@example.com");
values.putString("address", "北京市海淀區");long newId = rdbStore.insert("user", values);

2. 查詢數據

// 構建查詢條件
RdbPredicates predicates = new RdbPredicates("user").greaterThan("age", 20).orderByAsc("name").limit(10).offset(0);// 指定返回列
String[] columns = {"id", "name", "age", "email", "address"};// 執行查詢
ResultSet resultSet = rdbStore.query(predicates, columns);// 處理結果集
List<User> userList = new ArrayList<>();
while (resultSet.goToNextRow()) {User user = new User();user.setId(resultSet.getInt(0));user.setName(resultSet.getString(1));user.setAge(resultSet.getInt(2));user.setEmail(resultSet.getString(3));user.setAddress(resultSet.getString(4));userList.add(user);
}
resultSet.close();

3. 更新數據

ValuesBucket updateValues = new ValuesBucket();
updateValues.putInteger("age", 29);RdbPredicates updatePredicates = new RdbPredicates("user").equalTo("email", "lisi@example.com");int updatedRows = rdbStore.update(updateValues, updatePredicates);

4. 刪除數據

RdbPredicates deletePredicates = new RdbPredicates("user").lessThanOrEqualTo("age", 18);int deletedRows = rdbStore.delete(deletePredicates);

3.2.4 事務處理

rdbStore.beginTransaction();
try {// 批量插入數據for (User user : userList) {ValuesBucket values = new ValuesBucket();values.putString("name", user.getName());// 設置其他字段...rdbStore.insert("user", values);}// 標記事務成功rdbStore.markAsCommit();
} catch (Exception e) {// 發生異常回滾事務rdbStore.markAsRollback();throw e;
} finally {// 結束事務rdbStore.endTransaction();
}

3.3 SQLite最佳實踐

1. 合理設計表結構：遵循數據庫規范化原則

2. 使用索引優化查詢：對頻繁查詢的字段創建索引

3. 避免在主線程操作數據庫：使用線程池或異步任務

4. 處理數據庫升級：妥善管理onUpgrade邏輯

5. 使用預編譯語句：提高頻繁操作的性能

6. 定期維護數據庫：如VACUUM操作減少碎片

四、SQLite與Preferences對比選型

特性	Preferences	SQLite
存儲類型	鍵值對	關系型表格
適合場景	簡單配置/用戶偏好	復雜結構化數據
查詢能力	簡單鍵值查找	強大SQL查詢
數據量	小（KB級）	大（GB級）
性能	極高	高
線程安全	是	需要自行管理
加密支持	有限	支持完整加密
學習曲線	簡單	中等

選型建議：

• 選擇Preferences：用戶主題設置、應用開關狀態、簡單的計數器等

• 選擇SQLite：用戶通訊錄、聊天記錄、商品目錄等復雜數據

五、安全注意事項

1. 敏感數據加密：無論是Preferences還是SQLite，存儲密碼等敏感信息前必須加密

2. 數據庫加密：使用setEncryptKey()方法加密SQLite數據庫

3. 文件權限控制：確保數據文件不被其他應用訪問

4. 輸入驗證：防止SQL注入攻擊

5. 定期備份：重要數據應實現備份機制

六、總結

鴻蒙系統提供的Preferences和SQLite兩種存儲方案各有優勢，開發者應根據實際需求選擇合適的方案。Preferences操作簡單、性能極高，適合存儲少量簡單數據；SQLite功能強大、查詢靈活，適合管理復雜結構化數據。

在實際開發中，我們常常會同時使用這兩種存儲方式：用Preferences保存應用配置和用戶偏好，用SQLite管理應用的核心業務數據。掌握這兩種存儲技術，能夠為鴻蒙應用開發提供堅實的數據持久化支持。

隨著鴻蒙生態的不斷發展，數據存儲技術也將持續演進。建議開發者定期關注鴻蒙官方文檔，了解最新的存儲API和改進特性，以構建更高效、更安全的鴻蒙應用程序。

?