SQLiteOpenHelper
1 // 如果数据库文件不存在,只有onCreate()被调用(该方法在创建数据库时被调用一次) 2 public abstract void onCreate(SQLiteDatabase db); 3 // 如果数据库文件存在,会调用onUpgrade()方法升级数据库,并更新版本号。 4 public abstract void onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion);
OnCreate : 如果数据库文件不存在,SQLiteOpenHelper在创建数据库文件,打开数据库这个数据库后,调用onCreate()方法,在该方法中一般需要创建表、视图等组件。在创建前数据库一般是空的,因此不需要先删除数据库中相关的组件。
OnUpgrade : 当系统在构造SQLiteOpenHelper类的对象时,如果发现版本号不一样,就会自动调用onUpgrade函数,让你在这里对数据库进行升级。
新版本号和老版本号都会作为onUpgrade函数的参数传进来,便于开发者知道数据库应该从哪个版本升级到哪个版本。
升级完成后,数据库会自动存储最新的版本号为当前数据库版本号。
需要对SQLite数据库的结构进行升级:
SQLite提供了ALTER TABLE命令,允许用户重命名或添加新的字段到已有表中,但是不能从表中删除字段。
并且只能在表的末尾添加字段,比如,为 Student添加两个字段:
1 ALTER TABLE Student ADD COLUMN UserPhone VARCHAR;
2 ALTER TABLE Student ADD COLUMN UserNickName VARCHAR;
如果遇到复杂的修改操作,比如在修改的同时,需要进行数据的转移,那么可以采取在一个事务中执行如下语句来实现修改表的需求。
1. 将表名改为临时表
ALTER TABLE Student RENAME TO __temp__Student;
2. 创建新表
CREATE TABLE Student (UserId VARCHAR(32) PRIMARY KEY ,UserName VARCHAR(32) NOT NULL ,UserAddress VARCHAR(16) NOT NULL);
3. 导入数据
INSERT INTO Student SELECT UserId, “”, UserAddress FROM __temp__Student;
或者
INSERT INTO Student() SELECT UserId, “”, UserAddress FROM __temp__Student;
* 注意 双引号”” 是用来补充原来不存在的数据的
4. 删除临时表
DROP TABLE __temp__Student;
通过以上四个步骤,就可以完成旧数据库结构向新数据库结构的迁移,并且其中还可以保证数据不会应为升级而流失。
当然,如果遇到减少字段的情况,也可以通过创建临时表的方式来实现。
获取表中字段:
1 // 获取升级前表中的字段 2 protected String getColumnNames(SQLiteDatabase db, String tableName) 3 { 4 StringBuffer columnNameBuffer = null; 5 Cursor c = null; 6 try 7 { 8 c = db.rawQuery( "PRAGMA table_info(" + tableName + ")", null); 9 if (null != c) { 11 int columnIndex = c.getColumnIndex("name"); 12 if (-1 == columnIndex) { 14 return null; 15 } 16 17 int index = 0; 18 columnNameBuffer = new StringBuffer(c.getCount()); 19 for ( c.moveToFirst(); !c.isAfterLast(); c.moveToNext()) { 21 columnNameBuffer.append(c.getString( columnIndex )); 22 columnNameBuffer.append(","); 23 index++; 24 } 25 } 26 } 27 catch (Exception e) { 29 e.printStackTrace(); 30 } 31 finally { 33 if (c != null) { 35 c.close(); 36 } 37 } 38 return columnNameBuffer.toString();40 }
加上事物控制:
1 // update table 2 private void updateTable(SQLiteDatabase db, String tableName, String columns) 3 { 4 try 5 { 6 db.beginTransaction(); 7 String oldColumns = columns.substring(0, columns.length() - 1); 8 // rename the table 9 String tempTable = tableName + "texp_temptable"; 10 String renameTableSql = "alter table " + tableName + " rename to " + tempTable; 11 db.execSQL(renameTableSql); 12 14 // drop the oldtable 15 String dropTableSql = "drop table if exists " + tableName; 16 db.execSQL(dropTableSql); 17 // creat table 18 String createTableSql = "create table if not exists " + tableName + "(name text, pwd text, tel text)"; 19 db.execSQL(createTableSql); 20 // load data 21 String newColume = "tel"; 22 String newColumns = oldColumns + "," + newColumn; 23 String insertSql = "insert into " + tableName + " (" + newColumns + ") " + "select " + oldColumns + "" + " " + " from " + tempTable; 25 db.execSql(insertSql); 26 db.setTransactionSuccessful(); 27 } 28 catch (Exception e) 29 { 30 // TODO: handle exception 31 Log.i( "tag", e.getMessage() ); 32 } 33 finally 34 { 35 db.endTransaction(); 36 } 39 }
//DBHelper:
1 public class DBHelper extends SQLiteOpenHelper { 2 3 private static final String DATABASE_NAME = "student.db"; 4 private static final int DATABASE_VERSION = 1002; 5 6 private static DBHelper instance = null; 7 8 9 public DBHelper(Context context) { 10 super(context, DATABASE_NAME, null, DATABASE_VERSION); 11 } 12 13 public synchronized static DBHelper getInstance(Context context) { 14 if (instance == null) { 15 instance = new DBHelper(context); 16 } 17 return instance; 18 } 19 20 @Override 21 public void onCreate(SQLiteDatabase db) { 22 db.execSQL(SQL.CREATE_TABLE_FAVORITE); 23 24 // 若不是第一个版本安装,直接执行数据库升级 25 // 请不要修改FIRST_DATABASE_VERSION的值,其为第一个数据库版本大小 26 final int FIRST_DATABASE_VERSION = 1000; 27 onUpgrade(db, FIRST_DATABASE_VERSION, DATABASE_VERSION); 28 } 29 30 @Override 31 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 32 // 使用for实现跨版本升级数据库 33 for (int i = oldVersion; i < newVersion; i++) { 34 switch (i) { 35 case 1000: 36 upgradeToVersion1001(db); 37 break; 38 case 1001: 39 upgradeToVersion1002(db); 40 break; 41 42 default: 43 break; 44 } 45 } 46 } 47 48 private void upgradeToVersion1001(SQLiteDatabase db){ 49 // student 表新增1个字段 50 String sql1 = "ALTER TABLE Student ADD COLUMN age VARCHAR"; 51 db.execSQL(sql1); 52 }
53 private void upgradeToVersion1002(SQLiteDatabase db){ 54 // student 表新增2个字段, 添加新字段只能一个字段一个字段加,sqlite有限制不予许一条语句加多个字段 55 String sql1 = "ALTER TABLE Student ADD COLUMN tel VARCHAR"; 56 String sql2 = "ALTER TABLE Student ADD COLUMN address VARCHAR"; 57 db.execSQL(sql1); 58 db.execSQL(sql2); 59 } 60 }