SQLite資料庫版本升級
一.簡介
我們在開發應用的時候，儲存資料可能會用到資料庫。第一個版本時所設計的資料庫結構，如果在以後的app版本中需要增加業務邏輯，資料庫的表可能要做相應的修改，那麼原來的資料庫結構就不能用了，這時就需要對資料庫進行升級。
二.升級方案
1.讓使用者將應用解除安裝然後再安裝最新版本的app
2.對資料庫進行升級
對於第一種方案，使用者解除安裝老版本就會造成資料丟失，這樣對於使用者的體驗性極差，不到萬不得已的時候不要做。
我們傾向於選擇第二項方案。
三.不同版本升級分析
3.1.Version1.0
當我們開發第一個版本資料庫的時候，SQLiteOpenHelper的繼承類裡會走onCreate()方法，即 —->v1.0 走onCreate()，這時候並不涉及更新的方法。
3.2.Version2.0
當我們開發到第二個資料庫版本的時候，分兩種情況：
(1) 使用者從1.0版本升級到2.0版本 SQLiteOpenHelper的繼承類裡會走onUpgrade()方法,不走onCreate()方法。即v1.0—->v2.0 走onUpgrade()；
(2) 如果是使用者直接安裝v2.0 ， SQLiteOpenHelper的繼承類裡會走onCreate()方法,不走onUpgrade()方法。即 —->v2.0 走onCreate()
3.3.Version3.0
(1) 使用者從1.0版本升級到3.0版本 ，SQLiteOpenHelper的繼承類裡會走onUpgrade()方法,不走onCreate()方法。即v1.0—->v3.0 走onUpgrade()
(2) 使用者從2.0版本升級到3.0版本 ，SQLiteOpenHelper的繼承類裡會走onUpgrade()方法,不走onCreate()方法。即v2.0—->v3.0 走onUpgrade()
(3) 如果是使用者直接安裝3.0 ，SQLiteOpenHelper的繼承類裡會走onCreate()方法,不走onUpgrade()方法。即 —->v3.0 走onCreate()
如下圖
只要是第一次安裝或者第一個資料庫版本的都走onCreate()方法，而不走onUpgrade()方法，從低版本升級到高版本的都走onUpgrade()方法而不走onCreate()方法。
四.程式碼分析
4.1第一個版本的資料庫
第一個版本只走onCreate()，所以我們可以把建立表的方法寫在這個方法裡，
@Override
public void onCreate(SQLiteDatabase db) {
try {
db.execSQL(DataBaseConfig.FIRST_VERSION_INFO);
} catch 另外需要注意的是，我們要把建立SQLiteOpenHelper子類的地方寫成單例模式，這樣可以避免重複建立，出現問題。
private static volatile MySqliteOpenHelper instance = null;
/**
* 第一個引數 context 上下文
* 第二個引數 name 資料庫名稱
* 第三個引數 factory 為了建立cursor物件, 預設為空
* 第四個引數 version 資料庫版本
* @param context
*/
private MySqliteOpenHelper(Context context) {
super(context, DataBaseConfig.DATABASE_NAME, null, DataBaseConfig.DATABASE_NEW_VERSION);
db = this.getWritableDatabase();//呼叫此方法時資料庫才算真正建立
}
/**
* 建立例項
*
* @param context
* @return
*/
public static MySqliteOpenHelper getDBHelper(Context context) {
if (instance == null) {
synchronized (MySqliteOpenHelper.class) {
if (instance == null)
instance = new MySqliteOpenHelper(context);
}
}
return instance;
}
@Override
public void onCreate(SQLiteDatabase db) {
try {
db.execSQL(DataBaseConfig.FIRST_VERSION_INFO);
} catch (Exception e) {
Log.e(tag,"e=="+e);
}
}
//第一個版本的sql
String FIRST_VERSION_INFO ="create table if not exists "+TABLE_TEST1+"( " +
" id varchar DEFAULT ''," +
" name varchar DEFAULT ''," +
" age varchar DEFAULT '')";此時的DataBaseConfig.DATABASE_NEW_VERSION 為1
如果以後的需求改變，需要往資料庫里加欄位或者改欄位，需要升級資料庫。
4.2第二個版本的資料庫
如果是從v1.0升級到v2.0，則走onUpgrade,如果是直接安裝v2.0，則走onCreate()
4.2.1. 比如從v1.0升級到v2.0 需要增加欄位
/**
* 新版本比舊版本高就會走這個方法
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
for (int i = oldVersion; i < newVersion; i++) {
switch (i) {
case DataBaseConfig.DATABASE_FIRST_VERSION:
addUpgradeToVersion2(db);//新增兩個欄位
break;
default:
break;
}
}
}
/**
* 新版本增加了兩個欄位
*
* @param db
*/
private void addUpgradeToVersion2(SQLiteDatabase db) {//注意新增兩個欄位時要分開寫
String sql1 = "ALTER TABLE " + DataBaseConfig.TABLE_TEST1 + " ADD COLUMN sex varchar";
String sql2 = "ALTER TABLE " + DataBaseConfig.TABLE_TEST1 + " ADD COLUMN address varchar";
db.execSQL(sql1);
db.execSQL(sql2);
}此時 新版本 DataBaseConfig.DATABASE_NEW_VERSION 為2 ，DataBaseConfig.DATABASE_FIRST_VERSION為1
版本2比版本1中新增了sex,和address欄位，圖中的列表中選項比版本1多了兩項，由於程式碼中預設的性別是女，所以前三個的性別是女，這個是測試所致。
還要再處理onCreate(),因為使用者可能是直接安裝V2.0
有兩種方法：
（1）執行舊版資料庫sql,則後面還要呼叫onUpgrade
@Override
public void onCreate(SQLiteDatabase db) {
try {
db.execSQL(DataBaseConfig.FIRST_VERSION_INFO);
onUpgrade(db,DataBaseConfig.DATABASE_FIRST_VERSION,DataBaseConfig.DATABASE_NEW_VERSION);
} catch (Exception e) {
Log.e(tag,"e=="+e);
}
}（2）執行新版資料庫sql，不需要呼叫onUpgrade
@Override
public void onCreate(SQLiteDatabase db) {
try {
db.execSQL(DataBaseConfig.NEW_VERSION_INFO);
} catch (Exception e) {
Log.e(tag,"e=="+e);
}
}
//增加兩個欄位
String NEW_VERSION_INFO ="create table if not exists "+TABLE_TEST1+"( " +
" id varchar DEFAULT ''," +
" name varchar DEFAULT ''," +
" age varchar DEFAULT '',"+
" sex varchar DEFAULT '',"+
" address varchar DEFAULT '')";4.2.2. 第二個版本資料庫需要新增並修改欄位
* 1. 比如從v1.0升級到v2.0 需要增加欄位*
新增sex,address欄位，修改age–>sign
/**
* 新版本比舊版本高就會走這個方法
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
for (int i = oldVersion; i < newVersion; i++) {
switch (i) {
case DataBaseConfig.DATABASE_FIRST_VERSION:
updateUpgradeToVersion2(db);//修改表原有欄位並新增欄位
break;
default:
break;
}
}
}
private void updateUpgradeToVersion2(SQLiteDatabase db) {
try{
db.beginTransaction();
// 1, 將表TABLE_TEST1重新命名為TABLE_TEST1+"_temp"
String tempTableName = DataBaseConfig.TABLE_TEST1 + "_temp";
String sql = "ALTER TABLE " + DataBaseConfig.TABLE_TEST1 + " RENAME TO " + tempTableName;
db.execSQL(sql);
// 2, 建立使用者表(欄位id、name改變、並新增了以個欄位phone)
db.execSQL(DataBaseConfig.NEW_VERSION_INFO);
// 3, 將舊錶資料匯入到新表中,舊錶中的id,name,age分別查到新表中的id,name,sign
sql = "INSERT INTO " + DataBaseConfig.TABLE_TEST1 + " (" + "id,name,sign" + ") " + " SELECT " + "id,name,age" + " FROM " + tempTableName;
db.execSQL(sql);
// 4, 刪除舊的表
db.execSQL("DROP TABLE IF EXISTS " + tempTableName);
db.setTransactionSuccessful();
db.setVersion(2);
}catch (SQLException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}finally {
db.endTransaction();
}
}此時 DataBaseConfig.DATABASE_NEW_VERSION 為2 ，DataBaseConfig.DATABASE_FIRST_VERSION為1
從圖中可以看出，將age修改為sign欄位，增加了sex,address兩項。
處理onCreate()方法同增加欄位裡的處理一致。
五.總結
本文總結了資料庫升級的相關內容，包括為什麼要升級資料庫，怎麼升級資料庫，新增欄位和修改欄位怎麼處理，如有發現問題，歡迎討論，共同學習。
Demo 原始碼地址：https://download.csdn.net/download/feibendexiaoma/10282319