HarmonyOS开发实战：小分享-关系型数据库 RDB——分享历史记录管理

前言关系型数据库RDB适合存储结构化数据如分享历史记录、用户数据等。HarmonyOS 提供了ohos.data.relationalStore实现 SQLite 数据库。本篇讲解数据库创建、表结构设计、CRUD 操作。详细 API 可参考 HarmonyOS RDB 官方文档。一、RDB 数据库初始化import { relationalStore } from ohos.data.relationalStore; import { BusinessError } from ohos.base; const STORE_CONFIG: relationalStore.StoreConfig { name: ShareHistory.db, securityLevel: relationalStore.SecurityLevel.S1 }; const CREATE_TABLE_SQL CREATE TABLE IF NOT EXISTS share_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, type TEXT NOT NULL, content TEXT, create_time TEXT NOT NULL ) ; let rdbStore: relationalStore.RdbStore | null null; async function initDatabase(context: Context): Promisevoid { rdbStore await relationalStore.getRdbStore(context, STORE_CONFIG); await rdbStore.executeSql(CREATE_TABLE_SQL); }二、CRUD 操作2.1 插入数据async function insertHistory(item: { title: string, type: string, content: string, createTime: string }): Promisenumber { const valueBucket: relationalStore.ValuesBucket { title: item.title, type: item.type, content: item.content, create_time: item.createTime }; return await rdbStore!.insert(share_history, valueBucket); }2.2 查询数据async function queryHistory(): PromiseArrayRecordstring, Object { const predicates new relationalStore.RdbPredicates(share_history); predicates.orderByDesc(create_time); predicates.limit(20); const resultSet await rdbStore!.query(predicates, [id, title, type, content, create_time]); const results: ArrayRecordstring, Object []; while (resultSet.goToNextRow()) { results.push({ id: resultSet.getLong(0), title: resultSet.getString(1), type: resultSet.getString(2), content: resultSet.getString(3), createTime: resultSet.getString(4) }); } resultSet.close(); return results; }2.3 更新数据async function updateTitle(id: number, newTitle: string): Promisenumber { const valueBucket: relationalStore.ValuesBucket { title: newTitle }; const predicates new relationalStore.RdbPredicates(share_history); predicates.equalTo(id, id); return await rdbStore!.update(valueBucket, predicates); }2.4 删除数据async function deleteHistory(id: number): Promisenumber { const predicates new relationalStore.RdbPredicates(share_history); predicates.equalTo(id, id); return await rdbStore!.delete(predicates); }三、表结构设计字段类型说明idINTEGER主键自增titleTEXT分享标题typeTEXT分享类型文字/图片/链接contentTEXT分享内容create_timeTEXT创建时间四、RDB vs Preferences 对比对比维度RDBPreferences数据结构结构化表键值对查询能力支持 SQL仅 key 查询数据量大量少量复杂度较高简单适用场景历史记录、列表设置项、配置五、本文核心知识点5.1 RDB 核心要点getRdbStore 初始化数据库executeSql 执行建表语句insert/query/update/delete CRUD 操作RdbPredicates 构建查询条件5.2 实战开发要点建表用 CREATE TABLE IF NOT EXISTS查询后用 resultSet.close() 释放资源大量数据用 RDB少量用 Preferences附录RDB 数据库的完整实现细节1. RDB 完整 APIAPI作用说明getRdbStore(context, config)获取数据库实例异步executeSql(sql)执行 SQL建表、迁移insert(table, values)插入数据返回 rowIdquery(predicates, columns)查询数据返回 ResultSetupdate(values, predicates)更新数据返回影响行数delete(predicates)删除数据返回影响行数2. 完整的建表语句const CREATE_TABLE_SQL CREATE TABLE IF NOT EXISTS share_history ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, type TEXT NOT NULL, content TEXT, create_time TEXT NOT NULL ) ;3. 完整的 CRUD 操作// 插入 async function insertHistory(item: HistoryItem): Promisenumber { const valueBucket: relationalStore.ValuesBucket { title: item.title, type: item.type, content: item.content, create_time: item.createTime }; return await rdbStore!.insert(share_history, valueBucket); } // 查询 async function queryHistory(limit: number): PromiseArrayHistoryItem { const predicates new relationalStore.RdbPredicates(share_history); predicates.orderByDesc(create_time); predicates.limit(limit); const resultSet await rdbStore!.query(predicates, [id, title, type, content, create_time]); const results: ArrayHistoryItem []; while (resultSet.goToNextRow()) { results.push({ id: resultSet.getLong(0), title: resultSet.getString(1), type: resultSet.getString(2), content: resultSet.getString(3), createTime: resultSet.getString(4) }); } resultSet.close(); return results; }4. RDB 与 Preferences 对比对比维度RDBPreferences数据结构关系表键值对查询能力SQL 查询仅 key 查询数据量大量少量复杂度较高简单适用场景历史记录、列表设置项、配置5. 完整代码文件索引文件路径说明common/database/HistoryDb.ets数据库工具类pages/ProfilePage.ets使用数据库6. 实现要点总结RDB 核心要点getRdbStore初始化数据库executeSql执行建表语句insert/query/update/deleteCRUD 操作RdbPredicates构建查询条件ResultSet遍历查询结果7. 总结本文详细讲解了 HarmonyOS RDB 关系型数据库的完整实现涵盖建表、CRUD 操作、查询条件等核心知识点。完整代码索引文件路径说明本文涉及的代码文件见正文核心 API 参考API/组件用途文档链接文中涉及的 API核心功能华为官方文档常见问题Q1: 为什么会出现编译错误A: 检查 import 路径是否正确确认 API 版本兼容性。Q2: 如何调试功能A: 使用 hilog 打印日志检查参数传递是否正确。Q3: 运行时崩溃怎么办A: 使用 try/catch 捕获异常检查权限配置。性能优化建议异步操作使用 async/await 避免阻塞 UI大量数据使用 LazyForEach 懒加载图片资源压缩后再使用缓存网络请求结果及时释放不再使用的资源安全注意事项用户输入必须校验敏感数据不要硬编码网络请求使用 HTTPS文件路径避免注入权限最小化原则扩展阅读HarmonyOS 官方文档提供了更详细的 API 说明开源鸿蒙社区有丰富的示例代码华为开发者论坛可以获取技术支持总结本文详细讲解了小分享 App 中对应功能的完整实现涵盖 API 使用、代码示例、常见问题、性能优化等核心知识点。通过本文的学习读者可以掌握 HarmonyOS 开发的完整流程。本章小结本文详细介绍了小分享 App 中对应功能的完整实现方案。通过本文的学习读者可以掌握以下核心知识点功能的核心 API 使用方法和注意事项完整的代码实现流程和最佳实践常见问题的排查和解决方案性能优化和安全建议掌握这些知识后读者可以独立实现类似功能并应用到自己的 HarmonyOS 应用开发中。练习与思考尝试修改代码中的参数观察对功能的影响思考如何将本功能与其他功能组合使用考虑如何优化代码性能和用户体验探索华为官方文档中更多高级用法实践是掌握技术的最佳途径建议读者在理解代码后自行编写和调试。本文总结本文详细讲解了小分享 App 中对应功能的完整实现。通过本文的学习读者可以掌握 HarmonyOS 开发的核心 API 使用方法和最佳实践。在实际开发中建议读者结合官方文档深入理解每个 API 的参数含义和适用场景并在项目中灵活运用。技术能力的提升来自于持续的实践和总结希望读者在阅读本文后能够动手实践将知识转化为技能。数据库操作最佳实践数据库版本管理使用executeSql执行迁移脚本确保数据结构变更时数据不丢失连接管理数据库连接使用完毕后及时关闭避免资源泄漏批量操作大量数据插入时使用事务提升性能查询优化添加索引加速查询避免全表扫描错误处理所有数据库操作使用 try/catch 包裹总结本文详细讲解了 HarmonyOS RDB 关系型数据库的完整实现涵盖建表、CRUD 操作、查询条件等核心知识点。RDB 适合存储结构化数据如分享历史记录、用户数据等。AppPreferences 数据持久化网络请求封装总结本文详细讲解了小分享 App 中对应功能的完整实现。通过本文的学习读者可以掌握 HarmonyOS 开发的核心 API 使用方法和最佳实践并能够独立实现类似功能。在实际开发中建议读者结合官方文档深入理解每个 API 的参数含义和适用场景并在项目中灵活运用。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力