DBFlow:数据迁移（Migrations）

数据迁移是如何工作的？

在sqlite中，所谓迁移是修改现有的数据库的设计结构，以适应新的数据结构。
在sqlite中，我们很有限的去比较sql，从而去修改表和列。

现在有两种方式去修改：

1. 重命名表
2. 添加新的列

DBFlow 可以做到的：

1. 修改数据库的结构
2. 向数据库中提前插入数据
3. 为指定的表添加索引

迁移的一些类

我们推荐将 Migration的类放在注解@Table的类中。因为显而易见嘛！
小例子：

Migration可设置优先级，高优先级的将先被执行。
Migration有3个方法：

1. onPreMigrate() 首先被调用，在这儿设置和构造
2. migrate() 具体的迁移在这儿执行
3. onPostMigrate() 执行一些清理工作，或者执行完成的通知。

迁移文件

DBFlow也支持.sql文件，规则如下：

1. 放置他们到 assets/migrations/{DATABASE_NAME}/{versionNumber}.sql ，例如：assets/migrations/AppDatabase/2.sql
2. 文件内可包括任意数量的sql语句，注意：每个语句为单独一行，多行则在尾部加上；
3. --为注释

防止迭代访问数据库

在迁移的时候，数据库是打开的。我们不可用迭代的访问数据库对象。
记住：DBFlow传递了DatabaseWrapper 给你：

1. 增删改查：Select Insert Update Delete
2. 所有的BaseModel的子类

提供的迁移类

DBFlow 提供了几个迁移类帮助你简单的迁移

1. AlterTableMigration
2. IndexMigration/IndexPropertyMigration
3. UpdateTableMigration

1. AlterTableMigration

修改表的结构

支持的修改：

1. 重命名 表的名字
2. 添加列

重命名 表的名字
在迁移之前，你应该先重命名你的model类@Table(name = "{newName}")

添加新的列
我们只支持SQLiteType去添加或移除新的列。

@Migration(version = 2, database = AppDatabase.class)
public class Migration2 extends AlterTableMigration<AModel> {

   public Migration2(Class<AModel> table) {
       super(table);
   }

   @Override
   public void onPreMigrate() {
       addColumn(SQLiteType.TEXT, "myColumn");
       addColumn(SQLiteType.REAL, "anotherColumn");
   }
}

2.Index Migrations

IndexMigration:

@Migration(version = 2, priority = 0, database = MigrationDatabase.class)
public static class IndexMigration2 extends IndexMigration<MigrationModel> {

  public IndexMigration2(@NonNull Class<MigrationModel> onTable) {
      super(onTable);
  }

  @NonNull
  @Override
  public String getName() {
      return "TestIndex";
  }
}

IndexPropertyMigration:

@Migration(version = 2, priority = 1, database = MigrationDatabase.class)
public static class IndexPropertyMigration2 extends IndexPropertyMigration {

   @NonNull
   @Override
   public IndexProperty getIndexProperty() {
       return IndexModel_Table.index_customIndex;
   }
}

3. Update Table Migration

提供简单的方式去更新数据

@Migration(version = 2, priority = 2, database = MigrationDatabase.class)
public static class UpdateMigration2 extends UpdateTableMigration<MigrationModel> {

   /**
    * Creates an update migration.
    *
    * @param table The table to update
    */
   public UpdateMigration2(Class<MigrationModel> table) {
       super(table);
       set(MigrationModel_Table.name.eq("New Name"));
   }

}