android 数据库版本升级

你的名字 2022-08-27 01:27 280阅读 0赞

在android应用程序需要升级时，如果之前的数据库表结构发生了变化或者新添加了表，就需要对数据库进行升级，并保留原来的数据库数据。

程序如何知道数据库需要升级？

数据库实现方法中有必须继承两个方法：onCreate和onUpgrade，他们的调用过程如下：   
       1. 如果数据库文件不存在，SQLiteOpenHelper在自动创建数据库后只会调用onCreate方法，在该方法中一般需要创建数据库中的表、视图等组件。在创建之前，数据库是空的，因此，不需要先删除数据库中相关的组件。   
       2. 如果数据库文件存在，并且当前的版本号高于上次创建或升级时的版本号，SQLiteOpenHelper会调用onUpgrade方法，调用该方法后，会更新数据库版本号。在onUpgrade方法中除了创建表、视图等组件外，还需要首先删除这些相关的组件，因此，在调用onUpgrade方法之前，数据库是存在的，里面还有很多数据库组件。   
      3. 综合上述两点，可以得出一个结论。如果数据库文件不存在，只有onCreate方法被调用（该方法只会在创建数据库时被调用1次）。如果数据库文件存在，并且当前版本较高，会调用onUpgrade方法来升级数据库，并更新版本号。

SQLiteOpenHelper类的构造函数有一个参数是int version，它的意思就是指数据库版本号。比如在软件1.0版本中，我们使用SQLiteOpenHelper访问数据库时，该参数为1，那么数据库版本号1就会写在我们的数据库中。

到了1.1版本，我们的数据库需要发生变化，那么我们1.1版本的程序中就要使用一个大于1的整数来构造SQLiteOpenHelper类，用于访问新的数据库，比如2。

当我们的1.1新程序读取1.0版本的老数据库时，就发现老数据库里存储的数据库版本是1，而我们新程序访问它时填的版本号为2，系统就知道数据库需要升级。

何时触发数据库升级？如何升级？

当系统在构造SQLiteOpenHelper类的对象时，如果发现版本号不一样，就会自动调用onUpgrade函数，让你在这里对数据库进行升级。根据上述场景，在这个函数中把老版本数据库的相应表中增加字段，并给每条记录增加默认值即可。

新版本号和老版本号都会作为onUpgrade函数的参数传进来，便于开发者知道数据库应该从哪个版本升级到哪个版本。

升级完成后，数据库会自动存储最新的版本号为当前数据库版本号。

下面举例写出具体过程：

如果我上一个版本的数据库表结构没发生变化，但是新增了两张表，而且之前有一张表中默认有4条数据，现在新版本默认有11条数据，那么该怎么操作呢，假设表A发生了变化，并且新建了表B、C

1.首先我们需要把原来的数据库表重命名一下

public static final String TEMP_SQL_CREATE_TABLE_SUBSCRIBE = "alter table "
                + A + " rename to temp_A";

原来的表结构是：

private static final String SQL_CREATE_TABLE_SUBSCRIBE = "create table  if not exists "
                + A + "(id integer primary key autoincrement,code text not null,name text,username text)";

2.然后把备份表temp\_A中的数据copy到新创建的数据库表A中，这个表A没发生结构上的变化

public static final String INSERT_SUBSCRIBE = "select 'insert into A (code,name,username,tablename) 
    values ('''||code||''','''||name||''',''cnki'','''||tablename||'''')'  as insertSQL from temp_A";

3.此时临时表中的数据已经全部复制到了表A中，但是我之前的表A中有四条默认的数据，用户可能删了，可能又增加了新的数据，那我不管用户什么操作，我都把这4条删除掉，然后重新添加一次，这样就保证了之前的四条数据还在新的数据表中。

这是我之前的四条数据，我先找出来：

public static final String[] arrWhereAct = { "where code ='K174' and tablename = 'phonepaper'", "where code ='GMRB' and tablename = 'newspaper'", "where code ='XJSJ' and tablename = 'magazine'", "where code ='JTKL' and tablename = 'magazine'" };

4.删除备份表

public static final String DELETE_TEMP_SUBSCRIBE = "delete from temp_A "; public static final String DROP_TEMP_SUBSCRIBE = "drop table if exists temp_A";

5.然后把数据库版本号改为比之前高的版本号，在OnUpgrade方法中执行上述语句就行，具体如下：

[![复制代码][copycode.gif]][copycode.gif 1]

@Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { for (int j = oldVersion; j <= newVersion; j++) { switch (j) { case 2: 　　　　　　　　　　//创建临时表 db.execSQL(TEMP_SQL_CREATE_TABLE_SUBSCRIBE); 　　　　　　　　　　//执行OnCreate方法，这个方法中放的是表的初始化操作工作，比如创建新表之类的 onCreate(db); 　　　　　　　　　　//删除之前的表里面的那4条默认的数据 for (int i = 0; i < arrWhereAct.length; i++) { db.execSQL(DELETE_TEMP_SUBSCRIBE + arrWhereAct[i]); } //将临时表中的数据放入表A 　　　　　　　　　Cursor cursor = db.rawQuery(INSERT_SUBSCRIBE, null); if (cursor.moveToFirst()) { do { db.execSQL(cursor.getString(cursor .getColumnIndex("insertSQL"))); } while (cursor.moveToNext()); } cursor.close(); 　　　　　　　　　　//将临时表删除掉 db.execSQL(DROP_TEMP_SUBSCRIBE); break; default: break; } } }

[![复制代码][copycode.gif]][copycode.gif 1]

为什么要在方法里写for循环，主要是考虑到夸版本升级，比如有的用户一直不升级版本，数据库版本号一直是1，而客户端最新版本其实对应的数据库版本已经是4了，那么我中途可能对数据库做了很多修改，通过这个for循环，可以迭代升级，不会发生错误。

参考解决方案：

解决方案：   
我们在4月份数据库建立时，使用下面的方式

Java代码   [![收藏代码][icon_star.png]][icon_star.png 1]

1.  **public** **class** DatabaseHelper **extends** SQLiteOpenHelper \{  
2.    
3.      **private** **static** **final** String DB\_NAME = "mydata.db"; // 数据库名称  
4.      **private** **static** **final** **int** version = 1; // 数据库版本  
5.    
6.      **public** DatabaseHelper(Context context) \{  
7.          **super**(context, DB\_NAME, **null**, version);  
8.      \}  
9.    
10.     @Override  
11.     **public** **void** onCreate(SQLiteDatabase db) \{  
12.         String sql = "create table user(id integer primary key autoincrement , username varchar(20), password varchar(60));";  
13.         db.execSQL(sql);  
14.     \}  
15.   
16.     @Override  
17.     **public** **void** onUpgrade(SQLiteDatabase db, **int** oldVersion, **int** newVersion) \{  
18.           
19.     \}  
20. \}

于是到了五月份，由于业务需要，我们想添加新的字段到这个表里。我们这样写代码：

Java代码   [![收藏代码][icon_star.png]][icon_star.png 1]

1.  **public** **class** DatabaseHelper **extends** SQLiteOpenHelper \{  
2.    
3.      **private** **static** **final** String DB\_NAME = "mydata.db"; // 数据库名称  
4.      **private** **static** **final** **int** version = 2; // 数据库版本  
5.    
6.      **public** DatabaseHelper(Context context) \{  
7.          **super**(context, DB\_NAME, **null**, version);  
8.      \}  
9.    
10.     @Override  
11.     **public** **void** onCreate(SQLiteDatabase db) \{  
12.         String sql = "create table user(id integer primary key autoincrement , username varchar(20), password varchar(60));";  
13.         db.execSQL(sql);  
14.     \}  
15.   
16.     @Override  
17.     **public** **void** onUpgrade(SQLiteDatabase db, **int** oldVersion, **int** newVersion) \{  
18.         **if** (oldVersion == 1 && newVersion == 2) \{  
19.             // 从版本1到版本2时，增加了一个字段 desc  
20.             String sql = "alter table \[user\] add \[desc\] nvarchar(300)";  
21.             db.execSQL(sql);  
22.         \}  
23.     \}  
24. \}

如果数据库结构变化比较大，要做彻底的升级，怎么办？

Java代码   [![收藏代码][icon_star.png]][icon_star.png 1]

1.  **public** **class** DatabaseHelper **extends** SQLiteOpenHelper \{  
2.    
3.      **private** **static** **final** String DB\_NAME = "mydata.db"; // 数据库名称  
4.      **private** **static** **final** **int** version = 2; // 数据库版本  
5.    
6.      **public** DatabaseHelper(Context context) \{  
7.          **super**(context, DB\_NAME, **null**, version);  
8.      \}  
9.    
10.     @Override  
11.     **public** **void** onCreate(SQLiteDatabase db) \{  
12.         String sql = "create table user(id integer primary key autoincrement , username varchar(20), password varchar(60));";  
13.         db.execSQL(sql);  
14.     \}  
15.   
16.     @Override  
17.     **public** **void** onUpgrade(SQLiteDatabase db, **int** oldVersion, **int** newVersion) \{  
18.         //如果本次升级数据库完全变化很大，需要删除旧版本，建立新版本；  
19.         **if** (oldVersion == 1 && newVersion == 2) \{  
20.             db.execSQL("drop table user;");  
21.             //自动调用onCreate  
22.         \}  
23.     \}  
24. \}

具体实现就是这样，望高手吐槽！

[copycode.gif]: http://common.cnblogs.com/images/copycode.gif
[copycode.gif 1]: /images/20220824/88933c1d69ae4f348b7d37f9ff7c6f12.png
[icon_star.png]: http://gqdy365.iteye.com/images/icon_star.png
[icon_star.png 1]: /images/20220824/7b76a426ff3b443eab4bdb4fc10d90ac.png