關於Android數據庫升級的實踐(以ormlite爲例)

在我們的安卓開發中，難免會使用到本地存儲，而android本地數據庫就是一樣比較好，能更靈活存儲和查詢本地數據，但是隨着需求的不斷變化，難免要對本地數據庫的表或者表的某個字段進行操作，而又不想破壞已經存儲在安卓手機裏的舊數據，那麼怎麼辦呢？呵呵，安卓數據庫已經幫我們想到了，就是本地數據庫升級，當然也可以數據庫降級，類似吧。

Android 本地數據庫又叫SQLite,它有自己的一些原則：

1. 我們只能重命名據據庫中的表名和向舊錶中增加新的字段

2. Android版SQLite不支持修改表中的字段名和刪除表中的字段，也不允許改變表中字段的約束條件(但是修改也可以通過增加來實現，我這裏叫它打引號的’修改’)

3. Android版SQLite在存儲字段數據時不分類型，所以可以改變字段的類型而無需要升級

(參考地址:http://ormlite.com/javadoc/ormlite-core/doc-files/ormlite_4.html#Upgrading-Schema)

下面就讓我使用例子來實踐數據庫的中字段的增加和’修改’字段吧

首先就去下載數據庫工具的jar包，我找了一個地址：http://www.java2s.com/Code/Jar/o/Downloadormliteandroid418javadocjar.htm

當然也可以去看看他的源碼：https://github.com/j256

看看我們的DatabaseHelper.java

public class DatabaseHelper extends OrmLiteSqliteOpenHelper {
    private static final String TABLE_NAME = "upgrade_example.db";
    public final static int version = 3; // 數據庫版本
    private Map<String, Dao> daos = new HashMap<String, Dao>();
    /**
     * userDao ，每張表對於一個
     */
    private Dao<UserInfo, Integer> userDao;

    private DatabaseHelper(Context context){
        super(context, TABLE_NAME, null, version);
    }

    @Override
    public void onCreate(SQLiteDatabase database,
                         ConnectionSource connectionSource) {
    	Log.e(DatabaseHelper.class.getName(), "DatabaseHelper onCreate() is invoked..."); 
        try {
            TableUtils.createTable(connectionSource, UserInfo.class);
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }

    @Override
    public void onUpgrade(SQLiteDatabase database,ConnectionSource connectionSource, int oldVersion, int newVersion) {
    	Log.e(DatabaseHelper.class.getName(), "DatabaseHelper onUpgrade() oldVersion:"+oldVersion+",newVersion:"+newVersion);
    	if(oldVersion<2){
    		try {
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN age INTEGER DEFAULT 0;");
			} catch (SQLException e) {
				e.printStackTrace();
			}
    	}
    	
    	if(oldVersion<3){
    		try {
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN addr TEXT DEFAULT 'china';");
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN sex TEXT DEFAULT '男';");
    			getUserDao().updateRaw("UPDATE `tb_user_info` SET sex = '女' WHERE gender = 1;");
			} catch (SQLException e) {
				e.printStackTrace();
			}
    	}
    }

    private static DatabaseHelper instance;

    /**
     * 單例獲取該Helper
     *
     * @param context
     * @return
     */
    public static synchronized DatabaseHelper getHelper(Context context) {
        if (instance == null) {
            synchronized (DatabaseHelper.class) {
                if (instance == null)
                    instance = new DatabaseHelper(context);
            }
        }

        return instance;
    }

    public synchronized Dao getDao(Class clazz) throws SQLException {
        Dao dao = null;
        String className = clazz.getSimpleName();
        if (daos.containsKey(className)) {
            dao = daos.get(className);
        }
        if (dao == null) {
            dao = super.getDao(clazz);
            daos.put(className, dao);
        }
        return dao;
    }

    /**
     * 獲得userDao
     *
     * @return
     * @throws SQLException
     */
    public Dao<UserInfo, Integer> getUserDao() throws SQLException{
        if (userDao == null){
            userDao = getDao(UserInfo.class);
        }
        return userDao;
    }

    /**
     * 釋放資源
     */
    @Override
    public void close(){
        super.close();
        userDao = null;
    }

}

以用戶爲例的UserInfo.java

@DatabaseTable(tableName = "tb_user_info")
public class UserInfo {
	@DatabaseField
	private int id;//id
	@DatabaseField
	private String name;//名稱
	@DatabaseField
	private int gender;//性別 0:男,1:女
	
	
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public int getGender() {
		return gender;
	}
	public void setGender(int gender) {
		this.gender = gender;
	}
	
	
	/*@Override
    public String toString() {//database version=1
        return "UserInfo [id=" + id + ", name=" + name + ",gender="+gender
                + "]";
    }*/
	
	
	// database version=2 added
	@DatabaseField
	private int age;//age
    public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	/*@Override
    public String toString() {//database version=2
        return "UserInfo [id=" + id + ", name=" + name+ ", age=" + age + ",gender="+gender
                + "]";
    }*/
	
	
	
	//database version=3 added
	@DatabaseField
	private String sex;//修改字段
	@DatabaseField
	private String addr;//增加字段
	
    public String getSex() {
		return sex;
	}
	public void setSex(String sex) {
		this.sex = sex;
	}
	public String getAddr() {
		return addr;
	}
	public void setAddr(String addr) {
		this.addr = addr;
	}
	@Override
    public String toString() {
        return "UserInfo [id=" + id + ", name=" + name + ", age=" + age+",sex="+sex+",addr="+addr
                + "]";
    }
}

這兩個主要文件貼出來了，那麼我再把主界面的初始化的代碼貼一下：

private void initDatabaseDefaultVal(){
		SharedPreferences prefs=PreferenceManager.getDefaultSharedPreferences(this);
		boolean isHadInitDatabase=prefs.getBoolean("isHadInitDatabase", false);
		if(!isHadInitDatabase){
			ArrayList<UserInfo> userList=new ArrayList<UserInfo>();
			UserInfo user=new UserInfo();
			user.setId(1);
			user.setName("李明");
			user.setGender(0);
			userList.add(user);
			
			user=new UserInfo();
			user.setId(2);
			user.setName("張婷");
			user.setGender(1);
			userList.add(user);
			
			user=new UserInfo();
			user.setId(3);
			user.setName("王強");
			user.setGender(0);
			userList.add(user);
			try {
				DatabaseHelper.getHelper(this).getUserDao().create(userList);
				
				Editor editor=prefs.edit();
				editor.putBoolean("isHadInitDatabase", true);
				editor.commit();
			} catch (SQLException e) {
				e.printStackTrace();
				Log.e(this.getClass().getName(), "init database occupt SQLException!");
			}
			
		}
	}

好了，我就講講我的升級過程(如下圖)：

一開始我在tb_user_info這張表中，只有id,name,gender這三個字段，這時的數據庫版本爲1

打印出來的日誌如下圖

現在升級爲版本2，在UserInfo裏面增加age(隨便把toString()也變一下)，把DatabaseHelper的version設置爲2，在DatabaseHelper增加onUpgrade函數，寫上如下代碼：

if(oldVersion<2){
    		try {
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN age INTEGER DEFAULT 0;");
			} catch (SQLException e) {
				e.printStackTrace();
			}
    	}

運行結果如下圖:

現在升級爲版本3，在UserInfo裏面增加addr和sex(隨便把toString()也變一下)，把DatabaseHelper的version設置爲3，在DatabaseHelper的onUpgrade函數增加上如下代碼：

if(oldVersion<3){
    		try {
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN addr TEXT DEFAULT 'china';");
    			getUserDao().executeRaw("ALTER TABLE `tb_user_info` ADD COLUMN sex TEXT DEFAULT '男';");
    			getUserDao().updateRaw("UPDATE `tb_user_info` SET sex = '女' WHERE gender = 1;");
			} catch (SQLException e) {
				e.printStackTrace();
			}
    	}

運行結果如下圖:

當然也可以從版本1直接長到版本3，效果如下圖：

好了，實踐已經結束，我會把源代碼上傳上來，地址：http://download.csdn.net/detail/bright789/9447167

關於Android數據庫升級的實踐(以ormlite爲例)

Android 三種跨界面的通訊方式

找到與出問題android手機系統版本一樣的源碼

android studio在編輯時出現如Failed to sync Gradle project類似的問題時的解決方案

Android studio 如何查看正斷點函數被那個函數調用

數據類與JSON的互相轉換

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結