随着我们系统的升级,数据库一般也要跟着一起变化。Android 中的 SQLite数据库根据数据库版本号来判断是否进行了升级。当数据库版本号发生变化后,Android 系统会调用 SQLiteOpenHelper 的
ouUpgrade 函数,然后我们在该函数中对版本号进行判断,再根据版本号执行对应的升级数据库的 SQL 语句。

数据库升级主要是调用SQLiteOpenHelper 中的onUpgrade方法

/**
 * Created by : xiaoyehai
 * Create date : 2019/9/11 20:33
 * description :数据库管理类,负责管理数据库的创建、升级工作
 */
public class MyDbHelper extends SQLiteOpenHelper {

    //数据库名字
    public static final String DB_NAME = "my.db";

    //数据库版本
    public static final int DB_VERSION = 1;

    public MyDbHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    /**
     * 在数据库首次创建的时候调用,创建表以及可以进行一些表数据的初始化
     *
     * @param db
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        //创建表
        //_id为主键并且自增长一般命名为_id
        String sql = "create table person(_id integer primary key autoincrement,name text)";
        db.execSQL(sql);

        //可以给表初始化一些数据
        //db.execSQL("insert into person(name) values('小米')");
    }

    /**
     * 数据库升级的时候回调该方法,在数据库版本号DB_VERSION升级的时候才会调用
     *
     * @param db
     * @param oldVersion
     * @param newVersion
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

        //给表添加一个字段
        //db.execSQL("alter table person add age integer");
    }

    /**
     * 数据库打开的时候回调该方法
     *
     * @param db
     */
    @Override
    public void onOpen(SQLiteDatabase db) {
        super.onOpen(db);
        Log.e("xyh", "onOpen: ");
    }
}


在版本迭代的过程中,我们难免不了要去改变我们数据库的内容,此时就要考虑我们的数据库升级问题了,假如此时我们有个需求,要在新的版本中在数据库表中新加一个字段,首先我们要把DB_VERSION提升到加1,那么安装新版本APK的时候就会执行onUpdate()操作去执行更新操作,我们要考虑各个版本的情况,比如用户没有安装过1.0版本,直接安装的2.0版本,那么这种情况是不会执行onUpdate()方法的。

注意:数据库的版本号只能升级,不能降级,例如不能将数据库版本号从2降到1。

用户直接安装2.0版本(新用户):只走onCreat();不走onUpgrade()。

1.0 更新到2.0版本(老用户):只走onUpgrade(),不走onCreat()。

先看下这时的处理有几种情况要考虑:

1. 在老表基础上新增字段

SQLite提供了ALTER TABLE命令,允许用户重命名或添加新的字段到已有表中,但是不能从表中删除字段。并且只能在表的末尾添加字段

新用户会直接走onCreate执行新表的创建sql,老用户走onUpgrade新增字段。

/**
     * 直接安装2.0版本,会走该方法
     * <p>
     * 要执行新表的创建sql(针对新用户)
     *
     * @param db
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);

    }

    /**
     * 1.0 更新到2.0版本,会走该方法
     *
     * @param db
     * @param oldVersion
     * @param newVersion
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("alter table person add age integer");
    }


还有一种方式:

  1. 将老表A改名变为临时表temp_A

  2. 创建新表命名为A

  3. 临时表temp_A数据导入新表

  4. 删除临时表

当然,如果遇到减少字段的情况,也可以通过创建临时表的方式来实现。

@Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);


    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

        //老的表重命名
        String CREATE_TEMP_PPERSON = "alter table person rename to temp_person";

        //创建新的表,表名跟原来一样,并保留原来的字段和增加新的字段
        String CREATE_PPERSON  = "create table person(_id integer primary key autoincrement,name text,age integer)";
        
        //将重命名后的老表中的数据导入新的表中
        String INSERT_DATA = "insert into book select *,'' from _temp_book";
        
        //删除老表
        String DROP_PPERSON  = "drop table _temp_book";
        
        db.execSQL(CREATE_TEMP_PPERSON);
        db.execSQL(CREATE_PPERSON);
        db.execSQL(INSERT_DATA);
        db.execSQL(DROP_PPERSON);


    }

2. 新版本新增一张表

 @Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);
		
		//针对新用户
        String sql2 = "create table person2(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql2);

    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        String sql = "create table person2(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);

    }

3. 新表跟以前的表字段结构完全不一样

这种情况是新表跟以前字段结构完全不一样或者说有大部分的差异,老表改名为临时表,创建新表,手动查询老表的某些字段的数据然后插入的新表的对应字段,最后删除老表即可。这与上面在老表基础上新增字段的另外一种方式是一样的。

跨版本升级

前面几种情况是单级升级的时候,针对上次的版本本次的版本需要做的处理,如果是跨级升级,比如用户app很久没有更新了,这次升级数据库版本从1升到了3,应该先升级到2再升级到3这种情况,或者2升到了6,这时需要分开处理每次的版本:

 //数据库名字
    public static final String DB_NAME = "my.db";

    //数据库版本
    public static final int DB_VERSION = 3;

    public MyDbHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {

        //第一个版本安装,直接创建表
        //String sql = "create table person(_id integer primary key autoincrement,name text)";
        //db.execSQL(sql);

        // 若不是第一个版本安装,直接执行数据库升级
        // 请不要修改FIRST_DATABASE_VERSION的值,其为第一个数据库版本大小
        int FIRST_DB_VERSION = 1;
        onUpgrade(db, FIRST_DB_VERSION, DB_VERSION);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

        for (int i = oldVersion; i < newVersion; i++) {
            // 使用for实现跨版本升级数据库
            switch (oldVersion) {
                case 1:
                    upgradeToVersion2(db); //升级到2版本
                    break;
                case 2:
                    upgradeToVersion3(db); //升级到3版本
                    break;
                default:
                    break;
            }
        }
    }

    private void upgradeToVersion2(SQLiteDatabase db) {
        // 表新增1个字段
        db.execSQL("alter table person add age integer");
    }

    private void upgradeToVersion3(SQLiteDatabase db) {
        // student 表新增2个字段, 添加新字段只能一个字段一个字段加,sqlite有限制不予许一条语句加多个字段
    }

如果用户是从1.0升到2.0的,那么会直接执行onUpdate(),此时oldVersion是1,执行for循环中的 upgradeToVersion2(db),如果用户没有装过1.0版本而是直接安装的2.0版本,那么会执行onCreate()方法,在onCreate()中手动调用的onUpdate()方法去执行更新操作,这样就兼容到了各种需求,同时升级到3.0、4.0版本都是可以兼容的。

但是如果版本跨级比较多,这个地方可能比较费时了,建议在可控的版本差之内强制app版本升级。

Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐