前言

我們前面一篇介紹了使用 floor 這個(gè) ORM 框架處理 Flutter 本地的 SQLite 數(shù)據(jù)庫。使用 ORM 框架最大的好處是簡化了數(shù)據(jù)庫維護(hù)的代碼量，使得我們可以專注于業(yè)務(wù)代碼實(shí)現(xiàn)。在之前，我們也講到了不同 App 版本的 數(shù)據(jù)表結(jié)構(gòu)變化后，如何使用 sqflite 來處理版本升級。本篇，我們看看使用 floor 如何處理數(shù)據(jù)庫版本升級。

floor 數(shù)據(jù)庫版本升級

floor 框架同樣提供了數(shù)據(jù)庫版本號，當(dāng)前使用的版本號使用注解配置。

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

當(dāng)數(shù)據(jù)表結(jié)構(gòu)發(fā)生變化時(shí)，就需要變更版本號指定新的版本。同時(shí)需要做如下處理：

• 更新實(shí)體類：比如增加或減少字段，變更字段類型等等；
• 編寫遷移處理Migration類對象，Migration 類定義如下：

Migration(this.startVersion, this.endVersion, this.migrate)

其中第一個(gè)參數(shù)為起始版本號，第二個(gè)參數(shù)為要遷移到的版本號，最后是一個(gè)遷移處理函數(shù)，函數(shù)定義為：Future<void> Function(sqflite.Database database) migrate。我們要做的數(shù)據(jù)表變動(dòng)就在這個(gè)函數(shù)里處理。

將編寫好的Migration類對象添加到數(shù)據(jù)庫初始化的 addMigrations 方法中，addMigrations方法接收一個(gè)Migration對象數(shù)組，因此是支持多種遷移的，比如從版本1遷移到版本3的遷移對象，從版本2遷移到版本3的遷移對象，從而滿足多個(gè)版本同時(shí)遷移。

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

實(shí)體類變更后，需要用代碼生成命令重新生成數(shù)據(jù)庫操作的相關(guān)代碼。

看起來非常簡單，我們來看實(shí)際的例子。

版本升級實(shí)例

我們給之前的備忘錄增加一個(gè)分類（category）字段，可以設(shè)置備忘錄的分類，分類我們簡單地固定為預(yù)設(shè)的幾類。我們按照上面的步驟一步步編寫代碼即可。

變更版本：將數(shù)據(jù)庫版本號改為2；

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

在備忘錄類增加分類字段，由于已有數(shù)據(jù)的分類字段是 null 的，因此需要設(shè)置這個(gè)字段可為空Nullable；設(shè)置為非空也可以，只是需要在遷移時(shí)給舊版本已有數(shù)據(jù)相應(yīng)字段設(shè)置非空初始值。

@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,
  });
}

編寫數(shù)據(jù)庫遷移處理對象，并加入到版本遷移中。

final migration1to2 = Migration(1, 2, (database) async {
  await database.execute('ALTER TABLE Memo ADD COLUMN category TEXT');
  // 可選，設(shè)置舊版本字段初始值
  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());
}

運(yùn)行下面的命令生成代碼。

flutter packages pub run build_runner build

當(dāng)然，我們也需要對 UI 相關(guān)的代碼進(jìn)行變更，變更后的 UI 界面如下圖所示。

完整代碼已經(jīng)提交到：本地存儲相關(guān)代碼。

總結(jié)

從代碼量上來說，使用 floor 和直接使用 sqflite 處理版本遷移差不多。相比直接使用 sqflite 做數(shù)據(jù)庫版本遷移，使用 floor 的好處是可以通過添加多個(gè) Migration 對象支持多版本遷移。

到此這篇關(guān)于Flutter利用ORM框架管理數(shù)據(jù)庫詳解的文章就介紹到這了,更多相關(guān)Flutter ORM框架管理數(shù)據(jù)庫內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論