上篇文章簡介和常用語法介紹了SQLite數據庫的基本信息和一些常用的語法操作，本篇文章主要介紹Android開發過程中SQLite數據庫的創建使用和常見問題處理。

一.SQLiteOpenHelper介紹

對于Android平臺來說，我們可以使用系統提供的API輕松實現對SQLite數據庫的操作

Android提供SQLiteOpenHelper類以便我們創建操作數據庫。通常情況下我們會新建一個SQLiteOpenHelper的子類作為一個數據庫的操作類。

數據庫操作類示例 :

DatabaseHelper

public class DatabaseHelper extends SQLiteOpenHelper {

/**

* 數據庫名稱

*/

private static final String DATABASE_NAME = "account.db";

/**

* 數據庫版本-升級用

*/

private static final int DATABASE_VERSION = 1;

public DatabaseHelper(Context context) {

//CursorFactory設置為null,使用默認值

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER)");

}

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

}

}

二.數據庫創建-構造方法

數據庫的創建以及版本，是由SQLiteOpenHelper的構造方法參數決定的。

SQLiteOpenHelper 有三個構造構造方法：

/**

* @param context 用來打開或者創建數據庫

* @param name 數據庫文件名稱或者傳null為一個內存數據庫

* @param factory 用來創建cursor對象或者傳null使用默認的

* @param version 數據庫版本號 (從1開始);如果數據庫版本比當前版舊，onUpgrade方法會被調用來更新數據庫，

如果比當前新onDowngrade方法會被調用來降級數據庫

*/

public SQLiteOpenHelper(Context context, String name, CursorFactory factory, int version) {

this(context, name, factory, version, null);

}

/**

* @param errorHandler DatabaseErrorHandler數據庫損壞時回調.

*/

public SQLiteOpenHelper(Context context, String name, CursorFactory factory,

int version, DatabaseErrorHandler errorHandler) {

this(context, name, factory, version, 0, errorHandler);

}

/**

* @param minimumSupportedVersion 支持調用onUpgrade更新到version版本的最版本號，

如果當前版本比最小支持的版本還下數據庫就會刪除然后重新創建version版本的數據庫。

在刪除前onBeforeDelete會被調用我們可以在此方法中做一些處理。minimumSupportedVersion 默認為0

* @hide

*/

public SQLiteOpenHelper(Context context, String name, CursorFactory factory,

int version, int minimumSupportedVersion, DatabaseErrorHandler errorHandler) {

if (version < 1) throw new IllegalArgumentException("Version must be >= 1, was " +

version);

mContext = context;

mName = name;

mFactory = factory;

mNewVersion = version;

mErrorHandler = errorHandler;

mMinimumSupportedVersion = Math.max(0, minimumSupportedVersion);

}

最終都會調用第三個構造方法，方法中判斷如果version 小于1會拋出異常，所以Android SQLite數據庫版本必須從1開始。實際上最后一個構造方法被@hide注解了，所以一般情況下在子類中我們是沒有辦法主動調用的，只能調用前兩個構造方法，minimumSupportedVersion 也始終是0。

三.數據庫首次創建回調-onCreate方法

數據庫首次創建的時候onCreate方法會被執行。表的創建和初始化需要在方法中進行。這個是抽象方法，實體類中必須實現。實現很簡單就是做一些創建表的操作。

示例：

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER)");

}

四.數據庫的升級-onUpgrade方法

/**

* @param db The database.

* @param oldVersion 舊數據庫版本

* @param newVersion 新數據庫版本

*/

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

當數據庫升級時(當前數據庫版本大于已創建的數據庫版本)會執行此方法，首次創建時不會執行。這是個抽象方法，在我們的實體類中必須實現。我們可以在這個方法中根據數據庫版本做一些刪除表，創建表，新增表字段或者重命名表等操作保證數據庫與最新版本數據庫同步。

常用數據庫升級操作：

數據庫的升級一般有三種方式如下：

1.onCreate方法始終保證是最新的，在onUpgrade方法中刪除所有已存在表，在調用onCreate中創建表的方法重新創建所有表，保證表是最新的。(當然如果你想保存數據也可以先將數據保存到內存再插入，如果表很多或者數據量很大的是不建議怎么操作的，非常影響性能)

2.onCreate方法始終保證是最新的，再onUpgrade方法中根據版本號判斷執行創建新表或者更新字段等操作

版本號需要 判斷上下限：

上限(為了再從當前版本x更新到新版本y時不重復執行更新操作)：假如我們要升級到新版本x，是我們的當前版本x，需要小于當前版本號x。

下限：如果是創建新表下限就是當前版本之前的所有版本，如果是更新表字段或者重命名表下限是表創建的版本需要大于等于下限版本

舉個栗子：

2.1. 在上面的示例我們創建了版本1數據庫，onCreate方法創建了表account，現在需要在表account中新增字段subAccountId并新增一個表subAccount。

按照上面的方式我們需要更新表版本號為假設為2(可以為更大的，不要求連續，連續方便之后的版本更新迭代)，在onCreate方法中修改原來創建表account的SQL新增字段subAccountId，同時新增創建表subAccount的SQL并執行。

然后在onUpgrade中判斷oldVersion版本號大于等于原版本1小于現版本2，執行新增字段和新增表SQL。

具體代碼如下：

public class DatabaseHelper extends SQLiteOpenHelper {

/**

* 數據庫名稱

*/

private static final String DATABASE_NAME = "account.db";

/**

* 數據庫版本-升級用

*/

private static final int DATABASE_VERSION = 2;

public DatabaseHelper(Context context) {

//CursorFactory設置為null,使用默認值

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER," +

"subAccountId VARCHAR default '')");

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER)");

}

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

if (oldVersion >= 1 && oldVersion < 2) {

db.execSQL("ALTER TABLE account ADD COLUMN subAccountId VARCHAR default ''");

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER)");

}

}

}

2.2 假設這個時候，還需要升級數據庫到版本3，在表subAccount 中新增個字段userName。

onCreate方法里修改就不說了創建表subAccount 加上userName字段就行。onUpgrade方法中怎么判斷版本號，按照上面的說明可知上限是小于3，下限則是大于等于表創建的版本，subAccount 表創建的版本是2所以需要大于等于2，而不是大于等于初始版本。

具體代碼如下：

/**

* 數據庫版本-升級用

* 版本2：新增數據庫subAccount

*/

private static final int DATABASE_VERSION = 3;

public DatabaseHelper(Context context) {

//CursorFactory設置為null,使用默認值

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

createAccountTable(db);

createSubAccountTable(db);

}

/**

* 創建subAccount表(最好封裝下，保證onCreate和onUpgrade方法中創建的都是最新表)

*/

private void createSubAccountTable(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER," +

"userName VARCHAR default '')");

}

private void createAccountTable(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER," +

"subAccountId VARCHAR default '')");

}

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

if (oldVersion >= 1 && oldVersion < 2) {

db.execSQL("ALTER TABLE account ADD COLUMN subAccountId VARCHAR default ''");

createSubAccountTable(db);

}

if (oldVersion >= 2 && oldVersion < 3) {

db.execSQL("ALTER TABLE subAccount ADD COLUMN userName VARCHAR default ''");

}

}

}

升級測試說明：

直接安裝版本3數據庫的APP——走onCreate方法創建最新表

安裝版本2--升級版本3APP——onUpgrade只會走升級subAccount 表的邏輯

安裝版本1--升級版本3APP——onUpgrade只會走升級account 表的邏輯和創建表subAccount 的邏輯，創建表subAccount 和onCreate中執行的是同義SQL，創建的都是最新表。

這種方式更新數據庫一定要注意表的創建版本，所以必要的注釋還是要詳細點。

3.第三種方式和第二種基本是一樣，只是在onUpgrade方法中一步步往上升級，已上面2.2例子說明，初始版本為1，升級到版本3，先升級到版本2再升級到版本3這樣就不需要判斷oldVersion 版本號的上下限了。

使用這種方式升級，onCreate中可以是最新表創建(3.1示例)，也可以只進行最初版本的表創建然后調用onUpgrade方法升級數據庫(3.2示例)

3.1 onCreate中最新的數據表，onUpgrade方法中根據版本號一步步往上升級

代碼如下：

/**

* 數據庫名稱

*/

private static final String DATABASE_NAME = "account.db";

/**

* 數據庫版本-升級用

*/

private static final int DATABASE_VERSION = 3;

public DatabaseHelper3(Context context) {

//CursorFactory設置為null,使用默認值

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

createAccountTable(db);

createSubAccountTable(db);

}

private void createSubAccountTable(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER," +

"userName VARCHAR default '')");

}

private void createAccountTable(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER," +

"subAccountId VARCHAR default '')");

}

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

int version = oldVersion;

if (version == 1){

db.execSQL("ALTER TABLE account ADD COLUMN subAccountId VARCHAR default ''");

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER)");

version = 2;

}

if (version == 2){

db.execSQL("ALTER TABLE subAccount ADD COLUMN userName VARCHAR default ''");

}

}

3.2 onCreate中創建最初版本的表然后調用onUpgrade方法傳入oldVersion為最初版本，onUpgrade方法中根據版本號一步步往上升級，需要判斷下版本號oldVersion>=newVersion時不做處理(即初始版本不處理)

代碼如下：

/**

* 數據庫名稱

*/

private static final String DATABASE_NAME = "account.db";

/**

* 最初版本

*/

private static final int FIRST_DATABASE_VERSION = 1;

/**

* 數據庫版本-升級用

*/

private static final int DATABASE_VERSION = 3;

public DatabaseHelper2(Context context) {

//CursorFactory設置為null,使用默認值

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

/**

* 數據庫第一次創建時調用

*/

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL("CREATE TABLE IF NOT EXISTS account " +

"(userId VERCHAR PRIMARY KEY,userName VERCHAR,totalAccount INTEGER)");

onUpgrade(db,FIRST_DATABASE_VERSION,DATABASE_VERSION);

}

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

if (oldVersion >= newVersion){

return;

}

int version = oldVersion;

if (version == 1){

db.execSQL("ALTER TABLE account ADD COLUMN subAccountId VARCHAR default ''");

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER)");

version = 2;

}

if (version == 2){

db.execSQL("ALTER TABLE subAccount ADD COLUMN userName VARCHAR default ''");

}

}

或者直接判斷小于也是可以的，思路和上面是完全一樣的，也是一步步往上升級，僅僅是寫法不一樣，隨變選一個寫法就行，示例代碼如下：

/**

* @param db 數據庫實際操作類

* @param oldVersion 舊版本

* @param newVersion 新版本

*/

@Override

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

if (oldVersion >= newVersion){

return;

}

if (oldVersion < 2){

db.execSQL("ALTER TABLE account ADD COLUMN subAccountId VARCHAR default ''");

db.execSQL("CREATE TABLE IF NOT EXISTS subAccount " +

"(userId VERCHAR PRIMARY KEY,subAccountId VERCHAR,totalAccount INTEGER)");

}

if (version < 3){

db.execSQL("ALTER TABLE subAccount ADD COLUMN userName VARCHAR default ''");

}

}

總結：

以上三種方式均可以實現數據庫版本的升級。

如果數據庫版本升級不需要保存舊表數據可以選擇方式1升級數據庫，刪除所有表重新創建。

如果數據庫版本升級需要保存數據庫表數據，則可以選擇方式二或者方式三。

個人比較建議選擇方式二，新安裝APP創建數據庫不會做很多多余的操作且邏輯也比較清晰。

當然大家可以根據各自的需求選擇，如果數據庫修改不是很頻繁而且修改較多的情況下，方式三也不失為一個好的選擇，代碼邏輯很清晰。

五.數據庫降級-onDowngrade方法

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

throw new SQLiteException("Can't downgrade database from version " +

oldVersion + " to " + newVersion);

}

降級方法，當數據庫降級時(當前數據庫版本小于已創建的數據庫版本)執行此方法。

onDowngrade方法是有默認實現的，我們可以看到默認實現就是拋出一個降級異常，所以如果我們不重寫此方法，APP 數據庫是沒法往下降級的，安裝的時候會直接崩潰。除非你卸載了重裝，這樣相當于首次創建數據庫，走onCreate方法。

我們可以根據實際需求來決定是否需要重寫onDowngrade方法，如果應用降級覆蓋安裝不涉及數據庫降級或者是不允許降級就不需要重寫此方法，強制用戶安裝最新的。如果有需要則可以重寫此方法，一般操作為刪除所有表再調用onCreate方法重寫創建表。SQLite數據庫表是不能刪減字段的，這樣做舊版本表可能有冗余字段，但這不影響舊版本操作。

舉個栗子：

@Override

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

dropTable(db,"account");

dropTable(db,"subAccount");

onCreate(db);

}

/**

* 刪除表

* @param db 數據庫

* @param tableName 表名

*/

public void dropTable(SQLiteDatabase db, String tableName) {

if (TextUtils.isEmpty(tableName)) {

return;

}

db.execSQL("drop table " + tableName);

}

總結

以上是生活随笔為你收集整理的android数据库降级_Android SQLite (二.数据库创建，升级及降级)的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。