Android 数据库表与字段的升级

一.背景

在应用程序开发的过程中，数据库的升级是一个很重要的组成部分（如果用到了数据库），因为程序可能会有V1.0，V2.0，当用户安装新版本的程序后，必须要保证用户数据不能丢失，对于数据库设计，如果发生变更（如多添加一张表，表的字段增加或减少等），那么我们必须想好数据库的更新策略。

有一种场景就是，在数据库升级时，不同版本的数据库，他们定义的表结构完全可能是不一样的，比如V1.0的表A有5个column，而在V1.1的表A有10个colum，在升级时，表A增加了两列，此时我们应该怎么做呢。

如果不去做兼容处理，运行新的应用版本程序会出现闪退。

二.关键步骤

升级包含表升级和字段升级(v1.0<旧> , v1.1<新>)
1.表升级
(1).在V1.1中读取当前的数据库版本，如果v1.1 版本的数据版本大于1.0中的数据版本，则去检查 v1.1中的新加的表是否在v1.0中是否存在。

public static boolean checkTableExist(SQLiteDatabase db, String tableName) {
        boolean result = false;
        Cursor cursor = null;
        try {
            cursor = db.rawQuery("SELECT count(*) FROM sqlite_master where type='table' AND name='" + tableName + "'"
                    , null);
            cursor.moveToFirst();
            result = cursor.getInt(0) > 0;
        } catch (Exception e) {
            Log.e("checkTableExist...", e.toString());
        } finally {
            if (null != cursor && !cursor.isClosed()) {
                cursor.close();
            }
        }
        return result;
    }

说明: sqlite_master 表, 这个表示系统表。sqlitedatabase会为每一个数据库创建一个这样的表，目的是用来记录用户自己创建的表的索引。如果用户进行了表的增删改查操作，这个表都会相应的进行索引的改动。

2.字段升级
也就是对数据库中表中的列进行判断，关键 是
cursor.getColumnIndex(columnName)这个一段语句，判断它是否等于-1即可。如果为-1,证明该表中没有这一列，反之存在。

public static boolean checkColumnExist(SQLiteDatabase db, String tableName, String columnName) {
        boolean result = false;
        Cursor cursor = null;
        try {
            cursor = db.rawQuery("SELECT * FROM " + tableName + " LIMIT 0"
                    , null);
            result = cursor != null && cursor.getColumnIndex(columnName) != -1;
        } catch (Exception e) {
            log.error("checkColumnExists...", e);
        } finally {
            if (null != cursor && !cursor.isClosed()) {
                cursor.close();
            }
        }
        return result;
    }

三.实例

1.在SQLiteOpenHelper子类中
新版本号和老版本号都会作为onUpgrade函数的参数传进来，便于开发者知道数据库应该从哪个版本升级到哪个版本。

 //数据库版本号改变时调用
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
     DatabaseManager databaseManager = DatabaseManager.getInstance();
        databaseManager.upgrade(db, oldVersion);//比较版本号
    }

2.DatabaseNodeAbstract类：
版本比较的基类

public abstract class DatabaseNodeAbstract {

    private int version;

    protected DatabaseNodeAbstract(int version) {
        this.version = version;
    }

    public boolean canUpgrade(int oldVersion) {
        return oldVersion < version;
    }

    public abstract void upgrade(SQLiteDatabase database);

}

3.DatabaseManager 类
管理数据库升级

public class DatabaseManager {
    private static DatabaseManager instance;
    private List databaseNodeAbstractList;

    private DatabaseManager() {
        databaseNodeAbstractList = new LinkedList();
        databaseNodeAbstractList.add(new RuntimeDatabaseUpgrade2());

    }

    public static DatabaseManager getInstance() {
        if (instance == null) {
            instance = new DatabaseManager();
        }
        return instance;
    }

    public void upgrade(SQLiteDatabase database, int oldVersion) {
        for (DatabaseNodeAbstract node : databaseNodeAbstractList) {
            if (node.canUpgrade(oldVersion)) {//如果旧版本小于当前的版本，则执行更新操作
                database.beginTransaction();
                try {
                    node.upgrade(database);
                    database.setTransactionSuccessful();
                } catch (Exception ex) {
                } finally {
                    database.endTransaction();
                }
            }
        }
    }
}

4.进行表升级判断

public class RuntimeDatabaseUpgrade2 extends DatabaseNodeAbstract {

    protected RuntimeDatabaseUpgrade2() {
        super(2);//由此传递版本号，当前数据库版本号为2，旧版本的为1
    }

    @Override
    public void upgrade(SQLiteDatabase database) {
    //判断 TABLE表是否存在，不存在则创建该表
        if (!SqlHelper.checkTableExist(database, TABLE)) {
            TestRepository.onCreate(database);
        }
    }

}