HarmonyOS 开发-数据库版本升级案例

介绍

本示例介绍使用关系型数据库的接口来进行数据库升降级场景实现

效果预览图

使用说明

  1. 加载完成后有版本升级以及版本恢复两种按钮
  2. 点击版本升级下的”升级至V2“按钮,则数据库版本会从V1升级至V2,且在表格处显示V1和V2版本表格字段对比。
  3. 点击版本升级下的”升级至V3“按钮,若当前是V1版本,则会执行V1升级至V3的逻辑,且在表格处显示V1和V3版本表格字段对比。
  4. 版本恢复下的按钮会在升级至V1以上版本时可点击,如步骤二中升级至V2版本后,则”恢复到V1“按钮可点击,点击后数据库版本回退至V1版本

实现思路

数据库版本升级有两种方案

方案一:直接升级,需要实现各版本到目标版本的实现逻辑,优点在于性能好,缺点是逻辑复杂且较难维护。

方案二:一步一步升级到最新版本,只需要实现紧邻版本的升级逻辑,优点在于逻辑简单,便于维护,缺点在于比方案一性能差。

在本示例中两种方案都有体现,其中从V1->V2->V3用的方案二,从V1->V3使用的方案一,具体实现步骤如下:

  1. 使用临时表方案,在升级时将旧表重命名为临时表,并创建一张与旧表未重命名前的名字相同的新表,分批次取出临时表中数据进行转换存入新表中,数据迁移完毕后删除临时表。
// 开启事务
dbUtils.beginTransaction();
// 获取当前数据库版本
const oldVersion: number = dbUtils.getStoreVersion();
// 将旧表改为临时表
await dbUtils.updateTableName(Constants.STUDENT_TABLE, Constants.STUDENT_TABLE + oldVersion);
// 创建新表
const newTableColumnTypeMap: string[][] = CommonUtils.getTableColumnTypeMapByVersion(targetVersion);
await dbUtils.createTable(Constants.STUDENT_TABLE, newTableColumnTypeMap);
dbUtils.commit();
// 自定义迁移逻辑
let lastId: number = -1;
let flag: boolean = false;
await this.migrate(lastId, oldVersion, targetVersion, flag);
// 删除旧表
await dbUtils.dropTable(Constants.STUDENT_TABLE + oldVersion, targetVersion);
  1. 为方便扩展迭代,在父类中定义整体逻辑,子类只需继承父类,重写字段转换逻辑即可。
  /**
 * TODO: 知识点: 新老版本字段转换逻辑(版本升级只需要实现这个方法即可)
 * @param resultSet 查询结果集
 * @param targetVersion 目标版本
 * @returns 目标版本格式数据
 */
abstract transform(resultSet: relationalStore.ResultSet, targetVersion: number): ValuesBucket;
  1. 根据数据库当前版本和需升级至版本,选择对应的升级逻辑。
switch (currentVersion) {
  case Constants.V1:
    await this.v1DataService.onUpgrade(version);
    break;
  case Constants.V2:
    await this.v2DataService.onUpgrade(version);
    break;
  default:
    throw new Error('The database version to which you need to upgrade is incorrect');
}

工程结构&模块类型

   databaseupgrade                                        // har类型
   |---components
   |   |---CustomFormComponents.ets                       // 自定义表格组件          
   |---constants                                          
   |   |---Constants.ets                                  // 常量类
   |---service
   |   |---DataService.ets                                // 业务层-版本升级逻辑
   |---utils                                          
   |   |---CommonUtils.ets                                // 工具类
   |   |---DBUtils.ets                                    // 数据库操作封装
   |---view                                          
   |   |---DatabaseUpgrade.ets                            // 视图层-数据库版本升级案例交互界面
阅读全文
下载说明:
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.shuli.cc/?p=21725,转载请注明出处。
0

评论0

显示验证码
没有账号?注册  忘记密码?