Android笔记——数据库升级与降级

一、概述

      SQLite是Android内置的一个很小的关系型数据库。SQLiteOpenHelper是一个用来辅助管理数据库创建和版本升级问题的抽象类。我们可以继承这个抽象类，实现它的一些方法来对数据库进行自定义操作。下面两个方法必须重写：

public void onCreate(SQLiteDatabase db)

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)

SQLiteOpenHelper里的onCreate执行：

1.只在数据库还没有建立时运行一次.如果数据库已经存在了，就不再执行onCreate方法，即在第一次打开数据库的时候才会执行

2.在清除数据之后再次运行-->打开数据库，这个方法会执行

3.没有清除数据，不会执行这个方法

4.数据库升级的时候这个方法不会执行，想执行需要先删除数据，再调用onCreate方法

onUpgrade的执行：

1.第一次创建数据库的时候，这个方法不会执行

2.清除数据后再次运行(相当于第一次创建)这个方法不会执行

3.数据库已经存在，而且版本升高的时候，这个方法才会调用，但不会自动执行onCreate

onDowngrade的执行：

1.执行数据库的降级操作

2.只有新版本比旧版本低的时候才会执行

3.如果不执行降级操作，会抛出异常

 

二、升级数据库

public class MyDatabaseHelper extends SQLiteOpenHelper{

    public static final String CREATE_BOOK="create table BOOK("
            +"id integer primary key autoincrement,"
            +"author text,"
            +"price real,"
            +"pages integer,"
            +"name text,"
            +"category_id integer)";
    public static final String CREATE_CATECORY="create table Category("
            +"id integer primary key autoincrement,"
            +"category_name text"
            +"category_code integer)";
    private Context mContext;
    public MyDatabaseHelper(Context context, String name,
            CursorFactory factory, int version) {
        super(context, name, factory, version);
        mContext=context;
    }

    @Override//创建数据库是调用
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
        db.execSQL(CREATE_CATECORY);
        Toast.makeText(mContext, "Create succeeded", Toast.LENGTH_SHORT).show();
    }

    @Override//版本更新时调用
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        //Log.i("db","测试");
        switch(oldVersion){
        case 1://版本1升级版本二是执行上面的创建表的语句
            db.execSQL(CREATE_CATECORY);
            Log.i("db","创建成功表Category成功");
        case 2://版本2升级版本3时执行向Book表中添加一个字段
            db.execSQL("alter table Book add column category_id integer");
            Log.i("db","添加字段成功");
            default:
        }
    }
}

   可以看到，在 onCreate()方法里我们新增了一条建表语句，然后又在 onUpgrade()方法中添加了一个 switch 判断，如果用户当前数据库的版本号是 1，就只会创建一张 Category 表。这样当用户是直接安装的第二版的程序时，就会将两张表一起创建。而当用户是使用第二版的程序覆盖安装第一版的程序时，就会进入到升级数据库的操作中，此时由于 Book 表已经存在了，因此只需要创建一张 Category 表即可。

   可以看到，首先我们在 Book 表的建表语句中添加了一个 category_id 列，这样当用户直接安装第三版的程序时，这个新增的列就已经自动添加成功了。然而，如果用户之前已经安装了某一版本的程序，现在需要覆盖安装，就会进入到升级数据库的操作中。在 onUpgrade() 方法里，我们添加了一个新的 case，如果当前数据库的版本号是 2，就会执行 alter 命令来为Book 表新增一个 category_id 列。

       这里请注意一个非常重要的细节，switch 中每一个 case 的最后都是没有使用 break 的，为什么要这么做呢？这是为了保证在跨版本升级的时候，每一次的数据库修改都能被全部执行到。比如用户当前是从第二版程序升级到第三版程序的，那么 case 2 中的逻辑就会执行。而如果用户是直接从第一版程序升级到第三版程序的，那么 case 1 和 case 2 中的逻辑都会执行。使用这种方式来维护数据库的升级，不管版本怎样更新，都可以保证数据库的表结构是最新的，而且表中的数据也完全不会丢失了。

三、降级

private static final String DB_NAME = "mydata.db"; // 数据库名称
    private static final int version = 2; // 数据库版本

    public MyDatabaseOpenHelper(Context context) {
        super(context, DB_NAME, null, version);
    }

    // 问题：什么时候执行
    // 没有前生
    @Override
    public void onCreate(SQLiteDatabase db) {
        // TODO Auto-generated method stub
        // 编写【从0开始到最新状态】建表语句
        Log.i("hi", "没有数据库，创建数据库，创建v2.0成功");
        String sql_message = "create table t_message (id int primary key,tou1  varchar(50),userName varchar(50),lastMessage varchar(50),datetime  varchar(50))";
        String sql_init_1 = "insert into t_message values (1,'abc','abc1','abcd1','hi1')";
        String sql_init_2 = "insert into t_message values (2,'abc','abc2','abcd2','hi1')";
        String sql_init_3 = "insert into t_message values (3,'abc','abc2','abcd2','hi1')";
        db.execSQL(sql_message);
        db.execSQL(sql_init_1);
        db.execSQL(sql_init_2);
        db.execSQL(sql_init_3);

    }

    // v2.0 现在进行时
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        
        if (oldVersion == 2){
            String sql_upgrade_1 = "alter table t_message add column isdel bit default 0";
            db.execSQL(sql_upgrade_1);
            Log.i("db", "从2到3，升级成功！");
        }
//        
        if (oldVersion == 1) {
            Log.i("db", "从1到3，升级成功！");
            String sql_upgrade_1 = "alter table t_message add column isdel bit default 0";
            db.execSQL(sql_upgrade_1);
            String sql_init_1 = "insert into t_message values (1,'abc','abc1','abcd1','hi1',0)";
            String sql_init_2 = "insert into t_message values (2,'abc','abc2','abcd2','hi1',0)";
            String sql_init_3 = "insert into t_message values (3,'abc','abc2','abcd2','hi1',0)";
            db.execSQL(sql_init_1);
            db.execSQL(sql_init_2);
            db.execSQL(sql_init_3);
            Log.i("db", "从1到3，升级成功！");
        }
    }

/* 模拟从3.0 降低会2.0 */
    @Override
    public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        //正常来讲大于2.0的，应该有t_message 这张表，且2.0有的字段，3.0都有
        try {
            //第一、先把t_message 未来的表，改名
            String rename_sql = "alter table t_message rename to t_message_bak";
            db.execSQL(rename_sql);
            Log.i("down", "1.改名成功");
            //第二、建立2.0的表结构
            String sql_message = "create table t_message (id int primary key,tou1  varchar(50),userName varchar(50),lastMessage varchar(50),datetime  varchar(50))";
            db.execSQL(sql_message);
            Log.i("down", "2.建立2.0表结构成功");
            //第三、把备份的数据，copy到 新建的2.0的表
            String sql_copy = "insert into t_message select id,tou1,userName,lastMessage,datetime from t_message_bak";
            db.execSQL(sql_copy);
            Log.i("down", "3.copy到用户数据到 2.0的表");
            //第四、把备份表drop掉
            String drop_sql = "drop table if exists t_message_bak";
            db.execSQL(drop_sql);
            Log.i("down", "4.把备份表drop掉");
            
        } catch (Exception e) {
            //失败
            Log.i("hi", "降级失败，重新建立");
            String sql_drop_old_table = "drop table if exists t_message";
            String sql_message = "create table t_message (id int primary key,tou1  varchar(50),userName varchar(50),lastMessage varchar(50),datetime  varchar(50))";
            String sql_init_1 = "insert into t_message values (1,'abc','abc1','abcd1','hi1')";
            String sql_init_2 = "insert into t_message values (2,'abc','abc2','abcd2','hi1')";
            String sql_init_3 = "insert into t_message values (3,'abc','abc2','abcd2','hi1')";
            db.execSQL(sql_drop_old_table);
            db.execSQL(sql_message);
            db.execSQL(sql_init_1);
            db.execSQL(sql_init_2);
            db.execSQL(sql_init_3);
        }
    }

 代码说明，这就不说了！