ArkTS 鸿蒙本地数据持久化(Preferences、数据库、文件存储详解)

import { preferences } from '@kit.ArkData';import { common } from '@kit.BasicServicesKit';let dataPreferences: preferences.Preferences | null = null;export class StorageUtil {  // 初始化  static async initStorage() {    if (dataPreferences) return;    const context = getContext() as common.UIAbilityContext;    dataPreferences = await preferences.getPreferences(context, "app_config");  }  // 保存数据  static async setData(key: string, value: any) {    await this.initStorage();    try {      let saveValue = value;      // 对象序列化      if (typeof value === 'object') {        saveValue = JSON.stringify(value);      }      // 敏感数据简易编码      if (key.includes('token') || key.includes('pwd')) {        saveValue = btoa(saveValue);      }      await dataPreferences!.putSync(key, saveValue);      await dataPreferences!.flush();    } catch (e) {      console.error("存储失败：", e);    }  }  // 读取数据  static async getData<T>(key: string, defaultValue: T): Promise<T> {    await this.initStorage();    try {      let value = await dataPreferences!.get(key, defaultValue);      // 解密      if (key.includes('token') || key.includes('pwd')) {        value = atob(value as string);      }      // JSON解析      if (typeof value === 'string' && (value.startsWith('{') || value.startsWith('['))) {        return JSON.parse(value) as T;      }      return value as T;    } catch (e) {      return defaultValue;    }  }  // 删除单条  static async deleteKey(key: string) {    await this.initStorage();    await dataPreferences!.delete(key);    await dataPreferences!.flush();  }  // 清空全部  static async clearAll() {    await this.initStorage();    await dataPreferences!.clear();    await dataPreferences!.flush();  }}

import { relationalStore } from '@kit.ArkData';import { common } from '@kit.BasicServicesKit';const STORE_NAME = "local_database.db";const STORE_VERSION = 1;let rdbStore: relationalStore.RdbStore | null = null;// 用户表结构const CREATE_TABLE_SQL = `CREATE TABLE IF NOT EXISTS user(  id INTEGER PRIMARY KEY AUTOINCREMENT,  username TEXT,  age INTEGER)`;export class RdbUtil {  // 初始化数据库  static async initRdb() {    if (rdbStore) return;    const context = getContext() as common.UIAbilityContext;    const config: relationalStore.StoreConfig = {      name: STORE_NAME,      securityLevel: relationalStore.SecurityLevel.S1    };    rdbStore = await relationalStore.getRdbStore(context, config);    // 创建表    await rdbStore.executeSql(CREATE_TABLE_SQL);  }  // 新增数据  static async insertUser(user: {username:string,age:number}) {    await this.initRdb();    const valueBucket: relationalStore.ValuesBucket = {      "username": user.username,      "age": user.age    };    return await rdbStore!.insert("user", valueBucket);  }  // 查询全部  static async queryAllUser() {    await this.initRdb();    const resultSet = await rdbStore!.query("user", ["id","username","age"]);    let list: any[] = [];    while (resultSet.goToNextRow()) {      list.push({        id: resultSet.getLong(0),        username: resultSet.getString(1),        age: resultSet.getLong(2)      });    }    resultSet.close();    return list;  }  // 删除  static async deleteUser(id: number) {    await this.initRdb();    const predicates = new relationalStore.RdbPredicates("user");    predicates.equalTo("id", id);    return await rdbStore!.delete(predicates);  }  // 更新  static async updateUser(id:number,newName:string) {    await this.initRdb();    const bucket: relationalStore.ValuesBucket = {"username":newName};    const predicates = new relationalStore.RdbPredicates("user");    predicates.equalTo("id",id);    return await rdbStore!.update(bucket,predicates);  }}

import { fileIo, fs } from '@kit.CoreFileKit';import { common } from '@kit.BasicServicesKit';export class FileUtil {  // 获取沙箱根目录  staticgetSandboxPath(): string {    const context = getContext() as common.UIAbilityContext;    return context.filesDir;  }  // 写入文本文件  staticasyncwriteFile(fileName: string, content: string) {    const path = this.getSandboxPath() + "/" + fileName;    const file = await fileIo.open(path, fileIo.OpenMode.CREATE | fileIo.OpenMode.WRITE_ONLY);    await fileIo.write(file.fd, content);    await fileIo.close(file.fd);  }  // 读取文本文件  staticasyncreadFile(fileName: string): Promise<string> {    const path = this.getSandboxPath() + "/" + fileName;    const file = await fileIo.open(path, fileIo.OpenMode.READ_ONLY);    const res = await fileIo.readText(file.fd);    await fileIo.close(file.fd);    return res;  }  // 删除文件  staticasyncdeleteFile(fileName:string){    const path = this.getSandboxPath() + "/" + fileName;    await fs.unlink(path);  }}

import { StorageUtil } from './utils/StorageUtil';import { RdbUtil } from './utils/RdbUtil';import { FileUtil } from './utils/FileUtil';import { promptAction } from '@kit.ArkUI';@Entry@Componentstruct Index {  @State tips: string = "暂无数据";  build() {    Column({ space: 12 }) {      Text("Day09 三大数据持久化演示")        .fontSize(22)        .fontWeight(FontWeight.Bold)        .margin({ top: 30 })      Text(this.tips)        .fontSize(15)        .padding(15)        .width("90%")        .backgroundColor("#fff")        .borderRadius(10)      Button("1.保存Token(加密存储)")        .width("85%")        .onClick(async () => {          await StorageUtil.setData("token","ABC123456789TOKEN");          this.tips = "Token保存成功，已加密";        })      Button("2.读取Token")        .width("85%")        .backgroundColor("#10B981")        .onClick(async () => {          const token = await StorageUtil.getData("token","无数据");          this.tips = "读取Token：" + token;        })      Button("3.数据库新增用户")        .width("85%")        .backgroundColor("#2563EB")        .onClick(async () => {          await RdbUtil.insertUser({username:"鸿蒙开发者",age:18});          this.tips = "数据库插入成功";        })      Button("4.文件写入日志")        .width("85%")        .backgroundColor("#F59E0B")        .onClick(async () => {          await FileUtil.writeFile("log.txt","我是本地日志内容");          this.tips = "文件写入成功";        })    }    .width('100%')    .height('100%')    .padding(15)    .backgroundColor("#f7f8fa")  }}