SQLite数据库版本升级的管理实现

我们知道在SQLiteOpenHelper的构造方法:

super(Context context,String name,SQLiteDatabase.CursorFactory factory,int version)

onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion)

所以我们的重点是在该方法中实现SQLite数据库版本升级的管理

当我们项目刚开始的时候第一版SQLiteOpenHelper是这样写的:

package cc.database;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
import android.database.sqlite.SQLiteOpenHelper;
/**
 * Demo描述:
 * SQLite数据库版本升级的管理实现
 * 
 * 参考资料:
 * http://blog.csdn.net/guolin_blog
 * Thank you very much
 */
public class DataBaSEOpenHelper extends SQLiteOpenHelper {
    private final static String DATABASE_NAME="test.db";
    private static DataBaSEOpenHelper mDataBaSEOpenHelper;
    
    public static final String CREATE_PERSON=
    "create table person(personid integer primary key autoincrement,name varchar(20),phone VARCHAR(12))";
    
	public DataBaSEOpenHelper(Context context,CursorFactory factory,int version) {
		super(context,name,factory,version);
	}

	
	//注意:
	//将DataBaSEOpenHelper写成单例的.
	//否则当在一个for循环中频繁调用openHelper.getWritableDatabase()时
	//会报错,提示数据库没有执行关闭操作
	static synchronized DataBaSEOpenHelper getDBInstance(Context context) {
		if (mDataBaSEOpenHelper == null) {
			mDataBaSEOpenHelper = new DataBaSEOpenHelper(context,DATABASE_NAME,null,1);
		}
		return mDataBaSEOpenHelper;
	} 
	
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL(CREATE_PERSON);
	}

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

}

在几天之后根据项目需求，需要添加一张student表，于是DataBaSEOpenHelper就出现了第二版:

package cc.database;

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

public class DataBaSEOpenHelper extends SQLiteOpenHelper {
    private final static String DATABASE_NAME="test.db";
    private static DataBaSEOpenHelper mDataBaSEOpenHelper;
    
    public static final String CREATE_PERSON=
    "create table person(personid integer primary key autoincrement,phone VARCHAR(12))";
    
    public static final String CREATE_STUDENT=
    "create table student(studentid integer primary key autoincrement,提示数据库没有执行关闭操作
	static synchronized DataBaSEOpenHelper getDBInstance(Context context) {
		if (mDataBaSEOpenHelper == null) {
			//改动1
			mDataBaSEOpenHelper = new DataBaSEOpenHelper(context,2);
		}
		return mDataBaSEOpenHelper;
	} 
	
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL(CREATE_PERSON);
		//改动2
		db.execSQL(CREATE_STUDENT);
	}

	@Override
	public void onUpgrade(SQLiteDatabase db,int newVersion) {
		//改动3
		switch (oldVersion) {
		
		case 1:
		db.execSQL(CREATE_STUDENT);

		default:
		}
	}

}

1 版本号变成了2

2 在onCreate()方法中添加了代码db.execSQL(CREATE_STUDENT);创建student表

因为有的用户根本就没有第一版本的APP，直接从市场下载了第二版本的App。所以当然会执行onCreate()而不会执行onUpgrade()

3 在onUpgrade()做了处理：当oldVersion为1时调用db.execSQL(CREATE_STUDENT);创建student表

因为有的用户手机上本来就有第一版本的APP，所以在App升级到第二版本时会执行onUpgrade()，不会执行onCreate()

通过这样的处理使得不同的情况下使用第二版APP时都会生成student表

又过了一个月，根据项目变更，需要给person表添加一个字段genderid，于是DataBaSEOpenHelper就出现了第三版:

package cc.database;

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

public class DataBaSEOpenHelper extends SQLiteOpenHelper {
    private final static String DATABASE_NAME="test.db";
    private static DataBaSEOpenHelper mDataBaSEOpenHelper;
    
    //改动1
    public static final String CREATE_PERSON=
    "create table person(personid integer primary key autoincrement,phone VARCHAR(12)),genderid integer)";
    
    public static final String ALTER_PERSON="alter table person add column genderid integer";
    
    public static final String CREATE_STUDENT=
    "create table student(studentid integer primary key autoincrement,提示数据库没有执行关闭操作
	static synchronized DataBaSEOpenHelper getDBInstance(Context context) {
		if (mDataBaSEOpenHelper == null) {
			//改动2
			mDataBaSEOpenHelper = new DataBaSEOpenHelper(context,3);
		}
		return mDataBaSEOpenHelper;
	} 
	
	@Override
	public void onCreate(SQLiteDatabase db) {
		db.execSQL(CREATE_PERSON);
		db.execSQL(CREATE_STUDENT);
	}

	@Override
	public void onUpgrade(SQLiteDatabase db,int newVersion) {
		switch (oldVersion) {
		
		case 1:
		db.execSQL(CREATE_STUDENT);
		
		//改动3
		case 2:
	    db.execSQL(ALTER_PERSON);

		default:
		}
	}

}

较版本二在版本三中有三处修改的地方：

1 改变了CREATE_PERSON语句，在改语句中增加了一个字段genderid

和前面的描述类似，有的用户第一次安装该APP时就直接下载了第三版

2 修改版本号为3

应对了用户从第一版本或者第二版本升级到第三版本的情况(见下分析)

3 在onUpgrade()方法中)做了处理：当oldVersion为2时调用db.execSQL(ALTER_PERSON);修改person表，增加genderid字段

应对了用户从第二版本升级到第三版本的情况(见下分析)

注意一个问题：为什么这里的switch语句在每个case中没有break？？？

这是为了保证跨版本升级的时候每次数据库的升级都会执行到。

比如从第二版升级到第三版本，那么case 2会被执行。

比如从第一版直接升级到第三版本，那么case 1肯定会被调用，由于没有break所以会穿透switch语句又执行case 2语句继续升级，从而保证了数据的所有版本中的升级都会被执行到。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!