DB迁移变得容易！

每当你修改数据库架构，你需要在对应的@Database类内部通过增加数据库版本。还需要添加一个迁移到配置或通过定义迁移 /assets/migrations/{DatabaseName}/{versionName.sql}。

在首次创建数据库，您可以使用版本0指定一个迁移运行时！

注意：任何提供的子类，如AlterTableMigration，UpdateTableMigration和IndexMigration应该只覆盖onPreMigrate（）和调用super.onPreMigrate（），所以它的正确实例化。

注意：所有迁移必须只有一个public默认构造函数。

迁移类

基类，BaseMigration是一个非常简单的类来执行迁移：

2. @Migration(version = 2, database = AppDatabase.class)
3. public class Migration1 extends BaseMigration {

5. @Override
6. public void migrate(DatabaseWrapper database) {
7. List<SomeClass> list = SQLite.select()
8. .from(SomeClass.class)
9. .queryList(database); // must pass in wrapper in order to prevent recursive calls to DB.
10. }
11. }

添加列

此处是添加到数据库的列的一个例子：

假设我们有原来的示例类：

2. @Table
3. public class TestModel extends BaseModel {

5. @Column
6. @PrimaryKey
7. String name;

9. @Column
10. int randomNumber;
11. }

现在，我们要添加一列到这个表。我们有两种方式：

• 利用SQL语句

ALTER TABLE TestModel ADD COLUMN timestamp INTEGER; in a {dbVersion.sql} file in the assets directory. If we need to add any other column, we have to add more lines. - 通过Migration:

2. @Migration(version = 2, database = AppDatabase.class)
3. public class Migration1 extends AlterTableMigration<TestModel> {

5. @Override
6. public void onPreMigrate() {
7. // Simple ALTER TABLE migration wraps the statements into a nice builder notation
8. addColumn(Long.class, "timestamp");
9. }
10. }

更新列

2. @Migration(version = 2, database = AppDatabase.class)
3. public class Migration1 extends UpdateTableMigration<TestModel> {

5. @Override
6. public void onPreMigrate() {
7. // UPDATE TestModel SET deviceType = "phablet" WHERE screenSize > 5.7 AND screenSize < 7;
8. set(TestModel_Table.deviceType.is("phablet"))
9. .where(TestModel_Table.screenSize.greaterThan(5.7), TestModel_Table.screenSize.lessThan(7));
10. }
11. }