android輕量級無侵入式管理數(shù)據(jù)庫自動升級組件
SpeSqliteManager4Android
改動日志
2023.2.14 完成SQLiteOpenHelper 2023.2.23 完成room 2023.2.25 完成架構重構 2023.2.26 新增架構設計圖說明
介紹
一個輕量級無侵入式管理android數(shù)據(jù)庫自動升級的管理類(支持SQLiteOpenHelper、room)
媽媽再也不用擔心寫一坨坨的migration或是手動sql去升級數(shù)據(jù)庫
核心設計思想
1.以靜制動:配置項代替代碼,保證代碼穩(wěn)定性
架構設計
關配置項json:
- 1.dbName:數(shù)據(jù)庫文件名稱,要保持穩(wěn)定,不能修改。
- 2.dbVersion:數(shù)據(jù)庫版本號,判斷本地數(shù)據(jù)庫文件是否升級就通過此key,升級時要保證新版本號大于當前的。
- 3.dbTables:想要創(chuàng)建的表名,每個表名下是具體的字段。
集成步驟
1.導入依賴庫
implementation 'com.google.code.gson:gson:2.8.9' implementation "androidx.room:room-runtime:2.0.0" annotationProcessor "androidx.room:room-compiler:2.0.0"
2.在assets目錄下新建dbupdate.json 注意:dbconfig的配置不要動,自己的表在后面新增
3.SQLiteOpenHelper的調用方法
//1.直接創(chuàng)建SQLiteOpenHelper SpeSqliteOpenHelperService.getInstance(this); //2.創(chuàng)建SQLiteOpenHelper且需要監(jiān)聽db SpeSqliteOpenHelperService.getInstance(this, new SpeSqliteBaseInterface() { @Override public <T> void onCreate(T db, RoomDatabase room) { } @Override public <T> void onOpen(T db, RoomDatabase room) { } @Override public <T> void onUpgrade(T db, int oldVersion, int newVersion, RoomDatabase room) { } });
4.Room的調用方法
//3.直接創(chuàng)建room SpeSqliteRoomService.getInstance(this,AppDatabase.class); //4.創(chuàng)建room,且需要監(jiān)聽db SpeSqliteRoomService.getInstance(this,AppDatabase.class,new SpeSqliteBaseInterface() { @Override public <T> void onCreate(T db, RoomDatabase room) { //TODO 刪除測試插入代碼 if(room != null){ ServerModel model = new ServerModel(); model.setId("1"); model.setHost("1"); model.setLang("1"); model.setName("1"); model.setVersion("1"); insert(room,model); } } @Override public <T> void onOpen(T db, RoomDatabase room) { } @Override public <T> void onUpgrade(T db, int oldVersion, int newVersion, RoomDatabase room) { } });
核心代碼
SpeSqliteUpdateManager 負責針對本地db的創(chuàng)建、新建表、表字段升級、刪除表,通過配置的方式去升級數(shù)據(jù)庫,減少代碼的改動,核心思想:以靜制動
/** * 數(shù)據(jù)庫第一次創(chuàng)建時的調用函數(shù) * @param db db */ public void create(SQLiteDatabase db){ SpeSqliteSettingModel currentDBModel = SpeSqliteUpdateManager.getInstance().currentAppDBSetting(); for(int i=0;i<currentDBModel.dbTables.size();i++){ SpeSqliteTableSettingModel table = currentDBModel.dbTables.get(i); String sql = " create table if not exists "+table.tableName+" ("; for(int j=0;j<table.columns.size();j++){ SpeSqliteColumnSettingModel column = table.columns.get(j); sql+=column.key+" "; sql+=column.keyType; if(j==table.columns.size()-1){ sql+=" "; }else { sql+=","; } } sql+=")"; executeSQL(db,sql); } //SQLiteDatabase數(shù)據(jù)庫才需要升級本地數(shù)據(jù)配置 if(db instanceof SQLiteDatabase){ SQLiteDatabase _db = (SQLiteDatabase)db; updateConfig2DB(_db,currentDBModel); } } /** * 升級數(shù)據(jù)庫,此處涉及3種改動:1.新建表 2.老表新增字段 3.刪除表 * 注意該方法會被兩個數(shù)據(jù)庫依次觸發(fā),所以需要控制 * 1.新建表的處理思路:比較簡單直接create即可 * 2.老表新增字段需要遍歷db中的json表字段明細和當前app中的json明細 * @param db db */ public void upgrade(SQLiteDatabase configdb,SupportSQLiteDatabase db){ SpeSqliteSettingModel newConfig = this.currentAppDBSetting(); SpeSqliteSettingModel localConfig = this.getAppLoclDBSetting(configdb); //該處判斷可以不要,但是加了后(daupdate.json的dbversion字段)效率更高 if(localConfig.dbVersion< newConfig.dbVersion){//通過dbversion直接判斷是否要升級 //防止room數(shù)據(jù)未創(chuàng)建表,就alter if(db != null){ for(int i=0;i<localConfig.dbTables.size();i++) { SpeSqliteTableSettingModel _local = localConfig.dbTables.get(i); createTableSQL(db,_local); } } for(int j=0;j<newConfig.dbTables.size();j++){ SpeSqliteTableSettingModel _new = newConfig.dbTables.get(j); for(int i=0;i<localConfig.dbTables.size();i++){ SpeSqliteTableSettingModel _local = localConfig.dbTables.get(i); if(_local.tableName.equals(_new.tableName)){//找到,再判斷字段是否有新增 _local.indexed = true;//被比較過,該表不用刪除 if(_local.columns.size()<_new.columns.size()){ //執(zhí)行alert去新增字段 // alterCoulmns(db != null?db:configdb,_local,_new); } break;//只要匹配到就直接跳出該層循環(huán) } } //本地數(shù)據(jù)沒找到這個表需要新增 createTableSQL(db != null?db:configdb,_new); } //針對被廢棄的表需要在本地庫中刪除 for(int i=0;i<localConfig.dbTables.size();i++){ SpeSqliteTableSettingModel table = localConfig.dbTables.get(i); if(!table.indexed){ dropTables(db != null?db:configdb,localConfig.dbTables.get(i)); } } //只有當是SQLiteDatabase升級時才能本地數(shù)據(jù)配置 if(db == null){ updateConfig2DB(configdb,newConfig); } } } /** * 移除老表 * @param db db * @param table table * @param <T> 范型(需考慮SQLiteOpenHelper和room) */ private <T> void dropTables(T db,SpeSqliteTableSettingModel table){ String sql = " DROP TABLE IF EXISTS "+table.tableName; executeSQL(db,sql); } /** * 老表新增字段 * @param db db * @param _old 老表字段配置 * @param _new 表新字段配置 * @param <T> 范型(需考慮SQLiteOpenHelper和room) */ private <T> void alterCoulmns(T db,SpeSqliteTableSettingModel _old,SpeSqliteTableSettingModel _new){ for(int i=0;i<_new.columns.size();i++){ if(i>=_old.columns.size()){ SpeSqliteColumnSettingModel column = _new.columns.get(i); String sql = " alter table "+_old.tableName+" add column "; sql+=column.key; sql+=" "; sql+= column.keyType; executeSQL(db,sql); } } } /** * 新增表 * @param db db * @param table 表配置 * @param <T> 范型(需考慮SQLiteOpenHelper和room) */ private <T> void createTableSQL(T db,SpeSqliteTableSettingModel table){ String sql = " create table if not exists "+table.tableName+" ("; for(int j=0;j<table.columns.size();j++){ SpeSqliteColumnSettingModel column = table.columns.get(j); sql+=column.key+" "; sql+=column.keyType; if(j==table.columns.size()-1){ sql+=")"; }else { sql+=","; } } executeSQL(db,sql); }
運行效果
以上就是android輕量級無侵入式管理數(shù)據(jù)庫自動升級組件的詳細內(nèi)容,更多關于android數(shù)據(jù)庫管理組件的資料請關注腳本之家其它相關文章!
相關文章
Android創(chuàng)建外部lib庫及自定義View的圖文教程
這篇文章主要給大家介紹了關于Android創(chuàng)建外部lib庫及自定義View的相關資料,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2018-11-11Android Kotlin開發(fā)實例(Hello World!)及語法詳解
這篇文章主要介紹了Android Kotlin開發(fā)實例及語法詳解的相關資料,需要的朋友可以參考下2017-05-05Android Studio finish()方法的使用與解決app點擊“返回”(直接退出)
這篇文章主要介紹了Android Studio finish()方法的使用與解決app點擊“返回”(直接退出),本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-04-04Android如何自定義EditText光標與下劃線顏色詳解
在android開發(fā)中 EditTextText是我們經(jīng)常用到的,我們使用時會有一些小問題,下面這篇文章主要給大家介紹了關于利用Android如何自定義EditText光標與下劃線顏色的相關資料,需要的朋友可以參考借鑒,下面來一起看看吧。2017-08-08Android開發(fā)必知 九種對話框的實現(xiàn)方法
App中少不了與用戶交互的各種dialog,以此達到很好的用戶體驗,下面給大家介紹Android開發(fā)必知 九種對話框的實現(xiàn)方法,有需要的朋友可以參考下2015-08-08