Android之数据库升级onUpgrade降级onDowngrade

借用API文档解释：

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

当数据库需要升级时，会调用这个方法。应该使用这个方法来实现删除表、添加表或者做一些需要升级新的策略版本的事情。

SQLite ALTER TABLE的文档可以在以下网址中找到：

http://sqlite.org/lang_altertable.html

如果要给表添加一个新列，那么使用使用ALTER TABLE能够把新列插入到表中。如果要重命名或删除列，那么你能够使用ALTER TABLE能够重命名旧表，然后，创建一个新表，并把旧表中内容复制到新表中。

这个方法是事务中执行的，如果有异常被抛出，所有的改变都会被自动的回滚。

参数：

db：指定要降级的数据库

oldVersion：旧的数据库版本

newVersion：新的数据库版本

总结：

　　

v1.0
　　1.没有安装过 onCreate()

--------------------------------------
v2.0 [onUpgrade 情况：n-1,onCreate 情况：1]
　　1.v1.0 --> v2.0 onUpgrade
　　2.没有安装过 onCreate()
-----------------------------------------
v3.0 [onUpgrade 情况：n-1,onCreate 情况：1]
　　1. v1.0 -->v3.0 onUpgrade
　　　　alter table t_message add column isdel bit default 0;
　　插入数据
　　* 2. v2.0 -->v3.0 onUpgrade
　　　　alter table t_message add column isdel bit default 0;
　　3. 没有安装过 onCreate()

---

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

当数据库需要被降级时，调用这个方法。这个方法与onUpgrade(SQLiteDatabase, int, int)方法非常相似，但是它是在当前版本比请求的版本新的时候，才会被调用。但是这个方法不是抽象的，因此它不是强制要求客户实现它的。如果这个方法没有被重写，默认的实现会拒绝降级处理，并抛出SQLiteException异常。

这个方法是在事务中执行的。如果有异常被抛出，所有的改变都会被回滚。

参数：

db：指定要降级的数据库

oldVersion：旧的数据库版本

newVersion：新的数据库版本

总结：

降级的设计关键点
　　1、考虑云端要保存用户【自定义数据、行为习惯】。专业术语profile-->>提高用户黏度
　　2、考虑[当前]的最低版本要求-->>降低维护成本
　　3、尽可能本地的数据转移（所有新版本，都不删除字段）-->尽可能把未知变已知
　　try catch

下面是老师上课的案例：

---

package com.example.winxin2;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;

public class MyDatabaseOpenHelper extends SQLiteOpenHelper {

    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) {
            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);
        }
    }
    
}

我自己总结了一下：

　　1、创建一个继承SQLiteOpenHelper 的类，实现未实现的方法

　　2、里面方法采用回调函数，当触发时，系统会自动调用，不用我们手动调

　　3、onCreate()方法写最新版本的数据库创建和初始化

　　4、onUpgrade()方法写版本更新时数据库更新代码（考虑新客户和老客户，如果太久远的版本可以直接放弃维护，直接弹框要求用户更新最新版本）

　　5、onDowngrade()方法注意需要保存关键数据，和try catch

还有很多的不懂，如发现有错，留言告诉我，大家互相学习