由於Android的數據庫SQLite是自帶的,故隨着我們的應用App升級,相對應的數據庫裏面的內容發生改變時也要隨之升級,升級的時候希望的是之前保存的數據不丟失的情況下對其進行升級。這時就要用到Andoird的SQLiteOpenHelper類中有一個onUpgrade方法,當前數據庫版本變化時就觸發該方法對數據庫進行升級。
1. 數據庫升級是指什麼?
你開發了一個程序,當前是1.0版本。該程序用到了數據庫。到1.1版本時,你在數據庫的某個表中增加了一個字段。那麼軟件1.0版本用的數據庫在軟件1.1版本就要被升級了。
2. 數據庫升級應該注意什麼?
軟件的1.0版本升級到1.1版本時,老的數據不能丟。那麼在1.1版本的程序中就要有 地方能夠檢測出來新的軟件版本與老的數據庫不兼容,並且能夠有辦法把1.0軟件的數據庫升級到1.1軟件能夠使用的數據庫。換句話說,要在1.0軟件的數 據庫的那個表中增加那個字段,並賦予這個字段默認值。
3. 程序如何知道數據庫需要升級?
SQLiteOpenHelper類的構造函數有一個參數是int version,它的意思就是指數據庫版本號。比如在軟件1.0版本中,我們使用SQLiteOpenHelper訪問數據庫時,該參數爲1,那麼數據庫版本號1就會寫在我們的數據庫中。
到了1.1版本,我們的數據庫需要發生變化,那麼我們1.1版本的程序中就要使用一個大於1的整數來構造SQLiteOpenHelper類,用於訪問新的數據庫,比如2。
當我們的1.1新程序讀取1.0版本的老數據庫時,就發現老數據庫裏存儲的數據庫版本是1,而我們新程序訪問它時填的版本號爲2,系統就知道數據庫需要升級。
4. 何時觸發數據庫升級?如何升級?
當系統在構造SQLiteOpenHelper類的對象時,如果發現版本號不一樣,就會自動調用onUpgrade函數,讓你在這裏對數據庫進行升級。根據上述場景,在這個函數中把老版本數據庫的相應表中增加字段,並給每條記錄增加默認值即可。新版本號和老版本號都會作爲onUpgrade函數的參數傳進來,便於開發者知道數據庫應該從哪個版本升級到哪個版本。升級完成後,數據庫會自動存儲最新的版本號爲當前數據庫版本號。
SQLiteOpenHelper是SQLiteDatabase的一個幫助類,用來管理數據庫的創建和版本的更新。一般是建立一個類繼承它,並實現它的onCreate和onUpgrade方法。
以下面的代碼爲例:
第一次創建數據庫,版本號爲1:
public class CopyOfDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "scxh1502.db"; // 數據庫名
private static final int DB_VERSION = 1; // 數據庫版本號
private static CopyOfDatabaseHelper DB_HELPER = null;
public static CopyOfDatabaseHelper getInstanceDatabaseHelper(Context context) {
if (DB_HELPER == null) {
DB_HELPER = new CopyOfDatabaseHelper(context);
}
return DB_HELPER;
}
public CopyOfDatabaseHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
/**
* 數據庫創建時執行
*/
@Override
public void onCreate(SQLiteDatabase db) {
String sql = "create table " + DataColumn.Student.TABLE_NAME + " ("
+ DataColumn.Student._ID
+ " INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,"
+ DataColumn.Student.COLUMN_NAME_NAME + " TEXT, "
+ DataColumn.Student.COLUMN_NAME_NUMBER + " TEXT " + ")";
db.execSQL(sql);
}
/**
* 數據庫版本發生變化
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}
第一次數據庫升級,版本號爲2,添加一個Age字段:
public class CopyOfDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "scxh1502.db"; //數據庫名
private static final int DB_VERSION = 2; //數據庫版本號
private static CopyOfDatabaseHelper DB_HELPER = null;
public static CopyOfDatabaseHelper getInstanceDatabaseHelper(Context context) {
if (DB_HELPER == null) {
DB_HELPER = new CopyOfDatabaseHelper(context);
}
return DB_HELPER;
}
public CopyOfDatabaseHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
/**
* 數據庫創建時執行
*/
@Override
public void onCreate(SQLiteDatabase db) {
String sql = "create table "+DataColumn.Student.TABLE_NAME
+ " ("
+ DataColumn.Student._ID + " INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,"
+ DataColumn.Student.COLUMN_NAME_NAME + " TEXT, "
+ DataColumn.Student.COLUMN_NAME_NUMBER + " TEXT "
+ ")";
db.execSQL(sql);
}
/**
* 數據庫版本發生變化
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
String sql = "Alter table "+DataColumn.Student.TABLE_NAME+" add column "+DataColumn.Student.COLUMN_NAME_AGE+" TEXT ";
db.execSQL(sql);
}
}
第二次升級數據庫,版本號爲3,添加一個成績字段:
public class CopyOfDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "scxh1502.db"; //數據庫名
private static final int DB_VERSION = 3; //數據庫版本號
private static CopyOfDatabaseHelper DB_HELPER = null;
public static CopyOfDatabaseHelper getInstanceDatabaseHelper(Context context) {
if (DB_HELPER == null) {
DB_HELPER = new CopyOfDatabaseHelper(context);
}
return DB_HELPER;
}
public CopyOfDatabaseHelper(Context context) {
super(context, DB_NAME, null, DB_VERSION);
}
/**
* 數據庫創建時執行
*/
@Override
public void onCreate(SQLiteDatabase db) {
String sql = "create table "+DataColumn.Student.TABLE_NAME
+ " ("
+ DataColumn.Student._ID + " INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,"
+ DataColumn.Student.COLUMN_NAME_NAME + " TEXT, "
+ DataColumn.Student.COLUMN_NAME_NUMBER + " TEXT "
+ ")";
db.execSQL(sql);
}
/**
* 數據庫版本發生變化
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
if(oldVersion < 2){//當數據庫版本小於版本2時,就要升級下面的所有字段
String sql = "Alter table "+DataColumn.Student.TABLE_NAME+" add column "+DataColumn.Student.COLUMN_NAME_AGE+" TEXT ";
db.execSQL(sql);
}
//當前版本爲2時就只升級下面的字段
String sql1 = "Alter table "+DataColumn.Student.TABLE_NAME+" add column "+DataColumn.Student.COLUMN_NAME_SCORE+" TEXT ";
db.execSQL(sql1);
}
}
升級數據庫時我們就要考慮全面,若不加上判斷語句判斷版本號,若之前2版本用戶沒有升級就直接升級到3,就會漏掉字段,故升級時所有的情況都應該考慮進去。
Android應用程序更新的時候如果數據庫修改了字段需要更新數據庫,並且保留原來的數據庫數據:
這是原有的數據庫表
CREATE_BOOK = "create table book(bookId integer primarykey,bookName text);";
然後我們增加一個字段:
CREATE_BOOK = "create table book(bookId integer primarykey,bookName text,bookContent text);";
首先我們需要把原來的數據庫表重命名一下
CREATE_TEMP_BOOK = "alter table book rename to _temp_book";
然後把備份表中的數據copy到新創建的數據庫表中
INSERT_DATA = "insert into book select *,' ' from _temp_book";(注意' '是爲新加的字段插入默認值的必須加上,否則就會出錯)。
然後我們把備份表幹掉就行啦。
DROP_BOOK = "drop table _temp_book";
然後把數據庫的版本後修改一下,再次創建數據庫操作對象的時候就會自動更新(注:更新的時候第一個創建的操作數據的對象必須是可寫的,也就是通過這個方法getWritableDatabase()獲取的數據庫操作對象)
然後在onUpgrade()方法中執行上述sql語句就OK了
public class DBservice extends SQLiteOpenHelper{
private String CREATE_BOOK = "create table book(bookId integer primarykey,bookName text);";
private String CREATE_TEMP_BOOK = "alter table book rename to _temp_book";
private String INSERT_DATA = "insert into book select *,'' from _temp_book";
private String DROP_BOOK = "drop table _temp_book";
public DBservice(Context context, String name, CursorFactory factory,int version) {
super(context, name, factory, version);
}
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL(CREATE_BOOK);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
switch (newVersion) {
case 2:
db.beginTransaction();
db.execSQL(CREATE_TEMP_BOOK);
db.execSQL(CREATE_BOOK);
db.execSQL(INSERT_DATA);
db.execSQL(DROP_BOOK);
db.setTransactionSuccessful();
db.endTransaction();
break;
}
}