Flutter利用ORM框架管理数据库详解

 更新时间:2023年04月17日 08:20:50   作者:岛上码农  
使用 ORM 框架最大的好处是简化了数据库维护的代码量,使得我们可以专注于业务代码实现。本篇,我们看看如何使用ORM框架管理数据库版本迁移,需要的可以参考一下

前言

我们前面一篇介绍了使用 floor 这个 ORM 框架处理 Flutter 本地的 SQLite 数据库。使用 ORM 框架最大的好处是简化了数据库维护的代码量,使得我们可以专注于业务代码实现。在之前,我们也讲到了不同 App 版本的 数据表结构变化后,如何使用 sqflite 来处理版本升级。本篇,我们看看使用 floor 如何处理数据库版本升级。

floor 数据库版本升级

floor 框架同样提供了数据库版本号,当前使用的版本号使用注解配置。

@Database(version: 1, entities: [Memo])

当数据表结构发生变化时,就需要变更版本号指定新的版本。同时需要做如下处理:

  • 更新实体类:比如增加或减少字段,变更字段类型等等;
  • 编写迁移处理Migration类对象,Migration 类定义如下:
Migration(this.startVersion, this.endVersion, this.migrate)

其中第一个参数为起始版本号,第二个参数为要迁移到的版本号,最后是一个迁移处理函数,函数定义为:Future<void> Function(sqflite.Database database) migrate。我们要做的数据表变动就在这个函数里处理。

将编写好的Migration类对象添加到数据库初始化的 addMigrations 方法中,addMigrations方法接收一个Migration对象数组,因此是支持多种迁移的,比如从版本1迁移到版本3的迁移对象,从版本2迁移到版本3的迁移对象,从而满足多个版本同时迁移。

final database = await $FloorAppDatabase
    .databaseBuilder('app_database.db')
    .addMigrations([migration1to3, migration2to3])
    .build();

实体类变更后,需要用代码生成命令重新生成数据库操作的相关代码。

看起来非常简单,我们来看实际的例子。

版本升级实例

我们给之前的备忘录增加一个分类(category)字段,可以设置备忘录的分类,分类我们简单地固定为预设的几类。我们按照上面的步骤一步步编写代码即可。

变更版本:将数据库版本号改为2;

@Database(version: 2, entities: [Memo])

在备忘录类增加分类字段,由于已有数据的分类字段是 null 的,因此需要设置这个字段可为空Nullable;设置为非空也可以,只是需要在迁移时给旧版本已有数据相应字段设置非空初始值。

@entity
class Memo {
  @PrimaryKey(autoGenerate: true)
  final int? id;
  String title;
  String content;
  @ColumnInfo(name: 'created_time')
  DateTime createdTime;
  @ColumnInfo(name: 'modified_time')
  DateTime modifiedTime;
  String? category;
  List<String> tags;

  Memo({
    this.id,
    required this.title,
    required this.content,
    required this.createdTime,
    required this.modifiedTime,
    this.category = '',
    required this.tags,
  });
}

编写数据库迁移处理对象,并加入到版本迁移中。

final migration1to2 = Migration(1, 2, (database) async {
  await database.execute('ALTER TABLE Memo ADD COLUMN category TEXT');
  // 可选,设置旧版本字段初始值
  await database.update('Memo',{'category': ''});
});

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  final database = await $FloorMemoDatabase
      .databaseBuilder('app_database.db')
      .addMigrations([migration1to2]).build();

  final dao = database.memoDao;

  getIt.registerSingleton<MemoDao>(dao, signalsReady: true);

  runApp(const MyApp());
}

运行下面的命令生成代码。

flutter packages pub run build_runner build

当然,我们也需要对 UI 相关的代码进行变更,变更后的 UI 界面如下图所示。

完整代码已经提交到:本地存储相关代码

总结

从代码量上来说,使用 floor 和直接使用 sqflite 处理版本迁移差不多。相比直接使用 sqflite 做数据库版本迁移,使用 floor 的好处是可以通过添加多个 Migration 对象支持多版本迁移。

到此这篇关于Flutter利用ORM框架管理数据库详解的文章就介绍到这了,更多相关Flutter ORM框架管理数据库内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Android服务Service教程

    Android服务Service教程

    Android的服务是开发Android应用程序的重要组成部分。不同于活动Activity,服务是在后台运行,服务没有接口,生命周期也与活动Activity非常不同。通过使用服务我们可以实现一些后台操作,比如想从远程服务器加载一个网页等,下面来看看详细内容,需要的朋友可以参考下
    2021-11-11
  • Android ListView数据绑定显示的三种解决方法

    Android ListView数据绑定显示的三种解决方法

    本篇文章小编为大家介绍,Android ListView数据绑定显示的三种解决方法。需要的朋友参考下
    2013-04-04
  • Android编程之蓝牙测试实例

    Android编程之蓝牙测试实例

    这篇文章主要介绍了Android编程之蓝牙测试,较为详细的分析了Android蓝牙测试的相关运行环境与调试技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • android图库竖屏不显示status bar的解决方法

    android图库竖屏不显示status bar的解决方法

    图库在JB和JB2的版本上显示的行为是:横屏全屏显示,竖屏会显示status bar,图库在JB和JB2的版本上显示的行为是:横屏全屏显示,竖屏会显示status bar,具体实现方法如下,不会的朋友可以参考下哈
    2013-06-06
  • Android指纹登录工具类封装

    Android指纹登录工具类封装

    这篇文章主要为大家详细介绍了Android指纹登录工具类的封装,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-09-09
  • Android笔记之:App应用之发布各广告平台版本的详解

    Android笔记之:App应用之发布各广告平台版本的详解

    Android的广告平台是很多的,各市场对各平台的接受程度是不一样的,Android的开发者如果想集成广告基本要考虑下面两个问题
    2013-04-04
  • Android适配利用webview加载后图片显示过大的问题解决

    Android适配利用webview加载后图片显示过大的问题解决

    这篇文章主要给大家介绍了关于Android适配利用webview加载后图片显示过大问题的解决方法,文中通过示例代码介绍的非常详细,对各位Android开发者们具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-07-07
  • Android组合控件自定义标题栏

    Android组合控件自定义标题栏

    这篇文章主要为大家详细介绍了Android组合控件自定义标题栏,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-11-11
  • 基于Android平台实现拼图小游戏

    基于Android平台实现拼图小游戏

    这篇文章主要为大家详细介绍了基于Android平台实现拼图小游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-12-12
  • Android用tabhost实现 界面切换,每个界面为一个独立的activity操作

    Android用tabhost实现 界面切换,每个界面为一个独立的activity操作

    这篇文章主要介绍了Android用tabhost实现 界面切换,每个界面为一个独立的activity操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09

最新评论